機能追加・改修 #1015
未完了[KH-45] 回覧通知とSLA期限通知を実装する
0%
説明
目的:
- 回覧が自分の承認待ちになったことと、未処理回覧の期限を対象者へ伝え、回覧の滞留を防ぐ。
確定した要件（2026-10-19 石井確認）:
1. 引継書の承認回覧が自分に到着したとき、承認対象者へ通知する。
2. 引継書ルールで定義する業務SLAに従い、未処理の回覧について期限前と期限超過時に通知する。
3. 通知はマイページとメールの両方で扱う。
未確定事項:
- 期限の何日前に通知するか
- 通知先の追加・同報の条件
- 期限超過後の通知間隔とエスカレーション
完了条件:
- 承認待ちへの遷移で、対象の承認者に通知が作成される。
- SLAの期限前・期限超過を日次判定し、未処理回覧の対象者に通知が作成される。
- マイページとメールで通知を確認できる。
- 期限前の通知日数など未確定の項目は、実装前に業務ルールとして確定する。
対応状況（2026-10-20）:
- 決裁待ち通知を実装した（基本設計書 7.1）。承認の段階に回覧が到着したとき（回覧開始時の最初の段階、前の段階の承認後の次の段階）に、その段階の承認者全員へアプリ内通知を作り、メールをキューで送る。マイページに「お知らせ」、案件ボードの「マイページ」に未読件数を表示する。
- 試験：`ApprovalNotificationTest`（3件）、画面試験「通知」3項目。合格。
- メールの送信設定：VPSの `.env` は `MAIL_MAILER=log`（ログに出力するだけで届かない）。実際に送るには、SMTPと送信元アドレスの設定が必要。
- 未実装：期限前・期限超過の通知（未確定事項3点が決まってから）。
出典: kaiho-hikitsugisyo-work docs/issue-backlog.md（コミット 7f4a0af）
石井 伸一 さんが9日前に更新
2026-10-20 送信元アドレスを決定（石井依頼によりみちいろが決定、コミット 5454c70）：hikitsugi@kaiho-k.jp（表示名「開邦工業 引継書システム」）。返信先も同じアドレス、SMTP認証もこのメールボックス。用意するのはこの1つ。用意時に kaiho-k.jp の MX・SPF・DKIM をさくらインターネットの案内どおり設定する。deploy/env の MAIL_FROM_ADDRESS・MAIL_USERNAME を設定済み（MAIL_MAILER はメールボックス用意まで log）。未定：届いた返信・不達通知を確認する人。
石井 伸一 さんが9日前に更新
2026-10-20 石井決定：hikitsugi@kaiho-k.jp に届いた返信・不達通知は管理者が確認する。要件定義書3.4・基本設計書2.4・課題一覧を更新。
石井 伸一 さんが9日前に更新
2026-10-20 たたき台を実装（コミット a1d2742、石井指示「一旦これをたたき台として組み込んでみる」）。17種類の通知をすべて組み込み、管理者の「通知の設定」画面（/notification-settings）で通知する・しない、メール、日数、追加の通知先（社員・共有メールアドレス）を変えられる。不明な点は仮の決め方（回覧期限は現在の版を作った日から、実施原価の報告は最初の保存時、など。docs/通知対象一覧_20261020.md）。毎日の処理は日本時間8:00。仮の環境へ反映するときは deploy/SETUP.md Step 7-2 のタイマーを入れる必要あり。試験：バックエンド62件・画面18項目合格（ローカル）。VPS未反映。