6.9 KiB
タスク通知:予約・配信・取消
更新日:2026-11-04。本書は個人タスクの期限日/取り組む日のInbox通知と、その個人既定値を扱う。日次メールやOS通知、集中タイマーは別機能として扱い、Inbox予約の配信条件と混同しない。
操作と既定値
タスク編集に「期限日にInboxへ通知」「取り組む日にInboxへ通知」と時刻入力を置く。未設定の個人では両方ともOFF、未指定の時刻は09:00。通知を選択した日付は必須。期限は引き続き日付型であり、通知時刻によって時刻付きの締切へ変換しない。プロジェクトには通知を設定しない。
2026-11-04のソース更新では、個人設定 /-/sys/config?panel=organizer に期限日・取り組む日の通知既定値と通知時刻を追加した。Domain・本人ごとの既存preferences JSONに notify_due、notify_planned、reminder_time を保存する。DBスキーマ変更は不要。メールの日次配信とは独立した設定であり、古い設定の通知はOFFのまま、時刻は09:00として読む。
既定値は新規タスクだけに使い、既存タスクの設定や予約を一括変更しない。対応する日付がある場合だけ通知ONとし、日付のない簡易追加は許可する。新規編集画面で日付を入力した場合にも既定値を適用するが、利用者が通知を明示的に選び直した後はその選択を優先する。簡易追加・サブタスクはpreferencesの defaults を使用し、capture APIはリクエストの日付上書き後に通知の既定値を適用する。既存のitems APIの更新、CalDAV更新に個人既定値を強制しない。
保存時のドメイン設定のタイムゾーンをサーバー側で取得し、reminder_timezone に記録する。APIが指定した別のzoneを信用しない。設定画面のzone変更だけでは保存済み予約を動かさず、タスクの再保存で新しいzoneを適用する。編集画面には保存時に適用するzoneを表示する。
夏時間で存在しない現地時刻は保存を拒否する。重複する現地時刻はGoのタイムゾーン解決で決まる一方の時刻に固定し、二度送らない。civil date/timeとzoneから解決した発火時刻を予約に保存する。
保存と予約
TaskRecord の追加項目:notify_due、notify_planned、reminder_time、reminder_timezone。既存レコードの未指定は通知OFFとし、旧データ移行だけで通知を有効にしない。
organizer_reminders はDomain・task UUID・種類を主キーとし、owner、source version、発火時刻、civil date、zone、通知一意キー、pending/sent/skippedを保持する。(state,fire_at_ms,...) の索引から配信対象だけを取得する。
予約の作成/更新/取消は、タスクhead・履歴・専用ジャーナル・共通outboxと同じtransactionで行う。予約作成失敗で他だけがcommitされることはない。予約自体は正本から導く索引であり、共通outboxの旧イベントを使って非同期に復活させない。これにより、完了・日時変更と旧イベントの遅延配送の競合を避ける。
完了、取りやめ、アーカイブ、通知OFFで対応する予約を取り消す。タイトル/メモの変更ではsource versionのみ追従し、同じ通知を再送しない。日付・通知時刻・zoneの変更は新しい通知機会になる。
配信と権限
組み込みイベント task.reminders.deliver(定義ID builtin.task.reminders)を既定60秒間隔で実行する。最大100予約/回、処理上限3秒、priority -2、再試行3回。スケジューラの停止・同時実行数制御に従い、設定画面で間隔変更・停止・手動実行が可能。起動時に管理者の設定を上書きしない。
SQLite writer transactionの中で候補取得、現在版・状態、現在所有者、membership、Principal状態、Domainの有効性とlocal配置、拡張の有効性を再検査する。送信可能なのはactiveまたはreadonlyの現所有者のみ。他人の担当指定・共有配送はまだ行わない。
Inbox挿入と予約のsent更新は同時commit。一意キーはDomain、task UUID、種類、civil date/time、zoneから決定する。タスク版番号は一意キーに入れず、予約のsource version照合に使う。したがって件名変更・完了取消・ワーカーの再試行で、同じ機会の通知を再送しない。
権限失効・拡張無効化・現行版不一致の場合はskippedとし、再試行を繰り返さない。自動で遡って復活させず、再保存された現在の設定で予約を再評価する。Inboxへすでに入った通知は履歴として残すが、現在読めない件名・リンクは表示しない。
遅延と履歴
配信対象は発火時刻を過ぎた同じ現地日付の予約だけ。スケジューラ停止中などに前日以前となった分はskippedとし、古いBacklog通知を大量に送らない。日付境界直前の通知は、実行遅延で翌日に入ると送られない。時刻ぴったりの配信やOS通知を保証するものではない。
Inboxには一般的な通知文と対象UUIDだけを保存し、個人タスクの件名・本文を複製しない。API/通知詳細表示時に、現所有者・membership・最新予約と版を照合して現在の件名を取得する。完了/取消/日付変更などで対象予約が一致しなければ、「完了・変更済み、または現在利用できません」と表示し、taskへのリンクを外す。通知一覧の表示にCAS本文は読まない。
上部ナビの未読赤丸は可視タブで最大1分間隔、またはタブ復帰時に小さな問い合わせで更新する。非表示タブでは定期fetchしない。同じスクリプトが共通ヘッダーと通知ページに読み込まれてもイベントを二重登録しない。既存の「Inboxを開いたとき赤丸を消し、表示した通知を既読にする」挙動は維持する。
検証と後続
テスト対象:初期OFF、指定日とzoneでの予約、夏時間、存在しない時刻、日付変更・完了・取消・アーカイブ・OFF、権限失効、拡張停止、期限切れ予約、同一機会の重複防止、並列配信、予約/Inbox挿入失敗時のrollback、現時点での件名表示、別所有者への漏えい防止。ブラウザでは通知設定の保存、バックグラウンド配信後の赤丸、Inbox表示まで隔離環境で確認する。
次段階:ドメインの通知既定値、quiet hours、集約、予約状態の詳細表示、ローカルカレンダーの時間枠との関連付け・予定通知。外部から取り込んだカレンダー内容へのアクセスは、別途許可があるまで行わない。