最終更新: 2026-05-10

家族向け記録通知（閲覧パターン最適化・遅延ディスパッチ）

2026-05-10

職員が記録保存後に「家族へ通知」を選んだとき、即時に連絡帳へ送らず、家族ユーザーの過去30日の閲覧時間帯から算出した「届きやすい時間」に family_notification_logs へスケジュールし、Vercel Cron が到来時に contact_messages へ挿入する流れです。外部AI（Gemini）は使用しません（閲覧ログの集計とルールのみ）。

---

仕様の正（ソース）

最適時刻の計算: api/lib/optimalNotification.js（閲覧履歴の時間帯スコア、データ不足時は即時相当にフォールバック）
職員操作からのキュー投入: POST /api/notify-family（api/notify-family.js）… family_notification_logs INSERT、team_messages 職員用通知
閲覧ログ取得のみ（スケジュール再計算用）: POST /api/optimal-notification（api/optimal-notification.js）
Cron ディスパッチ: GET /api/family-notification-dispatch（api/family-notification-dispatch.js）… scheduled_for <= now かつ未送信行を処理し contact_messages へ反映後 notified_at を更新
記録保存フック: api/save-staff-action.js から notify-family を呼ぶ経路（家族通知オプションが有効なとき）
家族画面: src/js/pages/family.js・src/js/data/store.js（閲覧ログ送信・通知ログ参照など）

---

データベース

マイグレーション（本番適用の正）: supabase/migrations/20260510120000_family_notification_optimization.sql
手元の全文参照・SQL Editor 用コピー: docs/sql/family_notification_optimization.sql（マイグレと同趣旨の説明付き）

主なオブジェクト:

テーブル family_notification_logs（scheduled_for, notified_at, tenant_id, record_id 等）
RLS: 職員はテナント内の行を参照、家族は自分に関係する行のみ参照（詳細はマイグレ SQL）

---

環境変数（Vercel / `vercel dev`）

SUPABASE_URL または VITE_SUPABASE_URL
SUPABASE_SERVICE_ROLE_KEY … notify-family の service 経路 INSERT、family-notification-dispatch の一括処理に使用
VITE_SUPABASE_ANON_KEY … notify-family が職員 JWT と併用するクライアント用キー
CRON_SECRET（推奨）… family-notification-dispatch も Authorization: Bearer <CRON_SECRET> が一致しないと 401（未設定時はスキップのため本番では推奨）

---

Vercel Cron（`vercel.json`）

| パス | スケジュール（UTC） | 備考 |

|------|---------------------|------|

| /api/family-notification-dispatch | 30 21 * * * | 1日1回（Hobby プランでは「1日複数回」の Cron が拒否されるため。高頻度が必要なら Pro プランまたは外部スケジューラを検討） |

Cron から呼ぶときは Vercel 側で CRON_SECRET が設定されていれば、リクエストに同じ Bearer が付与される想定です。

---

スモーク手順（開発・本番）

1. マイグレ適用済みであること（family_notification_logs が存在）

2. 職員で記録保存 → 家族通知をトリガー（UI または save-staff-action 経路）

3. Supabase Table Editor で family_notification_logs に行が追加され、scheduled_for が未来時刻になっていること

4. GET /api/family-notification-dispatch を CRON_SECRET 付きで実行（または Cron 実行後）、該当行の notified_at が埋まり、contact_messages に家族向けメッセージが増えること

curl 例（本番 URL とシークレットは置き換え）:


curl -sS -H "Authorization: Bearer YOUR_CRON_SECRET" "https://（本番ドメイン）/api/family-notification-dispatch"

---

知財・法務メモ

閲覧パターンに基づく通知タイミングのロジックはコード内コメントに特許出願検討の旨を記載。外部モデルへの学習送信は行わない。
個人情報の取り扱いは Supabase（東京リージョン）内の閲覧ログ・通知ログに留まる設計。Gemini へのプロンプト送信はない。

---