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.
47 lines
4.4 KiB
Markdown
47 lines
4.4 KiB
Markdown
# 13. タスクとチケット
|
||
|
||
状態:個人用local taskとプロジェクト、期限日/計画日のInbox通知、個人ローカルカレンダーへの時間枠、永続化Pomodoroを実装(2026-09-25)。個人タスクの限定CalDAV/CLI同期は0.8.0で実装・隔離試験済み、2026-09-26 00:24 JST本番反映済み。共有、チケット、一般のカレンダー予定通知、繰り返し・差分CalDAV同期は設計段階です。[実装契約と次段階](tasks-implementation.md)、[時間枠とPomodoro](task-planning-focus.md)、[CalDAV/CLI](task-caldav.md)を参照してください。
|
||
|
||
## 二つの用途
|
||
|
||
タスクは「誰が何をいつまでにするか」。チケットは受付番号、責任者、状態遷移、履歴、問い合わせや障害等の業務上の単位です。チケットをそのままカレンダー予定にしません。
|
||
|
||
第一案は共通work itemを基盤に、task viewとticket workflowを分けます。チケット固有の公開範囲・番号・遷移が複雑になれば専用表へ分離しますが、認証やコメントは共通基盤を再利用します。
|
||
|
||
## データ案
|
||
|
||
- 共通:UUID、Domain、collection、kind、title、body_page_uuid、creator、assignee、version、created/updated、archive状態。
|
||
- タスク:status、priority、start/due、完了日時、checklist、parent task、dependency。
|
||
- チケット:queue UUID、queue内の単調な受付番号、workflow版、type、labels、watchers、resolution。
|
||
- 添付:固定Document参照と出典。コメント:共通thread。変更履歴:actor付きevent。
|
||
|
||
Path、受付番号、題名はidentityではありません。同じPageに複数work itemが関連しても、暗黙に一つへ統合しません。assignee表示とPrincipalの権限付与も別です。
|
||
|
||
## 状態と操作
|
||
|
||
最初のtaskはtodo / doing / done / cancelledとし、遷移を監査します。未完了への復帰で元の完了記録を消さず、履歴を残します。チケットはopen / in_progress / resolved / closedを案とし、reopen権限、完了理由、受付担当と解決担当を後で分けられる構造にします。
|
||
|
||
create/read/update/assign/transition/comment/manageは概念上分離します。外部依頼者には自分のチケットだけを見せる場合があるため、queue一覧の閲覧とticketの閲覧を分けます。担当にしただけで非公開本文が読めるようにしません。
|
||
|
||
## 期限・依存・繰り返し
|
||
|
||
期限は日付だけか時刻付きかを明示します。日付のみをUTC午前0時へ変換しません。依存は循環を拒否し、削除済み・閲覧不可の依存先の詳細を表示しません。親子進捗の自動集計は別projectionです。
|
||
|
||
繰り返しは第二段階。完了時に次のinstanceを作る方式と、iCalendar recurrenceを扱う方式の対応を先に決めます。完了イベントの二重配送で次回タスクが二つ増えない鍵を必要とします。
|
||
|
||
## CalDAVとの関係
|
||
|
||
iCalendarにはVTODOがあり、CalDAVはカレンダー資源を扱います。ただしクライアントごとのタスク・繰り返し対応を試験する必要があります。これは「CalDAVだけでチケット管理が完成する」という意味ではありません。[iCalendar](https://www.rfc-editor.org/rfc/rfc5545)、[CalDAV](https://www.rfc-editor.org/rfc/rfc4791)。
|
||
|
||
最初はlocal task一覧と期限表示、次にVTODOの明示export/import、最後に選定クライアントとの同期を検討します。workflow、コメント、細かな権限をVTODOへ無理に押し込みません。失われる情報を変換警告に残します。
|
||
|
||
## 実装TODO
|
||
|
||
- TASK-1:個人local作成/取得/更新、version競合、Page参照、所有者限定一覧は実装済み。削除は復元可能なアーカイブ、物理削除は未提供。
|
||
- TASK-2:日付の期限/計画/見直し、タイトルフィルタ、archive、個別ONのInbox通知は実装済み。担当共有、通知集約、exportは未実装。
|
||
- TASK-3:checklist/依存とboundedな一覧・calendar射影。
|
||
- TICKET-1:queue・番号予約・workflow版・権限付き遷移。
|
||
- TASK-4:VTODO fixture、未対応property保持、繰り返し・同期の判断。
|
||
|
||
同時採番、二重POST、完了取消、夏時間・終日、assignee失効、本文削除を受け入れ試験にします。
|