backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2)

[win2cot]

A-1 (#86 merged) で配置した feature 内 4 層パッケージへ、既存クラスを Move のみ(中身変更なし)で移動する。

N4 (#86) を 4 分割した A-2 スコープ:

• A-1 (backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86): package-info.java + shared Open module(merged 2026-05-30)
• A-2 (本 Issue): 既存 JPA Entity / Security 系クラスの 4 層パッケージへの移動
• B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273): GET /tasks/{id} 4 層実証 + Domain POJO 分離 + 共通例外基底
• C (docs(dev): 新 feature 追加時のテンプレ手順書 docs/dev/feature-template.md 整備 (N4 / C) #274): docs/dev/feature-template.md

やること

1. 既存クラスの 4 層パッケージへの移動(git mv ベース)

scaffold 現状のトップレベル直置きクラスを以下にマップして git mv:

移動元(現在地)	移動先	種別
task/Task.java	task/adapter/persistence/Task.java	JPA Entity(rename しない)
task/Priority.java	task/domain/Priority.java	enum
task/TaskStatus.java	task/domain/TaskStatus.java	enum
task/Visibility.java	task/domain/Visibility.java	enum
security/SecurityConfig.java	security/adapter/web/SecurityConfig.java	Spring Security 設定
security/TasksAuthenticationToken.java	security/adapter/web/TasksAuthenticationToken.java	Authentication トークン
security/TasksJwtAuthenticationConverter.java	security/adapter/web/TasksJwtAuthenticationConverter.java	JWT コンバータ
security/TasksPrincipal.java	security/domain/TasksPrincipal.java	Principal
tenant/Tenant.java	tenant/adapter/persistence/Tenant.java	JPA Entity(rename しない)
tenant/TenantPlan.java	tenant/domain/TenantPlan.java	enum
tenant/TenantStatus.java	tenant/domain/TenantStatus.java	enum
user/User.java	user/adapter/persistence/User.java	JPA Entity(rename しない)
user/UserRepository.java	user/adapter/persistence/UserRepository.java	Spring Data Repository

scaffold 未実装で本 Issue 対象外:

• TaskController / TaskRepository / TaskNotFoundException 等は現状 scaffold に存在しない → B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273) で GET /tasks/{id} 実装と同時に各 4 層パッケージへ新規作成
• task/domain/TaskAuthorizationDomainService.java は既に task/domain/ 配下、本 Issue 対象外(import 修正のみ)

移動に伴う package 宣言修正・他ファイルからの import 修正は不可避(grep-first で漏れチェック)。

対応する test ファイルも同パッケージ階層へ同時 git mv(prod/test 同居の慣例維持、git log --follow で履歴追跡可):

test 移動元	test 移動先
security/SecurityConfigTest.java	security/adapter/web/SecurityConfigTest.java
security/TasksAuthenticationTokenTest.java	security/adapter/web/TasksAuthenticationTokenTest.java
security/TasksJwtAuthenticationConverterTest.java	security/adapter/web/TasksJwtAuthenticationConverterTest.java
security/TasksPrincipalTest.java	security/domain/TasksPrincipalTest.java
task/TaskEntityTest.java	task/adapter/persistence/TaskEntityTest.java
user/UserEntityTest.java	user/adapter/persistence/UserEntityTest.java

task/domain/TaskAuthorizationDomainServiceTest.java は既に task/domain/ 配下、test 位置追従の規則に合致しているため対象外(import 修正のみ)。

2. 変更しないこと

• JPA アノテーション剥離(@Entity を取り除く等)→ B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273)
• Entity 名 rename(Task → TaskJpaEntity)→ B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273)
• 例外基底クラス導入(DomainException 継承)→ B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273)
• メソッドシグネチャ・ロジック変更 → 不可
• テスト内容変更 → 不可(ただしテストファイル位置は対応 prod クラスのパッケージへ追従、git mv のみ)

3. ModularityTests.verify() + 既存全テスト green

• ApplicationModules.verify() が green(feature 内 sub-package 化したのみで破綻しないはず)
• 既存全テスト green(内容変更なし、テストファイル位置は対応 prod クラスのパッケージへ追従)
• import パスが破綻していないか grep + コンパイル + テスト全件で検証

受け入れ条件

• task / security / tenant / user 直下の対象既存クラス 13 件が 4 層パッケージへ移動済
• 元のトップレベル直置きファイル 13 件は完全削除(空 stub も残さない)
• 対応する test 6 件が同パッケージ階層へ追従移動済
• package 宣言・import 修正の漏れなし(コンパイル green)
• ApplicationModules.verify() green
• 既存全テスト green(内容変更なし、テストファイル位置は対応 prod クラスのパッケージへ追従)
• CI green、UT カバレッジ 80%+
• git mv ベース(rename 自動検知 OK、git log --follow で履歴追跡可)

参照

• 前提: backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86 (A-1) merge 済 2026-05-30
• 規約: 設計規約 §1.1
• 関連 Issue: backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86 (blocks 本) / backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273 (B、blocked-by 本) / 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 本 に組み替え済)
• Sub-tracker: [Phase 1 Sprint 0] scaffold ↔ 設計書 v1.4.x 整合実装(2 週間、2026-06-14 〜 06-27) #121 Phase 1 Sprint 0

経緯

• 2026-05-29 Cowork 起票時点では TaskController / TaskRepository / TaskNotFoundException も対象として記載していたが、scaffold 現状未実装と判明(2026-05-30 PR 関連 branch 実態確認)、B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273) スコープへ整理
• 2026-05-30 実装 Claude 起動 → max-turn 超過で停止(prod 13 件移動完遂 / 元ファイル 2 行 stub 残り / test 6 件未移動)→ 人手対応継続

[claude-automation-impl]

実装方針

着手宣言

Issue #272 (A-2) の実装を開始します。

移動対象クラスと移動先

現在地	移動先	種別
task/Task.java	task/adapter/persistence/Task.java	JPA Entity
task/Priority.java	task/domain/Priority.java	Enum
task/TaskStatus.java	task/domain/TaskStatus.java	Enum
task/Visibility.java	task/domain/Visibility.java	Enum
security/SecurityConfig.java	security/adapter/web/SecurityConfig.java	@configuration
security/TasksAuthenticationToken.java	security/adapter/web/TasksAuthenticationToken.java	Spring Security Token
security/TasksJwtAuthenticationConverter.java	security/adapter/web/TasksJwtAuthenticationConverter.java	@component Converter
security/TasksPrincipal.java	security/domain/TasksPrincipal.java	Domain Value Object
tenant/Tenant.java	tenant/adapter/persistence/Tenant.java	JPA Entity
tenant/TenantPlan.java	tenant/domain/TenantPlan.java	Enum
tenant/TenantStatus.java	tenant/domain/TenantStatus.java	Enum
user/User.java	user/adapter/persistence/User.java	JPA Entity
user/UserRepository.java	user/adapter/persistence/UserRepository.java	JPA Repository

方針

• git mv ベースで移動し、git log --follow で履歴追跡可能にする
• 移動後に package 宣言・import を修正
• 既存テストは package を変更せず import を追加/更新して green を維持
• ApplicationModules.verify() + 全テスト green を確認してから PR 作成

---

⚠️ impl workflow が異常終了しました

field	value
state	Impl-Aborted
reason	unknown
run	https://github.com/win2cot/tasks-webapi/actions/runs/26647338155

@win2cot 人手対応をお願いします。

_{signal: claude-automation-cleanup}