Files
pages/docs/design/ja/task-inline-schedule.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

5.6 KiB
Raw Permalink Blame History

インラインタスク、サブタスク、日割り工程表

更新:2026-09-25。organizer.tasks 0.6.0。実装・隔離fixture検証済み。同日05:59 JSTに本番2インスタンスへ反映済み。反映記録。

一覧中心の編集

0.7.0の追加仕様(2026-09-25 07:07 JST本番反映済み):日別計画・親子グループ・Wikiメモ。以下の0.6.0契約を拡張する。

件名・状態・取り組む日・期限・見直す日・工程開始/終了を一覧で直接編集する。変更確定/フォーカス移動時に保存する。詳細メモ、通知時刻等は既存の詳細画面へ残す。時間枠ボタンは一覧から直接カレンダー追加モーダルを開く。

保存は行が取得したversionでIf-Matchを行う。完全なTaskRecordを再取得してから変更項目を合成するが、If-Matchは再取得したversionへ勝手に進めない。他の画面との競合では入力を保持し、行の再読込で明示的に破棄できる。編集中/保存中は一覧の自動再読込で入力を捨てない。

コンパクト一覧(2026-09-25追加、06:17 JST本番反映済み)

本番反映記録。

  • 幅1024px以上は表に近い1タスク1行。共通見出しの下に完了操作・件名・状態・取り組む日・期限・見直す日・工程開始・工程終了・操作を並べる。行高は通常約34px、行内のmargin/gapは0。サブタスクも列幅を揃え、件名の字下げと親へのリンクで階層を示す。
  • 利用可能な横幅を使い、列が収まらないPC幅では一覧の内側のみ横スクロールする。入力や操作を折り返さず、ページ全体の横はみ出しを防ぐ。詳細・カレンダー追加・再読込・子の展開・子の追加はラベル付きアイコン操作。
  • 1024px未満はフィールドラベルを省略しないカード状の配置。日付は2列、入力文字16px以上、タッチ対象44px以上。サブタスクは罫線と字下げで区別する。入力・保存契約はPCと同一。
  • 保存中/成功の通知はスクリーンリーダー向けstatusに残し、行を増やさない。保存エラー・競合は行の下に本文を表示して入力を保持する。アイコンにはtooltipとアクセシブル名を設け、サブタスクの展開状態をaria-expandedで伝える。
  • Chromium fixtureで1440px・1024px・390px・320px幅、PC列揃え、タッチ領域、インライン保存、階層表示を検証する。実機Safariのdate入力等は引き続き別途確認が必要。

階層と日付

parent_uuidを持つサブタスクを親の一覧からインライン追加できる。初版は親→サブタスクの2階層。同じDomain・所有者のtaskのみ。自己参照・循環・3階層目・他人の親・新規のarchived親への配置を拒否する。親の完了・archiveは既存の子を完了/archiveしない。

子は独立した件名、状態、各種日付、見積りを持つ。作成時に親のproject/bucket/priorityをコピーするが、その後の自動継承はしない。Todayの見積もりは各項目独立で加算するため、親と子に同じ工数を二重計上しない運用とする。roll-upは未実装。

新しいstart_on/end_onは工程のcivil dateで、両端を含む。片方だけならその1日。逆順と366日を超える範囲を拒否する。期限/計画日や実際のカレンダー時間枠は自動変更しない。

工程表とナビゲーション

  • /v/plan/tasks/schedule:ドメイン現在月。
  • /v/plan/tasks/schedule/YYYY/MM:月の日割り工程表。日付列に工程のバーを表示、タスク詳細へ遷移。
  • ?project={UUID}でプロジェクトを絞り込む。
  • API:GET /_/api/v1/extension/organizer.tasks/schedule?month=YYYY-MM&project=...。
  • 月最大200件、超過はpartial表示。開始日の索引と366日上限で走査範囲を制限する。メモは返さない。
  • family API:items?view=family&parent={UUID}。100件まで+cursor、完了/archive済みの子も確認できる。
  • ホームの検索ショートカットへタスク一覧アイコン、上部ナビバーへ「今日のタスク」モーダルを追加。開くまで一覧fetchをしない。

Migration、検証、次段階

DBにparent/start/end列と子一覧・工程表索引を追加する。新フィールドは空ならcanonical JSONから省略するため既存正本のhashを変更しない。工程と親参照は版管理対象。同一transactionで正本参照、投影、履歴、outbox、通知を更新する。

旧バイナリは新フィールドを保存時に落とすため、新しい階層・工程を利用した後の単純なbinary rollbackは避け、forward-fixを優先する。データごと戻す場合はDBと正本を同じバックアップ時点へ戻し、それ以降の更新が失われることを確認する。

Goで日付範囲、月またぎ、階層制約、親状態と子の独立性を検証。ChromiumでPC/スマートフォン幅のインライン日付編集、子追加、Todayモーダル、時間枠・Pomodoroの既存操作を検証。

TODO:日割りバーのdrag/resize、折りたたみ状態保持、子の昇格/別の親への移動UI、親への工数roll-up、日付未設定を工程表から割当てる操作、依存関係・共有・日課instance。時間単位の工程表とは別機能として扱う。