お知らせ機能（System Notification）

概要

運営（システム管理者）が、メンテナンス告知・機能追加・重要なご連絡などを 全ユーザーに一斉に届けるための機能。特定の組織やユーザーに絞った配信は行わない。

• 発信：システム管理画面（system-manager）でお知らせを作成・編集・削除する。
• 公開制御：公開開始日・公開終了日でお知らせの表示期間を制御する。
• 受信：ユーザー画面（user）・組織管理画面（organization-manager）で公開中のお知らせを閲覧する。
• 既読管理：お知らせ詳細を開くと自動的に既読となり、未読のみを絞り込んで提示できる。

登場アクターと役割

データモデル

公開・既読のルール

関連用語：公開 / 既読 / 未読

• 公開中：deletedAt is null かつ publishedAt <= now かつ （expiredAt is null または expiredAt > now）。
• 未公開：publishedAt が未設定または未来。受信側には表示されない。
• 期限切れ：expiredAt を過ぎたもの。受信側には表示されない。
• 既読化：受信側でお知らせ詳細を開いた時点で自動的に既読レコードを作成（冪等）。
• 未読：公開中で、かつそのユーザーの既読レコードが存在しないお知らせ。

受信側の表示箇所

主要な実装（参照）

• 一覧取得（受信）：apps/user/actions/system-notification/list-system-notification.ts — { isRead?: boolean } で未読/既読を絞り込み可能
• 既読化：apps/user/actions/system-notification-read/create-system-notification-read.ts
• 自動既読：.../system-notifications/[systemNotificationId]/_components/published/_components/mark-as-read/index.tsx
• 発信CRUD：apps/system-manager/actions/system-notification/*

開発セッション履歴