docs(spec): HTTP 409 の使用シナリオを §5.4 に詳細化 (Review2 R-2)

[win2cot]

背景

OpenAPI では POST /api/tenant/users/invite のみが 409 定義済だが、
基本設計書 §5.4 のエラー応答表で 409 シナリオが「一意制約違反など」と曖昧。

やること

§5.4 に 409 が返却される具体的シナリオ表を追記:

• ユーザー招待時に既に user_tenants に存在
• ユーザー招待時に oidc_sub が未登録
• 関係者追加時に既存登録
• テナント code が一意制約違反

OpenAPI 該当エンドポイントの 409 description も表と一致させる。

参照

PR #76 Claude review (2026-05-10) 推奨 R-2

[win2cot]

@claude go

[claude]

Claude finished @win2cot's task in 3m 6s —— View job • claude/issue-94-20260514-1256 • Create PR ➔

---

完了

• リポジトリのファイル構成を調査する (docs/specs/基本設計書.md, api/openapi.yaml を特定)
• 基本設計書 §5.4 を特定・読み込む
• OpenAPI スペックファイルを特定・読み込む
• 基本設計書.md を更新する
  • バージョン番号を 1.3.2 → 1.3.3 へ更新、改訂履歴追記
  • §5.4 の 409 行を「競合状態(詳細は §5.4.1)」に更新
  • §5.4.1 に 409 シナリオ表を追記(4シナリオ)
• openapi.yaml を更新する
  • バージョンを 1.3.3 へ更新
  • POST /api/tenant/users/invite の 409 description を更新
  • POST /api/tenants に 409 レスポンス追加(tenants.code が一意制約違反)
  • POST /api/tasks/{id}/stakeholders の 409 description を更新
• 変更をコミット・プッシュする

変更内容サマリー

docs/specs/基本設計書.md

• バージョン 1.3.2 → 1.3.3、改訂履歴に Issue docs(spec): HTTP 409 の使用シナリオを §5.4 に詳細化 (Review2 R-2) #94 対応を記載
• §5.4 の 409 行を 一意制約違反など → 競合状態(詳細は §5.4.1) に更新
• §5.4.1 を新設し、以下の 4 シナリオ表を追記:

API	シナリオ
POST /api/tenant/users/invite	招待対象が既に user_tenants に登録済み
POST /api/tenant/users/invite	oidc_sub が users テーブルに未登録
POST /api/tasks/{id}/stakeholders	指定ユーザーが既に同タスクの関係者として登録済み
POST /api/tenants	tenants.code が一意制約違反

api/openapi.yaml

• バージョン 1.3.2 → 1.3.3
• POST /api/tenant/users/invite 409 description を §5.4.1 と一致するよう更新
• POST /api/tasks/{id}/stakeholders 409 description を更新
• POST /api/tenants に不足していた 409 レスポンスを追加