backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1)

[win2cot]

A-1 (#86) / A-2 (#272) で整えた 4 層パッケージ上で、GET /api/tasks/{id} 実装の基盤層(shared 例外基底 + JPA Entity / Domain POJO 分離 + Repository ポート)を整備する。

N4 (#86) を 7 分割した B-1 スコープ(2026-05-30 Cowork 3 再分割、B が ~18 ファイル / テスト 5 種類で実装 Claude の単一 PR キャパシティ超過の risk あり):

• A-1 (backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86 merged) / A-2 (backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2) #272 merged): 4 層パッケージ + 既存クラス移動
• B-1 (本 Issue): 基盤(shared/exception + Task POJO/JPA 分離 + Repository ポート) ~8 ファイル
• B-2 (backend: GET /api/tasks/{id} 4 層実装(UseCase + Controller + DTO + 例外) (N4 / B-2) #278): GET /tasks/{id} 4 層実装(UseCase + Controller + DTO + 例外) ~9 ファイル
• B-3 (backend: DB migration created_by/updated_by + 統合 IT + AuthZ test 更新 (N4 / B-3) #279): DB migration created_by/updated_by 列追加 + 統合 IT + AuthZ test 更新 ~3 ファイル
• C (docs(dev): 新 feature 追加時のテンプレ手順書 docs/dev/feature-template.md 整備 (N4 / C) #274): docs/dev/feature-template.md

やること

1. shared/exception/ 配下を新規作成

ファイル	内容
shared/exception/DomainException.java	abstract class DomainException extends RuntimeException、@ResponseStatus 禁止、業務例外基底
shared/exception/package-info.java	@NullMarked

2. task/domain/Task.java(Domain POJO)を新規作成

task/adapter/persistence/Task.java(現 JPA Entity)から JPA アノテーション剥離した POJO を task/domain/ に新規:

• Field: Long id / Long tenantId / String title / String description / Priority priority / TaskStatus status / Visibility visibility / Long assigneeId / LocalDate dueDate / LocalDateTime createdAt / LocalDateTime updatedAt
• @Entity / @Column / @Id 等 JPA 依存禁止、Spring 非依存
• lombok @Getter + all-args constructor、equals/hashCode は id ベース

3. task/adapter/persistence/Task.java を TaskJpaEntity.java に rename

• git mv task/adapter/persistence/Task.java task/adapter/persistence/TaskJpaEntity.java
• クラス宣言 class Task → class TaskJpaEntity
• 既存 TaskEntityTest.java(task/adapter/persistence/ 配下、A-2 で移動済)の Task 参照を TaskJpaEntity に追従
• JPA アノテーション・スキーマ・カラム名は変更しない(rename のみ)

4. task/usecase/TaskRepository.java ポート interface 新規

package xyz.dgz48.tasks.webapi.task.usecase;

import java.util.Optional;
import xyz.dgz48.tasks.webapi.task.domain.Task;

public interface TaskRepository {
  Optional<Task> findByIdAndTenantId(Long id, Long tenantId);
}

B-2 で必要な最小 method のみ。将来追加は別 Issue で。

5. task/adapter/persistence/TaskJpaRepository.java Spring Data Repository 新規

public interface TaskJpaRepository extends JpaRepository<TaskJpaEntity, Long> {
  Optional<TaskJpaEntity> findByIdAndTenantId(Long id, Long tenantId);
}

6. task/adapter/persistence/TaskJpaRepositoryAdapter.java で TaskRepository ポート実装

• @Component
• TaskJpaRepository を constructor inject
• findByIdAndTenantId で Optional<TaskJpaEntity> を Optional<Task> に map
• TaskJpaEntity → Task 変換は private method or static factory

やらないこと(B-1 では対象外)

• GetTaskUseCase / TaskController / TaskExceptionHandler / DTO / TaskNotFoundException / TaskNotViewableException → B-2 (backend: GET /api/tasks/{id} 4 層実装(UseCase + Controller + DTO + 例外) (N4 / B-2) #278)
• DB migration created_by/updated_by 列追加 / 統合 IT / TaskAuthorizationDomainServiceTest 更新 → B-3 (backend: DB migration created_by/updated_by + 統合 IT + AuthZ test 更新 (N4 / B-3) #279)

受け入れ条件

• shared/exception/DomainException.java + package-info.java 配置
• task/domain/Task.java(POJO)新規、JPA 依存なし
• task/adapter/persistence/Task.java → TaskJpaEntity.java rename + クラス宣言追従
• task/usecase/TaskRepository.java ポート(findByIdAndTenantId(Long, Long) のみ)
• task/adapter/persistence/TaskJpaRepository.java(Spring Data)
• task/adapter/persistence/TaskJpaRepositoryAdapter.java でポート実装(JpaEntity → Domain Task 変換含む)
• 既存 TaskEntityTest.java が TaskJpaEntity 名で green
• ./gradlew :webapi:compileJava :webapi:compileTestJava green
• ./gradlew :webapi:test green、ApplicationModules.verify() green
• CI green、UT カバレッジ 80%+

参照

• 前提: backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86 / backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2) #272 merge 済(2026-05-30)
• 規約: 設計規約 §1.1 / ADR-0003
• 関連 Issue: backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86 / backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2) #272 (blocks 本) / backend: GET /api/tasks/{id} 4 層実装(UseCase + Controller + DTO + 例外) (N4 / B-2) #278 (B-2、blocked-by 本) / backend: DB migration created_by/updated_by + 統合 IT + AuthZ test 更新 (N4 / B-3) #279 (B-3) / docs(dev): 新 feature 追加時のテンプレ手順書 docs/dev/feature-template.md 整備 (N4 / C) #274 (C) / docs(spec)+impl: 既存usersテーブル記述補正 + ADR-0006 派生スコープ(users 列追加 + JPA + 匿名化 service)(N8) #90 (N8、blocked-by backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2) #272)
• Sub-tracker: [Phase 1 Sprint 0] scaffold ↔ 設計書 v1.4.x 整合実装(2 週間、2026-06-14 〜 06-27) #121 Phase 1 Sprint 0