Files
pages/docs/design/ja/task-reminders.md
T
Anya Tokugawa a6bf3dfe41
Build and publish container images / images (push) Successful in 11m12s
Release container images / release (push) Successful in 17s
Refine task editor layout and personal reminder defaults
2026-11-04 10:12:25 +09:00

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、集約、予約状態の詳細表示、ローカルカレンダーの時間枠との関連付け・予定通知。外部から取り込んだカレンダー内容へのアクセスは、別途許可があるまで行わない。