review-followup Wave 3 라운드 3(P28·P29): fileserver use case·file:* 권한, 보안 파일 primitive 공용화, jvm-test-suite

- 결정 32: fileserver transport 연산 21개를 `port.in` use case로, 쓰기·읽기에 `file:*` 권한(소유자·tenant 정책은 유지),
  inbound 서비스 이름 `*UseCase`, port 구현 이름 `<Tech><Port>` 규칙(S2-#13b, 24개)
- 디렉터리 descriptor 파일 primitive를 `adapter:outbound:support`로(S4-lead-2 일부 — fileserver는 번역만),
  persistence-fileserver를 scan·클래스별 조건 대신 명시적 `@Bean` 설정으로(S2-#8a 일부), `FileVerifier`를 adapter로
- 호출자 0인 `poster.image-attached` 이벤트 삭제, SES SDK client를 레지스트리 종료 때 close, fileserver migration V1–V5 고정
- P29: auxiliary 레인 → Gradle `jvm-test-suite`(BUILD-O3-5, build-logic 16,768 → 5,851줄), redis-sdk가 runtime을 api로(P22-new-3)
- 통합: JPA API surface 기준선 재승인(이름 규칙 변경), migration lane에 V19 반영, messaging 통합 테스트가 jar 안 migration 목록 조회(ORCH-new-5)
- P28·P29 에이전트가 세션 재시작으로 중단 — 커밋된 것만 합치고 결과 파일은 오케스트레이터가 확정, S6-#10a는 P30으로

검증: ./gradlew ci verifyDependencyLocks --warning-mode=fail(714 task) · mainCheck architectureCheck verifyPublicPathSnapshot
:app-bootstrap:verifyEnvKeys configContractCheck · :app-bootstrap:integrationTest :sample-portfolio:integrationTest
:sample-portfolio:systemTest integrationCheck · -p build-logic test · -p optional-platforms ci · releaseCheck qualificationBootJar 통과

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
donghyeon-ka
2026-09-29 14:54:06 +09:00
co-authored by Claude Opus 5.5
parent 09e2dd63d6
commit 0579935746
275 changed files with 5838 additions and 3312 deletions
+2 -2
View File
@@ -103,7 +103,7 @@ deterministic writer, Kafka ACK producer, PostgreSQL outbox append/relay는 후
- **존재 이유**: application 유스케이스가 `org.springframework.transaction.annotation.Transactional`
을 import 하지 않고도 트랜잭션 의도를 선언하게 하기 위한 추상화다. 구현(보통
`SpringTransactionPort`)은 persistence adapter 가 Spring `PlatformTransactionManager` 로 제공한다.
`SpringTransaction`)은 persistence adapter 가 Spring `PlatformTransactionManager` 로 제공한다.
application/domain 을 프레임워크-free 로 유지하는 핵심 장치.
- 네 가지 경계:
- `inWrite` — REQUIRED + read-write, `READ_COMMITTED`. command 유스케이스 기본.
@@ -244,7 +244,7 @@ application 계층이 claim·replay·복구 **정책** 을 소유하고, 저장
- 상태: `CLAIMED` / `EXECUTING` / `COMPLETED` / `FAILED_RETRYABLE` / `ABANDONED`(`IdempotencyState`).
- 구현은 provider 하나만 붙는다: `redis`(`adapter:outbound:cache-redis`
`RedisIdempotencyStoreAdapter`) 또는 `postgresql`(`adapter:outbound:persistence-jpa`
`PostgreSqlOwnerSafeIdempotencyStore`). `ca-skeleton.capabilities.idempotency.provider` 로 고르고
`PostgreSqlIdempotencyStore`). `ca-skeleton.capabilities.idempotency.provider` 로 고르고
기본값은 `disabled` 다. store 가 정확히 하나가 아니면 기동을 거부한다.
- **in-memory 프로덕션 구현 금지**. 테스트용 `InMemoryIdempotencyStore` 는 testFixtures 에만 있다.
@@ -5,7 +5,7 @@ import java.util.function.Supplier;
/**
* Outbound port for application-managed transaction boundaries: use cases declare transactional
* intent without importing Spring's {@code @Transactional}. The persistence adapter (typically
* {@code SpringTransactionPort}) implements it over Spring's {@code PlatformTransactionManager}.
* {@code SpringTransaction}) implements it over Spring's {@code PlatformTransactionManager}.
*
* <ul>
* <li>{@link #inWrite(Supplier)} — REQUIRED + read-write, {@code READ_COMMITTED}. Command
@@ -11,8 +11,8 @@ import org.junit.jupiter.api.Test;
* feature-transaction-concurrency-contract D3 / §구현 가이드 1 — isolation vocabulary policy.
*
* <p>This branch owns the {@link Isolation} vocabulary. {@code READ_COMMITTED} is the pinned
* default (every {@code SpringTransactionPort} template pins it explicitly — see {@code
* SpringTransactionPortTest}); {@code REPEATABLE_READ}/{@code SERIALIZABLE} are the explicit opt-in
* default (every {@code SpringTransaction} template pins it explicitly — see {@code
* SpringTransactionTest}); {@code REPEATABLE_READ}/{@code SERIALIZABLE} are the explicit opt-in
* levels for write-heavy / read-consistency use cases; {@code READ_UNCOMMITTED} is forbidden and
* therefore MUST NOT be a DECLARED constant.
*