OpenAPI v1.3.1 と画面項目の突き合わせ

[win2cot]

概要

コア 4 画面で表示・入力するフィールドを、api/openapi.yaml v1.3.1 のスキーマと一対一で突き合わせる。「画面に出したい項目が API レスポンスに無い」「API にあるが画面で使わない」を網羅的に検出する。

背景

• OpenAPI v1.3.1 は 24 operations / 23 schemas で SSoT
• 画面設計から見つかった不足項目は Sprint 0 中に OpenAPI 側を更新する(Sprint 1 で API 実装と画面実装を同時着手するため)

成果物

• docs/specs/ui/field-mapping.md
  • 画面 × 表示項目 × OpenAPI schema フィールド の対応表
  • 不足項目リスト(画面側の要望 → OpenAPI 追加・変更案)
  • 過剰項目リスト(API にあるが画面未使用)

完了の定義

• docs/specs/ui/field-mapping.md を PR で追加、マージ済み
• コア 4 画面すべてマッピング済み
• 不足項目が 0 件 or OpenAPI 更新の追加 Issue として起票済み
• OpenAPI 側更新が必要なら別 Issue を起票し、Sprint 0 Readiness([Sprint 0 Readiness] 詳細設計フェーズ残課題チェックリスト #120)系の枠で消化

関連

• 親:[Sprint 0] 画面設計 初版(Claude Design 活用) #149
• 依存:Claude Design 検証(画面項目を確定させてから突き合わせ)
• api/openapi.yaml(v1.3.1)