docs: 基本設計書 §3.3.1/§3.3.2/§3.3.3 を screen-flow.md v1.0 と同期

[win2cot]

概要

PR #327(Issue #150)で docs/specs/ui/screen-flow.md v1.0 を新規追加し、Sprint 0 方向性レビューで以下の UX 方針を確定した。基本設計書 §3.3 系がまだ反映していないので、本 Issue で 1 PR にまとめて同期する。

スコープ(同一 PR で改訂)

1. §3.3.1 タスク一覧画面(S-04)改訂: 行操作に行内編集(ステータス / 期限 / 担当者 / 優先度 / タイトル / 説明 の 6 項目)を追記、新規追加遷移を右ドロワー基準に書き換え
2. §3.3.2 タスク登録/編集画面(S-06)改訂: S-06 を「URL 単位の互換窓口 + 右ドロワー UI 実装」と再定義。フルページ表示は URL 直接アクセス時のフォールバックと位置付け
3. §3.3.3 ダッシュボード画面(S-03)改訂: 数値カードに加えて「当日対応 + 振り返り」リスト 4 セクション(期限超過 / 今日やること / これから明日明後日 / 今日やったこと)を追記。完了化によるセクション間移動、視覚強調(期限切れ > 当日 > 未来 > 完了)を仕様化。数値カード「本日完了件数」も completed_at ベースに更新
4. §3.1 画面遷移図の差し替え: 旧 ASCII 図を docs/specs/ui/screen-flow.md への参照リンク + 抜粋に置き換え

完了の定義(DoD)

• 基本設計書 §3.1 / §3.3.1 / §3.3.2 / §3.3.3 が PR で改訂、マージ済み
• 改訂内容が docs/specs/ui/screen-flow.md v1.0 §5(UX 方針)と矛盾しない
• 改訂履歴に新バージョンを追記(SSOT として screen-flow.md v1.0 を引用)
• §3.3.3 数値カード「本日完了件数」が completed_at ベースで再記述されている

前提・依存

• 前提: PR feat(docs): 画面遷移図とサイトマップ初版を追加 (#150) #327(Issue 画面遷移図とサイトマップの初版作成 #150) merge 済み
• blocked-by: tasks.completed_at カラム新設(派生 5 = D-C)。completed_at の DDL/Entity/UseCase が無いと §3.3.3 「振り返りセクション」と数値カード「本日完了件数」の集計 SQL を記述できない

関連

• 親 PR: feat(docs): 画面遷移図とサイトマップ初版を追加 (#150) #327
• screen-flow.md SSOT: docs/specs/ui/screen-flow.md v1.0 §5
• ADR-0005(タスク認可 3 役割評価)
• OpenAPI v1.4.5(影響なし、本 PR は API 契約に触れない)

[win2cot]

作業完了レポート

PR #341 にて以下の対応を実施しました。

---

変更ファイル

docs/specs/基本設計書.md (v1.4.10 → v1.5.0)

---

変更内容

§3.1 画面遷移図

旧 ASCII 図を廃止し、docs/specs/ui/screen-flow.md v1.1(SSOT)への参照リンク + 主要業務動線の Mermaid 抜粋に差し替え。

§3.3.1 タスク一覧画面(S-04)

• 行操作: 行クリック → 右ドロワーで詳細表示(S-05)に変更。行内編集(ステータス / 期限 / 担当者 / 優先度 / タイトル / 説明 6 項目)を追記。操作不可ユーザーへの無効表示 + ツールチップ表示も明記
• 編集ボタン: クリックで編集ドロワーを開く(/tasks/{id}/edit に URL 同期)に更新
• 新規追加: 右ドロワーを開く(/tasks/new に URL 同期)に変更、URL 直接アクセス時のフルページフォールバックを追記
• 行内編集対象外操作(公開範囲変更 / 関係者編集 / 論理削除はドロワー内のみ)の注釈を追加

§3.3.2 タスク登録/編集画面(S-06)

• S-06 の再定義: 「URL 単位の互換窓口 + 右ドロワー UI 実装」として冒頭に明記。URL 直接アクセス時のフルページフォールバックと、ドロワー/フルページのフォームコンポーネント共有を記述
• 入力項目 / 操作可否をセクション分けして可読性を向上
• 所有者の対応 API を A-14 PUT /api/tasks/{id} 廃止 → PATCH /api/tasks/{id}(Issue discuss: OpenAPI A-14 PUT の部分更新化(PATCH /api/tasks/{id})を検討 #329 確定済)に更新

§3.3.3 ダッシュボード画面(S-03)

• 本日完了件数: tasks.completed_at の日付部分 = TODAY で集計するよう再記述。ChangeTaskStatusUseCase が DONE 遷移時に now() セット / 非完了戻しで NULL クリアする旨を明記

• 「当日対応 + 振り返り」リストを新設:

  #	セクション	抽出条件
  (1)	期限超過	期限 < 今日 AND ステータス ≠ 完了
  (2)	今日やること	期限 = 今日 AND ステータス ≠ 完了
  (3)	これから(明日・明後日)	今日 < 期限 ≤ 今日 + 3 日 AND ステータス ≠ 完了
  (4)	今日やったこと(振り返り)	ステータス = 完了 AND completed_at の日付 = 今日

  各セクションのソート順・視覚強調・セクション間移動挙動(完了化で (4) へ即移動、楽観的 UI 更新)・対応 API 案も記述。

---

DoD 確認

• 基本設計書 §3.1 / §3.3.1 / §3.3.2 / §3.3.3 改訂済み(PR docs(#328): 基本設計書 §3.1/§3.3.1/§3.3.2/§3.3.3 を screen-flow.md v1.1 と同期 (v1.5.0) #341)
• 改訂内容が screen-flow.md v1.1 §5 UX 方針と矛盾しない
• 改訂履歴に v1.5.0 を追記(screen-flow.md v1.1 を引用)
• §3.3.3 数値カード「本日完了件数」が completed_at ベースで再記述済み