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:
co-authored by
Claude Opus 5.5
parent
09e2dd63d6
commit
0579935746
@@ -318,12 +318,12 @@ application-core:
|
||||
+ inTransaction(TransactionRequest, Supplier) : TransactionResult<T>
|
||||
|
||||
adapter:
|
||||
SpringTransactionPort implements PolicyTransactionPort
|
||||
SpringTransaction implements PolicyTransactionPort
|
||||
├─ 레거시 4모드 → 미리 만들어 둔 TransactionTemplate 3개
|
||||
└─ inTransaction → SpringPolicyTransactionPort (package-private 위임체)
|
||||
```
|
||||
|
||||
### 3.1 `SpringTransactionPort` — 레거시 4-mode
|
||||
### 3.1 `SpringTransaction` — 레거시 4-mode
|
||||
|
||||
모드별로 `TransactionTemplate`을 **생성 시점에 하나씩 미리 만들어 둔다.**
|
||||
|
||||
@@ -1627,7 +1627,7 @@ provision하므로 DDL 체크를 건너뛴다.
|
||||
`JdbcLockRegistry(lockRepository, settings.leaseTtl())` — SI 7.0 이후 기본 TTL은 repository
|
||||
setter가 아니라 **registry 생성자**에서 설정한다.
|
||||
|
||||
`LockRegistryDistributedLockAdapter`의 계약:
|
||||
`LockRegistryDistributedLock`의 계약:
|
||||
|
||||
- **D4 — transaction-commit ordering invariant.** 이 어댑터는 트랜잭션 경계를 관리하지 않는다.
|
||||
호출자는 보호된 트랜잭션이 **커밋된 뒤에만** 핸들을 release해야 한다. 커밋 전에 release하면
|
||||
@@ -1670,7 +1670,7 @@ setter가 아니라 **registry 생성자**에서 설정한다.
|
||||
6. **Spring stereotype 없음** — 두 composition root가 `dev.caskeleton.adapter`를
|
||||
component-scan하므로 `@Repository`를 붙이면 선택하지 않은 배포에서도 빈이 된다.
|
||||
|
||||
### 10.1 `PostgreSqlOwnerSafeIdempotencyStore`
|
||||
### 10.1 `PostgreSqlIdempotencyStore`
|
||||
|
||||
`IdempotencyStorePort` 구현. 상태:
|
||||
`CLAIMED → EXECUTING → COMPLETED | FAILED_RETRYABLE | ABANDONED`.
|
||||
@@ -2442,7 +2442,7 @@ audited 엔티티에 대한 `update`가 audit 컬럼을 set하는지 확인한
|
||||
> 통과와 실패 케이스가 한 번도 실행된 적 없는 아키텍처 규칙은 **모양을 알 수 없는 규칙**이고,
|
||||
> production 그래프에는 오늘 audited bulk update가 없어서 그래프만으로는 통과만 보여줄 수 있다.
|
||||
|
||||
`DomainContextAuditContextPort`는 actor를 `DomainContextPropagator`에서 읽고, 빈/blank면
|
||||
`DomainContextAuditContext`는 actor를 `DomainContextPropagator`에서 읽고, 빈/blank면
|
||||
`"system"`으로 떨어뜨린다 — scheduler / Flyway / anonymous 경로에서도 NOT NULL
|
||||
`created_by`/`updated_by`를 항상 만족시키려고. `ACTOR_KEY`를 상수로 격리해서 canonical actor
|
||||
key가 바뀌어도 **정확히 한 클래스**만 손대면 된다.
|
||||
@@ -2690,8 +2690,8 @@ app.fileserver-platform.enabled && transaction-provider != none
|
||||
> 정규식으로 제외하고, 그 제외는 **옳다**: 그게 optional capability를 optional하게 만든다.
|
||||
>
|
||||
> 빠진 건 나머지 절반이다. 이 leaf의 여덟 클래스가 scanned component로 쓰여 있는데 —
|
||||
> `SpringTransactionPort`, `PersistenceExceptionTranslator`, `StandardSqlStateErrorMapping`,
|
||||
> `DomainContextAuditContextPort`, idempotency store와 reaper, outbox store와 reaper —
|
||||
> `SpringTransaction`, `PersistenceExceptionTranslator`, `StandardSqlStateErrorMapping`,
|
||||
> `DomainContextAuditContext`, idempotency store와 reaper, outbox store와 reaper —
|
||||
> 넓은 scan이 그들에게 도달하기를 멈추자 **아무것도 도달하지 않았다.** `@Component`와
|
||||
> `@Repository`가 붙어 있고 **돌고 있는 어떤 애플리케이션에서도 빈이 아니었다**:
|
||||
> 특히 `TransactionPort`는 구현이 전혀 없어서, **트랜잭션을 여는 모든 유스케이스가 열
|
||||
@@ -3296,12 +3296,12 @@ grep -rnE "[0-9]+ ?(개 ?)?-?(leaf|leaves)" docs | grep -v "^docs/superpowers/\|
|
||||
|---|---|
|
||||
| `PostgreSqlIdempotencyStoreConfig` | `@ConditionalOnProperty(ca-skeleton.capabilities.idempotency.provider = postgresql)` |
|
||||
| `IdempotencyReaper` | 동일 |
|
||||
| `OutboxStoreAdapter` | **없음** (`@Repository`만) |
|
||||
| `JpaOutboxStore` | **없음** (`@Repository`만) |
|
||||
| `OutboxReaper` | **없음** (`@Component` + `@Scheduled`) |
|
||||
|
||||
`JpaAdapterComponentsConfig`가 `...persistence.outbox` 패키지를 component scan한다. 따라서
|
||||
`ca-skeleton.persistence-jpa.enabled=true`이면 `ca-skeleton.outbox.enabled=false`여도
|
||||
`OutboxStoreAdapter`와 `OutboxReaper`가 빈이 되고, reaper의 `@Scheduled`가 10분마다
|
||||
`JpaOutboxStore`와 `OutboxReaper`가 빈이 되고, reaper의 `@Scheduled`가 10분마다
|
||||
`delete from outbox_event where status='PUBLISHED' and occurred_at < ?`를 돈다.
|
||||
|
||||
**확인**
|
||||
@@ -3330,7 +3330,7 @@ V1 `OutboxReaper`의 bulk delete가 매 주기 실패한다.** 지금은 V2가 c
|
||||
않았지만, cutover 런북에 "V1 reaper/relay 먼저 끄기"가 명시돼야 한다.
|
||||
|
||||
**제안**
|
||||
- `OutboxStoreAdapter` / `OutboxReaper`에 `@ConditionalOnProperty(prefix="ca-skeleton.outbox",
|
||||
- `JpaOutboxStore` / `OutboxReaper`에 `@ConditionalOnProperty(prefix="ca-skeleton.outbox",
|
||||
name="enabled", havingValue="true")` 추가.
|
||||
- cutover 절차에 V1 writer 비활성화 단계를 명시.
|
||||
|
||||
@@ -3495,7 +3495,7 @@ import하지 않는다** (§11.0 측정).
|
||||
- **`SafeSortMapper.MAX_SORT_TERMS = 4`**: registry에 더 많이 등록할 수 있지만 요청은 4개까지.
|
||||
의도로 보인다.
|
||||
- **`PgRangeCodec.parse("empty")` 거부**: 의도이고 근거가 적혀 있다.
|
||||
- **`SpringTransactionPort`의 non-`@Autowired` 생성자들**: 테스트 전용
|
||||
- **`SpringTransaction`의 non-`@Autowired` 생성자들**: 테스트 전용
|
||||
(`withoutAcquisitionEnvelope`). package-private이라 표면이 넓어지지 않는다.
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user