backend: TenantContext + TenantContextFilter + Hibernate Filter 実装 (N5)

[win2cot]

背景

マルチテナント分離の根幹。全SQLに WHERE tenant_id = :currentTenantId を自動付与する仕組みが未実装。

方式は ADR-0010: マルチテナント絞り込みの自動付与は Hibernate Filter で行う(Issue #145、2026-05-31 Accepted)で確定済。本タスクは ADR-0010 の実コード配線を担う。

やること

1. TenantContext (ThreadLocal保持)
2. TenantContextFilter: X-Tenant-Idヘッダ→user_tenants検証→ACTIVEなら設定
3. Hibernate Filter tenant_filter 定義 + 全エンティティに @FilterDef / @Filter
   • @FilterDef を共通 mapped superclass に置く案 vs package-info.java に置く案を比較選定(ADR-0010 §6)
   • TenantContext を session に注入する経路は OncePerRequestFilter 案 vs Hibernate SessionEventListener 案を比較選定(ADR-0010 §6)
4. 既存 Repository の SELECT 系派生クエリ命名を緩和(コーディング規約 §8.1 v1.4)
   • TaskJpaRepository#findByIdAndTenantId → findById に書き換え(他 Repository も同様)
   • @Modifying UPDATE/DELETE および native query は引き続き明示絞り(deleteByTenantIdAndId 等)
5. クロステナント漏洩テストを CI に追加(設計規約 §9.4: 参照系 404 / 更新系 403)

受け入れ条件

• X-Tenant-Id 経由で全 API 自動絞込
• エンティティ関連ナビゲーション(task.subTasks 等の lazy fetch)でも Filter が効くことを確認
• クロステナント漏洩テストがグリーン(参照系 404 / 更新系 403、§9.4)
• SELECT 系 Repository 派生クエリが findById 等の単純命名に書き換え済(§8.1 v1.4)
• @Modifying UPDATE/DELETE / native query は引き続き明示絞り(§3.3 / §8.1 維持ルール)
• @FilterDef 配置案・TenantContext 注入経路案の選定根拠が PR description に記載

参照

• ADR-0010: マルチテナント絞り込みの自動付与は Hibernate Filter で行う(Issue ADR-0004(想定): テナント分離実装 — Hibernate Filter vs Spring AOP を決定 #145)
• 設計規約 v1.4 §3.3 マルチテナント
• コーディング規約 v1.4 §8.1 Repository メソッド命名
• docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md § G-4
• 基本設計書 v1.3 §6.3

[claude-automation-impl]

実装着手宣言

方針サマリ

1. TenantContext — ThreadLocal で tenantId: Long を保持するユーティリティクラス (tenant パッケージ)
2. UserTenant / UserTenantRepository — user_tenants テーブルのJPAエンティティ+リポジトリ
3. TenantContextFilter — OncePerRequestFilter で X-Tenant-Id ヘッダを検証し user_tenants の ACTIVE メンバーシップ確認後 TenantContext に設定
4. Hibernate Filter 定義 — tenant/package-info.java に @FilterDef(name="tenantFilter") を追加。Task エンティティに @Filter を付与
5. TenantFilterAspect — spring-boot-starter-aop を追加し、Repository メソッドを @Before でインターセプトして Hibernate Filter を有効化
6. クロステナント漏洩テスト — 2テナントのタスクを作成し、フィルタ有効時に片方のテナントのタスクのみ返ることを検証

補足

• spring-boot-starter-aop の追加はフレームワーク組み込みのAOP有効化。設計規約が「Filter vs Spring AOP の選択は今後の ADR で決定予定」と言及しており、N5 実装に必要な基盤として採用
• TenantContextFilter は @Component にせず SecurityConfig 内で Bean 化して二重登録を回避