docs/code: 認可ロジックの SSOT を Domain 層 (TaskAuthorizationDomainService) に集約 (Review2 R-3)

[win2cot]

背景

シーケンス図と OpenAPI 双方に visibility 認可フィルタの詳細が記述され、仕様変更時の更新漏れリスクあり。

やること

1. 設計書/シーケンス図で認可フィルタ詳細を簡潔化、「実装は TaskAuthorizationDomainService が SSOT」と注記
2. OpenAPI description を「詳細は基本設計書 §6.2.1 参照」型に変更
3. 実装フェーズで TaskAuthorizationDomainService のメソッド定義を Domain 層に配置

参照

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

[win2cot]

@claude

[claude]

Claude finished @win2cot's task in 9m 34s —— View job • claude/issue-95-20260515-1337 • Create PR ➔

---

実装完了

Issue #95 の全タスクを実装しました。

TODO

• コンテキスト収集（設計書・OpenAPI・シーケンス図の確認）
• docs/diagrams/sequence-03-task-list-authz.mmd: 認可フィルタ詳細 alt ブロックを簡潔化、SSOT 注記追加
• docs/diagrams/sequence-04-task-edit-authz.mmd: インライン条件詳細を簡潔化、SSOT 注記追加
• docs/specs/基本設計書.md §6.2.1: SSOT 実装注記追加
• api/openapi.yaml: GET /api/tasks の description を基本設計書 §6.2.1 参照型に変更
• task/domain/package-info.java 作成
• task/domain/TenantRole.java 作成
• task/domain/TaskAuthorizationDomainService.java 作成
• ビルド確認 (./gradlew check) — BUILD SUCCESSFUL
• コミット・プッシュ

変更概要

シーケンス図の簡潔化

• sequence-03: visibility ごとの詳細 alt ブロックを削除し、assertViewable() 呼び出しのみを示す。「参照認可の詳細ルールは TaskAuthorizationDomainService が SSOT（基本設計書 §6.2.1 参照）」と Note を追加
• sequence-04: assertEditable 後のインライン条件詳細を削除し、同様の Note を追加

基本設計書 §6.2.1

• 実装 SSOT の段落を末尾に追加: TaskAuthorizationDomainService（Domain 層）に一元化する旨と、UseCase の例外 throw 方針を明記

OpenAPI GET /api/tasks

• visibility=TENANT: 全員参照可 等の詳細フィルタ列挙を削除
• 「詳細は基本設計書 §6.2.1 参照。実装の SSOT は TaskAuthorizationDomainService」に置き換え

新規 Java ファイル (task/domain/)

• TenantRole.java: TENANT_ADMIN / MEMBER enum
• TaskAuthorizationDomainService.java: Spring 非依存の純粋関数。canBeViewedBy / canBeEditedBy / canBeDeletedBy / canChangeStatusBy / canChangeVisibilityBy の 5 メソッドが boolean を返す。UseCase 層が false 時に適切な例外を throw する設計

---

| Branch