api(openapi): 404 レスポンス定義を $ref 共通化(PATCH /tasks/{id}/status / POST /tasks/{id}/stakeholders) (R10#10)

[win2cot]

背景

他エンドポイントは $ref: '#/components/responses/NotFound' を使うが、
PATCH /api/tasks/{id}/status と POST /api/tasks/{id}/stakeholders だけ
インライン定義(description で「タスク不在 or 参照権限なし」を明記)。

推奨案

components.responses.NotFound の description を強化(リソース不在 or 参照権限不足のポリシー明記)し、
全エンドポイントを $ref に統一する。

参照

PR #76 Claude review (R10) 新規 #10

[win2cot]

@claude go

[claude]

Claude finished @win2cot's task in 3m 5s —— View job • claude/issue-114-20260514-1200 • Create PR ➔

---

完了

• コンテキスト収集（OpenAPI spec ファイルの確認）
• components.responses.NotFound の description 強化
• PATCH /api/tasks/{id}/status の inline 404 を $ref に変更
• POST /api/tasks/{id}/stakeholders の inline 404 を $ref に変更
• ビルド・テスト実行（./gradlew check 成功）
• コミット＆プッシュ

変更内容

api/openapi.yaml に以下の3点を適用しました:

1. components.responses.NotFound の description 強化

   • 変更前: リソース未存在
   • 変更後: リソース未存在、または参照権限不足(リソース存在を漏らさない方針)

2. PATCH /api/tasks/{id}/status のインライン 404 を $ref に変更

   # 変更前
   "404":
     description: タスク不在 or 参照権限なし(リソース存在を漏らさない方針)
     content:
       application/json:
         schema: { $ref: "#/components/schemas/Error" }
   # 変更後
   "404": { $ref: "#/components/responses/NotFound" }

3. POST /api/tasks/{id}/stakeholders のインライン 404 を $ref に変更

   # 変更前
   "404":
     description: タスク不在 or 参照権限なし
     content:
       application/json:
         schema: { $ref: "#/components/schemas/Error" }
   # 変更後
   "404": { $ref: "#/components/responses/NotFound" }