[Sprint 0 Readiness] 詳細設計フェーズ残課題チェックリスト

[win2cot]

概要

PR #76 で詳細設計成果物(基本設計書 v1.3.x / OpenAPI v1.3.1 / Mermaid 図 / Flyway DDL案 / 各種レビュー報告)を投入完了。
Sprint 0(scaffold ↔ 設計書整合実装)に着手する前にクローズしておくべき残課題を本Issueで集約・追跡する。

優先順位の考え方:

• OpenAPI 精緻化: 実装フェーズでクライアントコード生成や API契約凍結が走るため、Sprint 0 P0 タスク着手前に確定させる
• 設計書精緻化: クロスリファレンスの整合と将来読者の混乱回避のため、同タイミングで処理
• 運用整理: マージ後 0〜1週間以内に方針確定

完了予定: 2026-07-13 までに(Sprint 0 着手 7/14 の前日まで)

---

A. OpenAPI 精緻化(クライアントコード生成・API契約凍結の前提)

• api(openapi): PATCH /api/tasks/{id}/visibility の 200 レスポンスにボディスキーマを追加 (R2#4) #99 PATCH /api/tasks/{id}/visibility の 200 レスポンスにボディスキーマを追加(Task or 204)
• api(openapi): PUT /api/tenant/users/{userId}/role の 200 にスキーマを追加 (R5#8) #106 PUT /api/tenant/users/{userId}/role の 200 レスポンスにスキーマを追加(TenantUser or 204、Renovateが稼働していない #23 と方針統一)
• api(openapi): 全スキーマの required 配列を整備 (R7#2、Issue 29 拡張) #108 9 スキーマに required 配列を整備(Tenant / TenantSummary / MeResponse / TenantUser / Task / TaskPage / Stakeholder / DashboardSummary / AuditLog)
• api(openapi): GET /api/tasks の status クエリパラメータに enum 値を明示 (R7#4) #110 GET /api/tasks の status クエリパラメータに enum / pattern を明示
• api(openapi): 404 レスポンス定義を $ref 共通化(PATCH /tasks/{id}/status / POST /tasks/{id}/stakeholders) (R10#10) #114 404 レスポンス定義を $ref 共通化(components.responses.NotFound 強化)
• docs(spec): HTTP 409 の使用シナリオを §5.4 に詳細化 (Review2 R-2) #94 HTTP 409 シナリオを §5.4 に詳細化(全CRUDのエラー応答契約)
• fix(openapi): OAS 3.1 の nullable 記法を type: [T, 'null'] 形式に移行する #118 OAS 3.1 nullable 記法を type: [T, 'null'] 形式に移行

B. DB スキーマ規約(Flyway マイグレーション実装の前提)

• db(flyway): tasks の FK fk_tasks_tenant に ON DELETE RESTRICT を明示 (n-1) #81 tasks の FK fk_tasks_tenant に ON DELETE RESTRICT を明示(他FKも同方針で統一、db(flyway): V1.0.1 — tasks拡張 (tenant_id/visibility/priority/due_date/status enum 等) (N1) #83/db(flyway): V1.0.2 — マルチテナント+補助6テーブル追加 (N2) #84 マイグレーションに織り込む)

C. 設計書精緻化(クロスリファレンス整合)

• docs(spec): 要件定義書を v1.3 へ更新 — 改訂履歴整合 (Review2 R-1) #93 要件定義書を v1.3 に更新(基本設計書 v1.3 / v1.3.2 反映)
• docs/code: 認可ロジックの SSOT を Domain 層 (TaskAuthorizationDomainService) に集約 (Review2 R-3) #95 認可ロジックの SSOT を Domain 層 TaskAuthorizationDomainService に集約する旨を設計書に明記、OpenAPI description を簡略化
• api(openapi): AuditLog スキーマの tenantId 扱いを明示 (R6#7) #107 AuditLog スキーマの tenantId 扱いを明示(方針B: レスポンスに含めない旨を description で記載 推奨)
• docs(spec)+api: TenantUser.status = DISABLED への変更手段を仕様化 (R7#6) #111 TenantUser.status = DISABLED への変更手段を仕様化(方針B: 本フェーズではスコープ外と明記 推奨)
• docs(reviews): gap-analysis 内「API実装(22 endpoints)」を 24 に更新 (R10#9) #112 docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md 内の「API実装(22 endpoints)」を 24 に更新

D. PR本文(GitHub UI 操作)

• docs/PR: PR #76 説明文の「22 endpoints」を「24 endpoints」に更新 (R7#3) #109 PR docs: 詳細設計成果物 (v1.2 仕様書、OpenAPI、Mermaid図、レビュー報告) の初期投入 #76 説明文の「22 endpoints」を「24 endpoints」に更新

E. 運用整理

• chore: docs/reviews の運用スクリプト・一時メモの取り扱い方針を確定 (R2#7 / R3#2 統合) #102 docs/reviews/ 配下のスクリプト・一時メモの取り扱い方針確定(.sh 群を削除 or .gitignore、.md 系は保持 — 推奨)

受け入れ条件

• 上記 A〜E のすべてがクローズされている
• OpenAPI lint(spectral lint api/openapi.yaml)が無警告
• 基本設計書・要件定義書・OpenAPI の3点で「エンドポイント数」「ロール一覧」「ステータス値」が完全一致

関連

• PR docs: 詳細設計成果物 (v1.2 仕様書、OpenAPI、Mermaid図、レビュー報告) の初期投入 #76(マージ済)
• Sprint 0 本体: [Phase 1 Sprint 0] scaffold ↔ 設計書 v1.4.x 整合実装(2 週間、2026-06-14 〜 06-27) #121
• 詳細設計レビュー報告: docs/reviews/2026-05-06-detailed-design-review.md
• ギャップ分析: docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md