Files
pages/docs/design/ja/task-daily-notes.md
Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

74 lines
7.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 日別計画・親子グループ・Wikiメモ
2026-09-25実装。organizer.tasks 0.7.0。今回の変更は2026-09-25 07:07 JST本番反映済み。
[本番反映記録](../../operations/deployments/2026-09-25-task-daily-notes.md)。
## 日別の計画
| 画面 | URI | 対象 |
| --- | --- | --- |
| 持ち越し | `/v/plan/tasks/carryover` | 昨日以前の計画日、または昨日以前の期限が残る未完了タスク |
| 今日 | `/v/plan/today` | 既存の今日の計画・今日までの期限超過 |
| 明日 | `/v/plan/tasks/tomorrow` | ドメインのタイムゾーンでの翌日の計画・期限 |
| 任意の日 | `/v/plan/tasks/day/YYYY/MM/DD` | 指定日が計画日または期限の未完了タスク |
日付ピッカーと前後日の移動を提供する。日別画面のクイック作成/新規作成では選択日を計画日に入れる。カレンダー時間枠の初期日付も日別画面の選択日を優先し、他画面はタスクの計画日があれば利用する。時刻の解釈・DST検証は既存のカレンダーAPIによる。
持ち越し画面では割り当て先日付を指定し、各行の矢印でその日に変更できる。変更するのは `planned_on` のみ。期限・工程日・子の計画日・カレンダーイベントは自動変更しない。期限超過のタスクは計画を将来に移しても持ち越しに残る。完了や取消済み・archive済みは除外する。完了した日の実績表示はこの画面の対象外。
APIは既存itemsの `view=day&date=YYYY-MM-DD`、`view=carryover`。指定日が不正なら422。今日と持ち越しの基準日はクライアントではなくサーバーのドメイン時刻で決定する。既存のToday集計・外部カレンダーは変更しない。
## 親子の一覧
- UIは `hierarchy=1` で取得。親の作成日時/UUIDをグループキーとし、親→子の順で同じグループに配置する。子はグループ内で新しい順。
- cursor比較にもグループキーと親子順位を含める。続きを取得した際はUUID単位で統合し、親・子を重複させない。
- 子だけが日付や検索条件に一致したときは、同じDomain・所有者の親を補足表示する。「親」マークは親自体がフィルタ対象ではないことを示す。この補足は親に日付を割り当てたり、Today集計へ追加したりしない。
- 親を今日・明日へ入れた場合も、展開操作で日付未設定/別日/完了済みを含む子を取得できる。最初に一致した子だけを表示している場合は「すべてのサブタスク」アイコンを提供する。
- 展開はオンデマンド、1回100件。超過時はその親の中で続きを読み込む。親情報は最大100件のバッチ取得とし、一覧の各子について個別APIを呼ばない。
- 同一画面での再読込では展開済み状態を保持する。画面間・ブラウザ再起動をまたぐ永続化は未対応。
- 未保存の編集がある間は一覧再構築・子の置換を抑止し、編集中の入力を破棄しない。
グループソートには所有者で限定した自己結合を利用する。出力は既定60/最大100件、APIは既存の5秒上限。極端に大量の個人タスクでソートが支配的になった場合、安定したfamily sort keyの索引化を検討する。全ユーザ・全Domainを読み込む設計にはしない。
## Wikiメモの保存先と動作
従来のTaskRecord.notesは個人用の短いプレーンテキストメモとして残す。今回の「メモ表示」「メモ編集」は、通常のWiki Pageへ接続する別の導線。
プロジェクトの編集画面で次を指定する。
1. **関連するWikiのPath**:実在する、本人が読めるプロジェクトのページ。
2. **Wikiメモのサブ階層**:そのページの配下を表す相対Path。既定は `tasks`。複数階層も指定可。
例:
- プロジェクトの関連Wiki:`/projects/pageswiki`
- サブ階層:`work/notes`
- タスク件名:`通知UIの改善`
- 作成先:`/projects/pageswiki/work/notes/通知UIの改善`
件名を1つのPathセグメントとして扱う。`/\\?#%` と制御文字はハイフンへ変換、単独の `.`/`..`/`_` はUUID付きの安全な名前へ置換する。相対サブ階層の絶対Path、空セグメント、親移動、制御空間 `_` は拒否する。
既存の関連WikiページUUIDがタスクにあれば、それをメモとして使う。なければ上記の候補Pathを確認し、明示的な確認後に新規作成する。初期本文はHTMLエスケープした件名のH1。表示ボタンからでも未作成なら作成確認→エディタとなる。編集時は利用可能な既定のHosted Editorを優先し、それ以外は標準の `/e/-/...` を利用する。
初回作成後はタスクの `page_uuid` で関連付ける。Wiki側のrename/移動に追従する。タスク件名やプロジェクトのサブ階層を変えても、既存のメモを自動rename/移動しない。同名ページが既にあれば409で停止し、詳細画面からの明示的な関連付け、または件名の変更を案内する。既存の内容を上書き・自動統合しない。
プロジェクト未選択/関連Wiki未指定の場合は設定を案内する。プロジェクトの関連ページ自体の新規作成は既存Wikiエディタで行う。リンク済みメモが削除・権限失効した場合、同じPathへ勝手に作り直さない。詳細画面で関連付けを明示的に解除してから再作成する。
## API・保存・公開の境界
- `GET items/{uuid}/note`:現在のPath、閲覧/編集URL、linked/exists/writable、TaskRecord、ETag。副作用なし。
- `POST items/{uuid}/note`:新規作成と関連付け。`If-Match: "{task version}"`、JSON `{"path":"確認した作成先"}` が必要。欠落428、版/確認先変更412、Path衝突409。
- Page、Path、初期Revision、タスクhead/revision/journal、共通outboxを同一transactionで確定する。プロジェクト版と関連Path→UUIDもwriter transactionで再照合。DB失敗時にPageや紐づけだけを残さない。CASファイルは既存仕様どおりrollback後に未参照ファイルとして残る可能性がある。
- タスクは個人専用のまま。WikiメモはWiki Pathの公開設定と権限に従う。作成確認でこの違いを明示する。タスク所有権だけでWikiのread/create/writeをバイパスしない。
- readonly・他人のタスク・失効membership・無効な拡張を拒否。既存Wikiへの明示リンクは従来のpage_path更新を利用する。
- DBスキーマ変更なし。`notes_subpath,omitempty` はプロジェクト正本JSONの追加項目。未指定の既存正本のhashは変えない。旧バイナリでプロジェクト設定を保存するとこの追加項目が落ちるため、運用開始後はforward-fixを推奨する。
## 検証・残り
Go fixture:日別/持ち越し条件、親子cursor、補足親の私有境界、日付検証、メモ作成、保存失敗rollback、H1 escaping、同名衝突、確認先変更、UUID追従、readonly、Wiki書込権限を検証。
Chromium fixture(1440/1024/390/320px):親から日付未設定の子を展開、子の重複防止、明日への作成、時間枠の初期日、持ち越しの割当て、メモ編集ボタンで新規Wikiへ遷移、表示ボタンでViewerへ遷移。外部取り込みカレンダーにはアクセスしない。
残件:親子の計画日の明示的一括変更、日別キャパシティ、日別の完了実績、親子のドラッグ並べ替え、共有、メモの任意rename/移動のタスクUI統合、実機Safari検証。本番2インスタンスへ2026-09-25 07:07 JSTに反映済み。