Announcements

One place to tell the right people — targeted by role and factory, read receipts included.

announcements

Title	Audience	Window	Pinned	Acks	By	Status
			📌 —

Project Gaia — static mockup in Filament v3 idiom. No backend. Seed rows are illustrative; ack counts are for demonstration only.

Announcements

New announcement

Not saved

Title

Body

plain text — rendered escaped, never HTML; write it in any language your team reads — BM, 中文, မြန်မာ

Audience — roles

Leave empty = all roles (audience_roles null) — matched against the viewer's role at publish and dashboard render time.

Audience — factories

Leave empty = all factories (audience_factories null) — role ∩ factory decides the final match.

Pinned

Require ack

Pinned sorts first on every dashboard banner; Require ack swaps the dashboard's dismiss for an explicit Acknowledge button (ack_required).

Starts

Ends (optional)

Leave blank for an ongoing / no-end-date notice.

Announcements — field manifest

Field	Filament component	Type	Source	FK target
announcements
Title	TextInput / TextColumn	string	stored: announcements.title	—
Body	Textarea / TextColumn (escaped)	text	stored: announcements.body — user content, ALWAYS rendered escaped, never interpreted as HTML	—
Audience — roles	CheckboxList (chips) / TextColumn badges	json null	stored: announcements.audience_roles — null = all roles	roles.id (each ticked)
Audience — factories	CheckboxList (chips) / TextColumn badges	json null	stored: announcements.audience_factories — null = all entities	factories.id (each ticked)
Pinned	Toggle / IconColumn::boolean()	bool	stored: announcements.pinned — pinned rows sort first on every dashboard banner	—
Ack required	Toggle / IconColumn::boolean()	bool	stored: announcements.ack_required — true swaps the dashboard's dismiss for an explicit Acknowledge action	—
Publish window	DatePicker (Starts/Ends) / TextColumn	datetime null	stored: announcements.starts_at / announcements.ends_at — null ends_at = no expiry	—
Status	TextColumn badge (derived)	enum Active/Scheduled/Expired	derived: now() vs starts_at/ends_at — not a stored column	—
Acks	TextColumn (derived "x/y read")	computed	derived: count(announcement_reads WHERE announcement_id) ÷ matched-audience user count	announcement_reads.announcement_id
By	TextColumn (relation)	relation	stored: announcements.created_by	users.id
announcement_reads
Announcement	BelongsTo	relation	stored: announcement_reads.announcement_id	announcements.id
User	BelongsTo	relation	stored: announcement_reads.user_id	users.id
Read at	TextColumn::since()	datetime	stored: announcement_reads.read_at — written when a user dismisses the dashboard banner, or taps Acknowledge for an ack_required post	—

Engine / architecture notes

Authoring is Owner/Admin only. AnnouncementPolicy::create()/update() gate this Resource; every other role only ever reads announcements matching their own audience (server-side filter, not client).
Publish fans out ONE bell notification per matched user — role ∩ factory, per D36's NotificationRouter — not one row per announcement.
Display doctrine: a dismissible banner surfaces on every dashboard for announcements active for the viewer's role+factories, pinned first; the full history also lives in Notifications with an announce category.
Reads/acks: dismissing the banner (or tapping the explicit Acknowledge button when ack_required=true) writes one announcement_reads row (announcement_id, user_id, read_at) — the Acks column is that count over the matched-audience size, e.g. 12/18 read.
Body is always rendered escaped (Blade {{ }} / Filament's default column escaping) — user-authored free text is never interpreted as HTML, matching the never-render-as-HTML rule in SECURITY §3.
Locale note: the chrome around this form is translated (D47 — en/ms/zh/my), but the title/body itself is written by the author in whatever language their audience reads — see the multilingual PPE example on the operator dashboard.