横断新機能ロードマップ

更新日: 2026-08-15 ステータス: 実行中

0. 実行ルール

• 下記タスクを 1 -> 20 の順で進行する。
• 各タスクは MVP -> 運用改善 の2段階で完了扱いとする。
• API は先に土台を実装し、各クライアント(Management / Kiosk / Staff PWA / Guardian PWA)を追従する。

1. 優先実行タスク (順序固定)

1. 欠席遅刻リアルタイム連携
2. 送迎チェックイン二重確認
3. オフライン緊急モード強化
4. 共有カレンダー承認フロー
5. 保護者既読未読追跡
6. 児童一日タイムライン
7. 自動請求下書き差分レビュー
8. ヒヤリハット即時報告
9. 来所ピーク予測表示
10. 保護者連絡テンプレート
11. 送迎ルート最適化
12. 児童コンディション入力
13. 多言語表示切替
14. 監査ログ証跡エクスポート
15. KPIホームダッシュボード

2. API 改善タスク (新機能横断の土台)

16. API統一レスポンス形式導入
17. API idempotency再送安全化
18. APIイベント配信基盤追加
19. API監査相関ID強化
20. APIレート制御役割別調整

3. API改善の具体内容

16. API統一レスポンス形式導入

• 目的: クライアント実装の分岐を減らし、エラーハンドリングを統一する。
• 仕様:
  • 成功: { success: true, data, requestId, ts }
  • 失敗: { success: false, error: { code, message, detail? }, requestId, ts }
• 対象: app/api/src/routes/* 全体。

17. API idempotency再送安全化

• 目的: オフライン再送時の二重登録を防ぐ。
• 仕様:
  • 書き込み系エンドポイントに Idempotency-Key ヘッダ対応を追加。
  • 同一キーは一定期間キャッシュし、同一レスポンスを返却。
• 優先対象: attendance/manual, daily-reports, calendar/events, notices。

18. APIイベント配信基盤追加

• 目的: リアルタイム連携タスク(1,2,4,5)をAPI主導で配信する。
• 仕様:
  • SSE または WebSocket を導入。
  • イベント例: absence.updated, pickup.status.changed, notice.published。
• 備考: まずは SSE で MVP を構築し、必要に応じてWSへ拡張。

19. API監査相関ID強化

• 目的: 監査と障害調査の追跡性を向上する。
• 仕様:
  • 全レスポンスに X-Request-Id を必須付与。
  • 重要操作の監査ログに requestId, actor, resource, before/after を保存。

20. APIレート制御役割別調整

• 目的: 認証済み端末の実運用を阻害せずに攻撃耐性を上げる。
• 仕様:
  • 現在の一律制限に加え、role/app_type別制限を追加。
  • login は厳格、heartbeat は緩和、update はトークン必須で制限。

4. 直近スプリント (Task 1: 欠席遅刻リアルタイム連携)

• API
  • 欠席/遅刻更新時にイベント発火。
  • 一覧取得APIに updated_since を追加し差分同期可能にする。
• Management
  • 当日ボードに「新着欠席・遅刻」パネルを追加。
• Kiosk
  • 対象児童が欠席の場合、受付時に注意表示。
• Staff PWA
  • プッシュ通知またはポーリングで新着表示。
• Guardian PWA
  • 送信結果ステータス(配信済み/未配信)を表示。

5. 進捗管理

• 進捗は本書更新 + 実装PRで管理する。
• 完了条件:
  • API実装、クライアントUI実装、受け入れテスト、運用手順更新。

6. 実装ログ (2026-04-10)

• 完了: 16. API統一レスポンス形式導入 (互換モード)
• 完了: 17. API idempotency再送安全化
• 完了: 18. APIイベント配信基盤追加 (SSE /v1/facility/events/stream; 旧 /v1/events/stream は互換ルート)
• 完了: 19. API監査相関ID強化
• 完了: 20. APIレート制御役割別調整
• 着手: 1. 欠席遅刻リアルタイム連携 (Staff 側SSE購読の初期実装)
• 完了: 3. オフライン緊急モード強化 (Kiosk 緊急キューの自動再送・状態表示を追加)
• 完了: 4. 共有カレンダー承認フロー (pending/承認/却下と管理画面承認操作を追加)
• 完了: 5. 保護者既読未読追跡 (保護者の既読保存APIと管理画面の既読率表示を追加)
• 完了: 6. 児童一日タイムライン (児童別の当日イベント時系列APIと管理/スタッフ表示を追加)
• 完了: 7. 自動請求下書き差分レビュー (現行請求と自動下書きの差分集計APIと管理画面レビュー一覧を追加)
• 完了: 8. ヒヤリハット即時報告 (即時報告APIとスタッフ投稿フォーム、管理ダッシュボード警戒表示を追加)
• 完了: 9. 来所ピーク予測表示 (過去同曜日の入室実績からピーク帯を推定するAPIと管理ダッシュボード表示を追加)
• 完了: 10. 保護者連絡テンプレート (管理のお知らせ作成画面に定型文テンプレートの挿入・保存機能を追加)
• 完了: 11. 送迎ルート最適化 (下校予定・送迎履歴から推奨ルートを算出するAPIと管理画面の提案表示を追加)
• 完了: 12. 児童コンディション入力 (児童詳細画面から日次コンディションを記録するAPIと入力UIを追加)
• 完了: 13. 多言語表示切替 (管理ポータルの表示言語を保存・反映する基盤と主要画面の翻訳切替を追加)
• 完了: 14. 監査ログ証跡エクスポート (監査ログの証跡CSV出力と権限付き出力モードを追加)
• 完了: 15. KPIホームダッシュボード (出席・請求・通知・同期の主要指標を管理ホームへ集約して表示)

7. 追加確定バックログ (2026-04-10 合意)

以下は「今後の実装確定」項目として扱い、次期計画の優先バックログに固定する。

1. 退室忘れ自動クローズ
2. 出退勤異常アラート
3. 月次締め前チェックリスト自動生成
4. 監査ログの業務ビュー化
5. オフライン同期の差分可視化
6. 書類期限アラート
7. 施設別運用スコア

2. 保護者連絡の兄弟一括送信仕様 (UI確定)

• 対象画面: 連絡画面 (Management)
• 仕様:
  • 「兄弟分」チェックボックスを表示する。
  • チェックボックスは複数選択を許可する。
  • 選択した兄弟分の宛先へ同一連絡を一括送信する。
• 実装メモ:
  • 送信前プレビューに「選択件数」と「対象児童名一覧」を表示する。
  • 送信監査ログに sibling_bulk_send=true と対象 child_id 一覧を残す。