api+docs(spec): OpenAPI レスポンスコード列挙順序の統一ルール策定 (PR #179 follow-up)

[win2cot]

背景

PR #179 のレビューで、api/openapi.yaml の各エンドポイントでレスポンスコード列挙順序が不統一であることが指摘された:

エンドポイント	現状の順序
GET /api/tasks/{id}	200 → 404 → 401 → 403
PUT /api/tasks/{id}	200 → 403 → 404 → 401
DELETE /api/tasks/{id}	204 → 403 → 404 → 401
PATCH /api/tasks/{id}/visibility	200 → 400 → 403 → 404 → 401
POST /api/tasks/{id}/stakeholders	201 → 400 → 401 → 403 → 404 → 409

PR #179 が触れた箇所も含む既存問題で、本 PR の範囲外として別 Issue 化された。

やること

1. 統一ルールを策定
   • 推奨候補: 2xx(成功) → 4xx(クライアントエラー昇順: 400 → 401 → 403 → 404 → 409 → 422)→ 5xx(サーバエラー)
2. 設計規約 §2 または §2.3 に「レスポンスコード列挙順序」セクションを追加
3. api/openapi.yaml の全エンドポイントを統一ルールに揃える(本作業は別 PR で一括実施を推奨)

受け入れ条件

• 設計規約に並び順ルールが明文化されている
• OpenAPI 全エンドポイントが新ルールに準拠している
• 将来の PR レビューで「並び順」を理由とした指摘が出ないこと

参照

• 親 Issue: [Sprint 0 Readiness] 詳細設計フェーズ残課題チェックリスト #120 [Sprint 0 Readiness]
• 派生元 PR: api(openapi): v1.4.4 — info.description 共通レスポンス補完 + Conflict/NotFound description 具体化 + AuditLog 補強 (Issues #127 #128 #173 #174) #179(OpenAPI v1.4.4)
• 設計規約 §2 API 設計規約

[claude-automation-impl]

実装方針(着手宣言)

対応内容

1. 設計規約 §2 に「2.6 レスポンスコード列挙順序」を追加

   • ルール: 2xx(成功) → 4xx 昇順(400 → 401 → 403 → 404 → 409 → 422) → 5xx

2. api/openapi.yaml の不統一箇所を一括修正

   修正が必要なエンドポイント(7 件):

   エンドポイント	現状	修正後
   POST /api/auth/tenants/{id}/select	204→403→401	204→401→403
   PUT /api/tenant/users/{userId}/role	200→403→401	200→401→403
   GET /api/tasks/{id}	200→404→401→403	200→401→403→404
   PUT /api/tasks/{id}	200→403→404→401	200→401→403→404
   DELETE /api/tasks/{id}	204→403→404→401	204→401→403→404
   PATCH /api/tasks/{id}/visibility	200→400→403→404→401	200→400→401→403→404
   GET /api/audit-logs	200→403→401	200→401→403

ブランチ: claude/impl/issue-182-openapi-response-order