docs(review): 정리 라운드 확인 리뷰 결과와 남은 것을 기록한다

문제: 마지막 정리 커밋(f40c03c6)이 새 결함을 만들었는지 확인해야 리뷰·
수정 반복을 끝낼 수 있다.

방법: 리뷰어 1명이 그 커밋 전체를 영역별로 봤다. Important 0, 회귀 0,
Minor 7. 재리뷰 README 11.1절 결정대로 반복을 끝내고 Minor 7건과
소유자 일(Gitea Actions·runner, PR·병합, 기본값 결정 확인)을 13절에
남겼다.

위험·한계: Minor 7건은 고치지 않았다. 그중 새 ArchUnit 규칙이 인터페이스로
주입한 시스템 호출자를 못 보는 것과 문서의 반대 서술은 같은 leaf 안에서만
생긴다.

검증: 리뷰 문서만 바뀐다. 리뷰어 탐침은 round4/review.md 범위 절.

Refs: docs/reviews/2026-11-03-rereview/README.md 13절
This commit is contained in:
DongHyeonka
2026-11-04 03:18:16 +09:00
parent f40c03c6d3
commit c2e5551054
2 changed files with 260 additions and 0 deletions
@@ -238,3 +238,25 @@ Minor 19건 중 동작에 닿는 것:
| `scripts/verify-compose-profile-contracts.sh` | rc=0, 18 lane | — | 8.31 |
다음: 이 커밋만 보는 확인 리뷰 1회. Important가 나오면 그것만 고치고, Minor는 남은 것으로 기록한다(11.1절).
## 13. r6 확인 리뷰와 종료 (2026-11-04)
정리 커밋 `f40c03c6` 전체를 리뷰어 1명이 4개 영역으로 나눠 봤다([round4/review.md](round4/review.md)). Critical 0, **Important 0**, 회귀 0, Minor 7. 3차 확인 리뷰 Minor 19건 중 18건 닫힘, RR3-04-03은 결정으로 닫힘. 리뷰어가 확인한 것: 동결 목록에 더한 5개 파일이 main `01a8a2a70`과 같은 blob, 새 ArchUnit 규칙 탐침 5개, 잠금 대기 검사기 입력 16개.
11.1절 결정대로 리뷰·수정 반복을 여기서 끝낸다. 아래 Minor 7건은 고치지 않고 남긴다.
| ID | 내용 | 영향 |
|---|---|---|
| RR4-01-01 | `USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS`는 controller가 시스템 호출자를 인터페이스·`Runnable`로 주입받으면 못 본다. 문서는 `ObjectProvider`를 못 잡는다고 적었지만 실제로는 잡는다 | 같은 leaf 안에서만 생기는 경로(leaf 사이는 의존 방향 게이트가 막는다). 문서 문장 정정 필요 |
| RR4-01-02 | 웹 타입을 쓰는 `@Configuration`이 handler를 bean으로 등록하면 사용자 전송으로 잡힌다(거짓 양성) | 빌드가 실패하는 쪽. 설정을 나누면 된다 |
| RR4-02-01 | 검사기가 Flyway가 스스로 트랜잭션 밖에서 돌리는 문장을 모른다(`VACUUM FULL` + `SET LOCAL`이 통과) | 그런 마이그레이션은 Flyway에서 실패하므로 운영 잠금까지는 안 간다 |
| RR4-03-01 | watchdog RED 테스트가 공용 풀 병렬도 1인 머신에서는 옛 코드도 통과시킨다 | 이 환경(병렬도 > 1)에서는 RED가 실제로 실패했다 |
| RR4-03-02 | runbook의 Redis 기록 삭제가 "확인 뒤 지우기" 두 명령이다(사이에 상태가 바뀔 수 있음) | 운영자가 수동으로 쓰는 절차. 원자 스크립트로 바꾸면 닫힌다 |
| RR4-03-03 | (이전부터) gRPC는 회복 필요 실패를 로그에 남기지 않아 digest 찾기를 따라 할 수 없다 | gRPC는 optional 빌드 |
| RR4-03-04 | watchdog 스레드는 한 번 생기면 프로세스 끝까지 남는다. 수명이 Javadoc에 없다 | 데몬 스레드 하나 |
### 13.1 이 리뷰 전체에서 남은 것
- **소유자 일**: Gitea repo의 Actions와 runner를 켠다(`has_actions: false` — workflow가 한 번도 돈 적 없다). 브랜치 `refactor/maturity-review-2026-11`의 PR·main 병합을 정한다(아직 PR 없음). 기본값으로 정한 결정을 확인한다: 4·9.1·10·12절 "결정" 칸 — 특히 lease 뒤 늦게 끝난 첫 시도의 결과를 버리는 것, workflow 명령에 `working-directory`가 필요해진 것, `failure-retention ≥ replay-ttl` 기동 검사를 넣지 않은 것.
- **게이트 밖**: `spotbugsTestFixtures`는 `01a8a2a70`부터 실패하던 task이고, 잠금 대기 검사기의 정규식 경고가 15건이다(입력은 저장소 마이그레이션 파일뿐).
- **Minor**: 위 7건.
@@ -0,0 +1,238 @@
# r6 확인 리뷰 (2026-11-04)
대상: 커밋 `f40c03c6`(3차 확인 리뷰 Minor 19건 수정), Base `339cf8fd`. 리뷰어 1명이 네 영역을 나눠 직접 봤다(하위 에이전트 없음).
발견 ID는 `RR4-<영역>-<순번>`이다. 영역 번호: 01 core·inbound, 02 persistence, 03 outbound·멱등성, 04 bootstrap·build.
## 범위
### 본 pathspec
| 영역 | pathspec |
| --- | --- |
| 01 core·inbound | `src/application-core src/adapter/inbound src/composition/service-runtime src/app-bootstrap/src/architectureTest docs/manual/07-authorization.md docs/fileserver/operations.md` (+ `src/shared-contract`의 `OperationalError` 한 줄) |
| 02 persistence | `src/adapter/outbound/persistence-jpa src/sample-portfolio src/grpc docs/jpa docs/runbooks/migration-failed.md docs/manual/04-persistence.md` (+ `docs/runbooks/outbox-dead-letter.md`) |
| 03 outbound·멱등성 | `src/adapter/outbound/httpclient src/adapter/outbound/cache-redis src/application-core/.../idempotency docs/runbooks/idempotency-unavailable.md docs/web/http-contract.md docs/manual/05-idempotency.md` (+ `docs/httpclient`, `docs/registries/env-keys.yaml` 해당 행, `src/.env.example`, `src/composition/idempotency/README.md`, redis-runtime testFixtures의 `InMemorySemanticRedisCommands`) |
| 04 bootstrap·build | `src/adapter/outbound/support src/app-bootstrap src/build-logic src/adapter/outbound/redis-sdk docs/upgrade/2026-11-maturity-review.md` (+ `infra/redis-sdk/acl/README.md`) |
요구사항은 `docs/reviews/2026-11-03-rereview/README.md` 11·11.1·12절과 `round3/01~04-*.md`의 "고치는 법"으로 맞춰 봤다.
### 불러온 스킬과 적용한 기준
| 스킬 | 적용한 기준 | 본 것 |
| --- | --- | --- |
| `superpowers:requesting-code-review` | 리뷰어 템플릿: 계획 대비 구현, Strengths·심각도별 Issues·Assessment, Declined to judge, 읽기 전용, 하위 에이전트 금지 | 19건 각각을 "고치는 법"과 대조했다. 이 문서 양식이 그 템플릿이다 |
| `clean-architecture` | Dependency Rule(사용자 전송 → 권한 없는 쓰기 방향 금지), "Main(조립 설정)은 바깥의 plugin" | 새 규칙 `USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS`가 조립 설정을 사용자 전송으로 잘못 세는 경우(RR4-01-02), 의존 방향이 인터페이스로 뒤집히면 규칙이 못 보는 경우(RR4-01-01) |
| `security-and-hardening` | 인가 경계(사용자 요청이 권한 없는 쓰기에 닿지 않음), "민감 데이터를 로그에 싣지 않는다", 파생 경로의 파괴적 조작은 소유 증거를 먼저 읽는다 | scope digest가 HMAC 값이고 응답에는 고정 문구만 나가는지, runbook의 삭제 명령이 상태를 확인하고 지우는지(RR4-03-02), `fixture-` 비밀 검사 문서 경로(RR3-04-03) |
| `jpa-patterns` | 마이그레이션은 Flyway가 맡고 추가형으로, 양방향 연관은 한쪽에서만 | 잠금 대기 검사기 목록·상한 판정·`.sql.conf`, 동결 목록에 더한 5개 파일, 연관 규칙 메시지 |
| `performance-optimization` | 측정 전후 비교, 개선을 지키는 회귀 장치가 실제로 회귀를 잡는가 | watchdog RED 테스트가 공용 풀 병렬도 1(2 vCPU)에서는 옛 코드도 통과시킴을 측정(RR4-03-01), read당 비용 주장은 다시 재지 않았다 |
| `ci-cd-and-automation` | 게이트를 조용히 건너뛰지 못하게, 검사가 약해지지 않게 | 붙여 쓴 `-x`·`-p` 해석, `EnvContractVerifier` 합치기 뒤 빈 prefix가 이제 실패하는지(전보다 강해짐) |
### 실행한 명령과 결과
1. `git rev-parse 01a8a2a70:<path>` 대 `f40c03c6:<path>` — 동결 목록에 더한 5개 파일(`jpa/idempotency/V1`, `postgresql/V11`·`V12`, `jpa/notification-platform/V3`, `messaging/V1003`)의 blob이 main과 모두 같다.
2. `javap -c` ArchUnit 1.3.0 `TransitiveDependencyCondition` — 규칙 대상 클래스(사용자 전송)를 경로 중간에서 건너뛰고(`getDirectDependencyTargetsOutsideOfAnalyzedClasses`), 대신 그 클래스 자신을 따로 검사한다. 그래서 경로의 마지막 사용자 전송에서 위반이 잡히고 이 필터로 생기는 거짓 음성은 없다.
3. 따로 만든 worktree(`f40c03c6`)에 탐침 fixture 7개와 테스트 1개를 넣고
`flock … ./gradlew :app-bootstrap:architectureTest --tests '*Rr4ProbeTest*' --offline -x spotlessCheck -x spotlessJavaCheck` → rc=0, 25초. 결과:
| 탐침 | 위반 |
| --- | --- |
| controller가 `@SystemCaller` 작업을 자기 인터페이스 타입으로 주입받아 호출 | **없음** (거짓 음성) |
| controller가 `@Qualifier` `Runnable`로 주입받아 호출 | **없음** (거짓 음성) |
| controller가 `ObjectProvider<구체 handler>`로 꺼내 호출 | 있음 (문서는 "못 잡는다"고 적음) |
| `@Configuration`이 handler bean과 `HandlerInterceptor` bean을 함께 등록 | **있음** (거짓 양성) |
| `@Configuration`이 handler bean과 controller bean을 함께 등록 | **있음** (거짓 양성) |
4. `LockWaitMigrationInspector`·`MigrationResource`를 `javac`로 컴파일해 입력 16개를 돌렸다. `SET LOCAL lock_timeout = '5s'; VACUUM FULL poster;` → `[]`(상한 있음으로 판정), `REINDEX (CONCURRENTLY) TABLE poster;` → 거부, `GRANT SELECT, REFERENCES ON TABLE poster TO r;` → `references on` 거부, `.sql.conf`의 `executeInTransaction=FALSE` → 트랜잭션 안으로 판정. 나머지(`'0.5s'`, `'1min'`, 주석 안의 `lock_timeout = 0`, `REFERENCES public.parent`, 따옴표 표 이름)는 기대대로였다.
5. JDK `CompletableFuture.delayedExecutor` 공용 풀 포화 탐침 — 병렬도 21: 5,997 ms(공용 풀 worker), 병렬도 3: 6,000 ms, **병렬도 1: 302 ms(새 스레드 `Thread-1`)**.
6. 끝나고 `git worktree remove --force`로 탐침 worktree를 지웠다. 이 체크아웃은 바꾸지 않았다(이 문서만 새로 씀).
### 못 본 것
- 전체 게이트는 다시 돌리지 않았다(README 12.1절 결과를 그대로 둔다).
- runbook의 Redis·PostgreSQL 명령(`HMGET`·`DEL`·`DELETE … status = 'ABANDONED'`, `pg_locks` 조회)을 실 서버에서 직접 실행하지 않았다. 코드와 스키마(`V1__expand_owner_safe_v2.sql:48-81`)로만 맞춰 봤다.
- gRPC ledger IT와 실 PG lane은 돌리지 않았다.
- `docs/reviews/2026-11-03-rereview/README.md` 12절 본문은 요구사항으로만 읽고 리뷰 대상으로 보지 않았다.
## Strengths
- `ApplicationBoundaryArchitectureTest.java:564-566` — 표시 검사 대상이 `ARE_SYSTEM_CALLERS`로 바뀌어, 첫 규칙이 면제하는 집합과 둘째 규칙이 검사하는 집합이 같아졌다.
- `ApplicationBoundaryArchitectureTest.java:592-605` + `ArchitectureViolationFixtureTest` — 위반 fixture(직접·중간 클래스·중첩 endpoint·JAX-RS)와 허용 fixture(`SystemCallerHandlerRegistrationFixture`)가 함께 있다. 규칙이 너무 넓어지면 허용 fixture가 깨진다.
- `ReadIdleInputStream.java:158-171` — close와 예약이 각자 volatile을 쓰고 상대 값을 읽어, 둘 중 하나는 반드시 남은 wake를 취소한다. `setRemoveOnCancelPolicy(true)`(`:90-101`)로 취소한 wake가 큐에서 바로 빠지고, 테스트 두 개가 큐가 빈 것을 직접 본다.
- `MigrationLockWaitTest.java:70-99` — 동결 목록을 두 방향(`isSubsetOf`, `containsAll`)으로 검사한다. 더한 5개 파일은 main과 blob이 같다(명령 1).
- `VersionedMigrationFiles.java:25` — 운영 tree와 sample이 버전 정의 하나를 쓴다.
- `StartupRuleRunner.java:115-124` — 비밀 목록을 모든 프로필에서 먼저 만들고, 다른 bean이 생기면 이름을 대며 실패한다. 순서 변경이 다른 bean을 조용히 앞당길 길이 없다.
- `EnvContractVerifier.java:176-193` — 계산이 하나가 됐고, typed prefix 아래 선언이 하나도 없으면 실패한다. 옛 태스크는 빈 metadata 파일을 써서 이 경우를 조용히 통과시켰다. 검사는 약해지지 않고 강해졌다.
- `IdempotencyExecutor.java:368-371` — 회복 필요 예외를 만드는 곳이 하나라 모든 경로가 digest를 싣는다. digest는 HMAC 값이고(`IdempotencyScopeDigest.java:6-11`), 응답은 고정 문구다(`GlobalExceptionHandler.java:187-200`, `GrpcStatusMapper.java:73`).
- `docs/runbooks/idempotency-unavailable.md:90-96` — PostgreSQL 삭제가 `status = 'ABANDONED'`를 조건에 넣은 한 문장이라 원자적이다.
- `IdempotencyStoreContract.java:384` — inspect lease를 두 저장소에 같은 단언으로 건다. Redis는 INSPECT가 `leaseUntil`을 돌려준다(`IdempotencyScripts.java:279`).
## 발견 재확인 표
| ID | 상태 | 근거 |
| --- | --- | --- |
| RR3-01-01 | 닫힘 | 고치는 법 1~3 모두: `ApplicationBoundaryArchitectureTest.java:566`(`that(ARE_SYSTEM_CALLERS)`), 새 규칙 `:592-605`, fixture `ArchitectureViolationFixtureTest`(직접·중간 클래스·중첩·허용). 남은 빈틈은 RR4-01-01·02(이 수정이 만든 규칙의 경계) |
| RR3-01-02 | 닫힘 | `:466-469`(목록 방식 주석), `:482-483`(`jakarta.ws.rs..`·`graphql..`), 매뉴얼 07 `:106-110`, messaging README `:117-120`. `graphql..` fixture는 없다(README 12절에 기록) |
| RR3-01-03 | 닫힘 | `docs/fileserver/operations.md:188`(`0, held`), `:173-174`(행 모양), `:136-137`(newest-first 서술) |
| RR3-01-04 | 닫힘 | 매뉴얼 07 `:85-97`(정본 표), `:128-130`, `src/application-core/CLAUDE.md:205-210`, 업그레이드 안내 B-16, `PermissionEnforcementGuard.java:35-41` |
| RR3-02-01 | 닫힘 | 목록 `LockWaitMigrationInspector.java:71-101`, 0·`DEFAULT`·`RESET` `:203-212`, `.sql.conf` `:158-164`, `IF NOT EXISTS` `:67`, 가이드 `docs/jpa/migration-guide.md:48-66`. 새 항목 `VACUUM FULL`의 판정 빈틈은 RR4-02-01 |
| RR3-02-02 | 닫힘 | `docs/runbooks/migration-failed.md:47-60`, `docs/runbooks/outbox-dead-letter.md:132-142`(`pg_locks` + `granted`, `query` 주의) |
| RR3-02-03 | 닫힘 | `VersionedMigrationFiles.java:25`, `MigrationTrees.java:52-62`, `SampleMigrationLockWaitTest.java:35`, `VersionedMigrationFilesTest`. gRPC는 정규식 한 벌을 따로 둔다(`GrpcOperationLedgerMigrations.java:38`, README 12절에 이유 기록) |
| RR3-02-04 | 닫힘 | `GrpcOperationLedgerMigrations.java:34-42`(디스크 tree), `GrpcOperationLedgerMigrationLockWaitIT.java:60-65`(V001 뒤 전체) |
| RR3-02-05 | 닫힘 | `SingleSidedAssociationCondition.java:142-165`(`Storage`로 저장 위치 판정), `:190-216`, 테스트 2건(`JpaArchitectureRulesTest`) |
| RR3-03-01 | 닫힘 | `ReadIdleInputStream.java:90-101`, `:158-171`, `:217-220`. RED 테스트의 판별력 빈틈은 RR4-03-01, 스레드 수명은 RR4-03-04 |
| RR3-03-02 | 닫힘 | `docs/web/http-contract.md:125-137`, `docs/manual/05-idempotency.md:60-63`, `env-keys.yaml` 해당 행 주석, `OperationalError.java:50-51`. 기동 검사는 소유자 결정으로 넣지 않음 |
| RR3-03-03 | 닫힘 | (a) runbook `:20-25` (b) `IdempotencyExecutor.java:368-371` + 테스트 3경로 (c) runbook `:40-70`, `:79-101` |
| RR3-03-04 | 닫힘 | `src/adapter/outbound/httpclient/README.md:45-46`, `docs/httpclient/configuration-reference.md:106-110`, `src/application-core/CLAUDE.md:274-276` |
| RR3-03-05 | 닫힘 | `IdempotencyScripts.java:279`, `RedisIdempotencyStoreAdapter.java:364-373`, 계약 `IdempotencyStoreContract.java:384`, fake `InMemorySemanticRedisCommands` |
| RR3-04-01 | 닫힘 | `StartupRuleRunner.java:115-124`, 테스트 `StartupRuleRunnerTest.java:249`(인터페이스 타입 `@Value`)와 바로 아래(규칙 없이 앞당김), B-15 문구 |
| RR3-04-02 | 닫힘 | `WorkflowGradleInvocations.java:619-624`, 테스트 `WorkflowGradleInvocationsTest.java:231`, `:247` |
| RR3-04-03 | 결정으로 닫힘 | 코드 수정은 새 의존 edge가 필요해 하지 않음(README 12절). 조립 쪽 `static RequiredProductionSecrets` 방법을 `RedisSdkComposition.java:17-35`, redis-sdk README `:43-55`, ACL README, `SecretSourceValidator.java:170-174`, B-14에 적음. Javadoc 예시의 계정 이름도 ACL 파일(`ca-skeleton-admin-readonly`)과 맞춤 |
| RR3-04-04 | 닫힘 | `EnvContractVerifier.java:176-193`(classpath 한 계산), 테스트 `EnvContractVerifierTest.java:68`, `:375` |
| RR3-04-05 | 닫힘 | `src/sample-portfolio/src/main/resources/application.yml:220-222` |
회귀로 판정한 발견: 없음.
## Issues
### Critical (Must Fix)
없음.
### Important (Should Fix)
없음.
### Minor (Nice to Have)
#### RR4-01-01 · 새 규칙은 인터페이스 타입으로 주입한 시스템 호출자를 못 본다 — 문서는 보이지 않는 경로를 반대로 적었다
- **위치**: `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ApplicationBoundaryArchitectureTest.java:581-605`,
`src/application-core/src/main/java/dev/caskeleton/application/security/SystemCaller.java:26-27`,
`docs/manual/07-authorization.md:75`, `:104`, `:112-113`.
- **무엇이 틀렸나**:
- 규칙은 사용자 전송에서 `@SystemCaller` 클래스로 가는 의존 경로를 찾는다.
- controller가 작업을 그 작업의 인터페이스(자기 인터페이스, `Runnable`, `MessageHandler<T>`)로 주입받으면 경로가 없다. 의존은 작업 → 인터페이스 방향이기 때문이다. 탐침 두 개가 위반 없이 통과했다(범위 명령 3).
- 문서 세 곳은 못 보는 경로로 `getBean`과 `ObjectProvider`를 든다. 그런데 `ObjectProvider<구체 handler>`는 타입 인자 의존으로 잡힌다(탐침). 못 보는 진짜 경로(인터페이스·상위 타입 주입, 문자열 이름 `getBean`)는 적혀 있지 않다.
- 매뉴얼 흐름도 `:75`는 "빌드 실패, 중간 클래스를 거쳐도"라고 적는다.
- **왜 중요한가**:
- 발생 조건: 예약 작업과 controller가 같은 leaf에 있고(매뉴얼 07 `:94`가 "놓이기 쉽다"고 적은 경우), "지금 실행" endpoint가 작업을 인터페이스로 받는다. Spring에서 인터페이스 주입은 흔한 습관이다.
- 영향: 인증만 된 사용자가 권한 검사 없는 쓰기를 부른다. 빌드는 신호가 없고, 문서는 이 모양을 잡는다고 읽힌다.
- Minor로 둔 이유(경계): 원 발견 RR3-01-01과 같은 조건(같은 leaf)에 인터페이스 주입까지 겹쳐야 한다. 매뉴얼은 사용자용 실행을 `@RequiresPermission` 유스케이스로 따로 만들라고 적는다. endpoint는 인증을 요구한다.
- **고치는 법**:
1. 최소: 세 문서의 "못 보는 것"을 "인터페이스·상위 타입으로 주입받거나 이름으로 `getBean`한 시스템 호출자"로 고친다. `ObjectProvider` 예시는 지우거나 "구체 타입이면 잡힌다"로 고친다. 흐름도 `:75`에 같은 단서를 단다.
2. 규칙을 넓히려면: 대상 술어를 "`@SystemCaller` 클래스, 또는 `@SystemCaller` 클래스만 구현하는 프로젝트 인터페이스"로 넓힌다. `Runnable`·`MessageHandler` 같은 공용 인터페이스는 이 방법으로 막을 수 없으니 1은 어느 쪽이든 필요하다.
3. 탐침 두 개(자기 인터페이스, `Runnable`)를 허용·위반 어느 쪽인지 정한 fixture로 남긴다.
- **가이드 심각도·우선순위**: Low · P3 (경계: 같은 leaf 조건이 서면 Medium)
- **증거**: E2 — worktree 탐침 테스트(범위 명령 3). 통제: 구체 타입 경로 M3, 인터페이스 경로 M1(문서도 틀림).
#### RR4-01-02 · 웹 타입을 하나라도 쓰는 조립 설정이 handler를 등록하면 "사용자 전송"으로 잡힌다 (거짓 양성)
- **위치**: `ApplicationBoundaryArchitectureTest.java:492-506`(`ARE_USER_TRANSPORTS`), `docs/manual/07-authorization.md:104`
("그래서 handler를 bean으로 등록하는 `@Configuration`은 걸리지 않는다"),
`src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/allowed/adapter/inbound/messaging/SystemCallerHandlerRegistrationFixture.java:5-9`.
- **무엇이 틀렸나**:
- `ARE_USER_TRANSPORTS`는 "사용자 전송 타입에 직접 의존하는 클래스"다. 그 타입에는 `org.springframework.web..` 전체와 `..adapter.inbound.web..` 패키지의 모든 클래스가 들어간다.
- 그래서 handler bean을 등록하는 `@Configuration`이 `HandlerInterceptor`·`WebMvcConfigurer` bean을 함께 만들거나 controller bean을 함께 등록하면 사용자 전송이 된다. 그 설정은 handler에 직접 의존하므로 실패한다. 탐침 두 개가 모두 위반이었다(범위 명령 3).
- 허용 fixture는 웹 타입이 하나도 없는 설정만 본다. 매뉴얼 `:104`는 조건 없이 "걸리지 않는다"고 적는다.
- **왜 중요한가**:
- 발생 조건: 서비스가 feature 설정 클래스 하나에 웹 쪽 bean과 메시지 handler bean을 같이 둔다. 매뉴얼 09 「소비」 4단계 예시가 "이 leaf의 설정 클래스"에 handler를 등록하라고 적어 이 모양을 부른다.
- 영향: 빌드가 실패하고 메시지는 "사용자 요청이 들어오는 클래스가 시스템 호출자에 닿는다"고 말한다. 실제로는 그런 경로가 없다. 권한 구멍은 아니다(실패 쪽으로 틀린다). 개발자가 원인을 찾느라 시간을 쓰고, 규칙을 믿지 않게 된다.
- **고치는 법**: 하나를 고른다.
- `ARE_USER_TRANSPORTS`에서 `@Configuration`·`@AutoConfiguration` 클래스를 뺀다. 조립 설정은 전송이 아니라 Main 쪽이다. 대신 설정이 controller를 `new`로 만들어 넘기는 길은 controller 자신이 검사받는지 확인한다(controller는 패키지로 이미 대상이다).
- 또는 "타입에 의존"을 endpoint 표시(`@Controller`, `@RestController`, `@RequestMapping` 계열, `@MessageMapping`, `@Path`, gRPC `BindableService`)로 좁힌다.
- 어느 쪽도 하지 않으면 매뉴얼 `:104`에 "웹 bean과 handler bean은 다른 설정 클래스에 둔다"를 적는다.
- 탐침의 두 모양을 허용 fixture로 남긴다.
- **가이드 심각도·우선순위**: Low · P3
- **증거**: E2 — worktree 탐침 테스트(범위 명령 3).
#### RR4-02-01 · 검사기가 Flyway가 스스로 트랜잭션 밖에서 돌리는 문장을 모른다 — 새로 넣은 `VACUUM FULL`은 `SET LOCAL`과 함께 쓰면 통과한다
- **위치**: `src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/migration/LockWaitMigrationInspector.java:89-92`(`VACUUM FULL`),
`:80-83`(`REINDEX`), `:93`(`REFERENCES`), `:122-123`·`:158-164`(`.sql.conf`만 읽음), `docs/jpa/migration-guide.md:48-52`.
- **무엇이 틀렸나**:
- 검사기는 `.sql.conf`의 `executeInTransaction=false`만 "트랜잭션 밖"으로 친다.
- PostgreSQL에서 `VACUUM`은 트랜잭션 안에서 돌 수 없다. Flyway는 이런 문장을 스스로 알아보고 마이그레이션을 트랜잭션 밖에서 돌리거나(`mixed=true`), 다른 문장과 섞이면 거부한다(기본 `mixed=false`).
- 그래서 `SET LOCAL lock_timeout = '5s'; VACUUM FULL t;`는 검사기에서 `[]`(상한 있음)이다(범위 명령 4). 실제로는 상한이 걸리지 않는다. `SET LOCAL`이 없으면 거부하고, 거부 메시지가 시키는 대로 `SET LOCAL`을 넣으면 통과하지만 Flyway가 받지 않는 파일이 된다. 이 항목은 맞게 통과할 길이 없다.
- 같은 계열의 작은 오판: PG14 문법 `REINDEX (CONCURRENTLY) TABLE t`를 비동시로 거부한다. `GRANT … REFERENCES ON TABLE t`를 `references on`으로 거부한다. `executeInTransaction=FALSE`(대문자)를 트랜잭션 안으로 본다(Flyway가 대소문자를 가리는지는 확인하지 않았다).
- **왜 중요한가**:
- 기본 설정(`mixed=false`)에서는 배포 때 Flyway가 그 파일을 거부한다. 운영 중단이 아니라 실패한 배포다. `mixed=true`를 켠 서비스에서만 상한 없는 `ACCESS EXCLUSIVE` 대기가 된다. 템플릿은 `mixed`를 켜지 않는다(grep).
- 나머지 셋은 대부분 거부 쪽 오판이라 피해가 작다.
- **고치는 법**: 트랜잭션 밖에서만 도는 문장(`VACUUM`, `… CONCURRENTLY`, `REINDEX (CONCURRENTLY…)`)이 하나라도 있으면 `.sql.conf`와 같게 "트랜잭션 밖"으로 판정한다. `VACUUM FULL`은 "마이그레이션에 두지 않는다, 운영 절차로 한다"는 문장으로 거부한다. `REINDEX` 정규식의 괄호 옵션에서 `concurrently`를 읽는다. 가이드 `:48-52`에 "Flyway가 스스로 트랜잭션 밖에서 돌리는 문장"을 적는다.
- **가이드 심각도·우선순위**: Low · P3
- **증거**: E2 — 검사기를 그대로 컴파일해 입력 16개를 돌렸다(범위 명령 4). Flyway의 non-transactional 판정은 E0(문서·지식), 실행하지 않았다.
#### RR4-03-01 · watchdog RED 테스트는 공용 풀 병렬도가 1인 머신에서 옛 코드도 통과시킨다
- **위치**: `src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/jdk/ReadIdleInputStreamTest.java:74-107`
(`aStalledReadTimesOutOnTimeWhileTheCommonPoolIsBlocked`, `:82`의 `getCommonPoolParallelism()`).
- **무엇이 틀렸나**:
- 테스트는 공용 `ForkJoinPool`을 막고 read-idle이 제때 나는지 본다. 옛 코드(`CompletableFuture.delayedExecutor`)로 돌아가는 회귀를 잡으려는 테스트다.
- JDK는 공용 풀 병렬도가 1 이하이면 `delayedExecutor`의 작업을 공용 풀이 아니라 매번 새 스레드에서 돌린다. 그래서 그 환경에서는 옛 코드도 제때 깨어나 테스트가 통과한다. 탐침: 병렬도 1에서 302 ms(`Thread-1`), 병렬도 3에서 6,000 ms(범위 명령 5).
- 병렬도 1은 CPU 2개 머신이다. workflow는 `ubuntu-latest`다. private 저장소의 기본 runner는 2 vCPU라 CI에서 이 테스트가 회귀를 못 잡는다.
- **왜 중요한가**: 고친 동작(전용 스레드)은 맞다. 그러나 이 테스트가 지키는 회귀는 CI 머신 크기에 따라 보이거나 안 보인다. 개발 머신(병렬도 21)에서는 잡힌다. 원 결함이 Low라서 이 빈틈도 Low다.
- **고치는 법**: 머신과 무관한 단언 하나를 더한다. 예: 막힌 read를 깨운 스레드 이름이 `httpclient-jdk-read-idle`인지 본다(주입한 `newWatchdogs()` 스케줄러로 확인 가능). 또는 그 테스트 클래스 JVM에 `-Djava.util.concurrent.ForkJoinPool.common.parallelism=4`를 준다.
- **가이드 심각도·우선순위**: Low · P3
- **증거**: E2 — JDK 탐침(범위 명령 5). workflow 파일의 `runs-on: ubuntu-latest` 확인. 저장소 공개 여부는 확인하지 않았다.
#### RR4-03-02 · Redis 기록 삭제가 "확인한 뒤 지우기" 두 명령이다
- **위치**: `docs/runbooks/idempotency-unavailable.md:86-88`.
- **무엇이 틀렸나**: `HMGET <key> state`로 `ABANDONED`를 보고 `PTTL`에 몇 분 남았는지 본 뒤 `DEL <key>`를 친다. 두 명령 사이에 key가 만료되고 같은 키의 새 요청이 새 기록(`CLAIMED`·`EXECUTING`)을 만들면 `DEL`이 진행 중인 기록을 지운다. 그 뒤 같은 키의 다음 요청은 작업을 한 번 더 돌린다.
- **왜 중요한가**: runbook은 "몇 분 남았을 때만"이라는 조건으로 이 창을 줄였다. `ABANDONED`는 key가 있는 동안 다른 상태로 바뀌지 않는다(`IdempotencyScripts.java:76-78`). 그래서 현실적 발생 확률은 낮다. PostgreSQL 쪽은 한 문장이라 이 문제가 없다.
- **고치는 법**: Redis도 한 번에 확인하고 지운다.
`EVAL "if redis.call('HGET', KEYS[1], 'state') == 'ABANDONED' then return redis.call('DEL', KEYS[1]) end return 0" 1 <key>` — 결과 1이면 지움, 0이면 상태가 바뀐 것이니 멈춘다.
- **가이드 심각도·우선순위**: Low · P3
- **증거**: E1 — runbook과 Lua 상태 전이 대조.
#### RR4-03-03 · (이전부터) gRPC 전송은 회복 필요 실패를 로그에 남기지 않아, runbook의 digest 찾기를 따라 할 수 없다
- **위치**: `docs/runbooks/idempotency-unavailable.md:40-45`("the web adapter logs …"),
`src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/GrpcExceptionHandlingInterceptor.java`(carrier 실패에 `log` 호출이 없다).
- **무엇이 틀렸나**: runbook의 진단 첫 단계는 web adapter의 ERROR 줄에서 digest를 찾는 것이다. gRPC로 같은 쓰기를 받는 서비스에는 그 줄이 없다. runbook은 gRPC를 언급하지 않는다. README 12절은 "본 것"으로 적었지만 runbook에는 없다.
- **왜 중요한가**: gRPC 운영자가 runbook을 따라 하면 첫 단계에서 막힌다. 클라이언트 쪽 조치(업무 데이터로 확인)는 digest 없이 된다. 이 커밋이 만든 것이 아니다.
- **고치는 법**: runbook에 "gRPC는 이 줄이 없다"를 적거나, gRPC interceptor가 5xx carrier를 web과 같은 형식으로 로그에 남긴다.
- **가이드 심각도·우선순위**: Low · P3 · 이전부터
- **증거**: E1 — interceptor 코드 읽기, runbook 대조.
#### RR4-03-04 · watchdog 스레드는 한 번 생기면 끝나지 않는다 — 수명이 Javadoc에 없다
- **위치**: `src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/jdk/ReadIdleInputStream.java:36-37`, `:90-101`, `:216-221`.
- **무엇이 틀렸나**:
- 실행기는 첫 JDK 스트림을 만들 때(holder 클래스 초기화) 생기고, 스레드는 첫 wake를 예약할 때 생긴다. core 스레드 1개에 timeout이 없어 그 클래스 로더가 살아 있는 동안 끝나지 않는다. 모든 JDK 클라이언트가 이 한 스레드를 같이 쓴다.
- 데몬이라 JVM 종료는 막지 않는다. 그러나 클래스 로더를 버리는 환경(WAR 재배포, 재시작 클래스 로더)에서는 이 스레드가 옛 로더를 붙잡는다. 스레드 context class loader도 처음 예약한 요청 스레드의 것을 물려받는다.
- Javadoc은 "shared by every JDK stream and started with the first"까지만 적는다.
- **왜 중요한가**: 템플릿은 실행 jar로 배포하고 DevTools를 쓰지 않는다(grep). 그래서 지금 피해는 없다. 다른 배포 방식을 쓰는 파생 서비스에서만 누수가 생긴다.
- **고치는 법**: `scheduler.setKeepAliveTime(…)` + `allowCoreThreadTimeOut(true)`로 스트림이 없을 때 스레드가 끝나게 한다. 또는 Javadoc에 "JVM 수명 동안 한 개, 끝나지 않는다"를 적는다.
- **가이드 심각도·우선순위**: Low · P3
- **증거**: E1 — 코드 읽기.
## Declined to judge
- 04 영역에서는 발견이 없다. 붙여 쓴 `-x`·`-p`는 대소문자를 가려 `-P<prop>`와 섞이지 않는다. Gradle 단일 대시 옵션 가운데 `p`·`x`로 시작하는 다른 것이 없다는 것은 Gradle 파서로 전수 확인하지 않았다.
- `EnvContractVerifier`의 새 실패(typed prefix 아래 선언 없음)는 파생 서비스가 redis-runtime leaf를 지우면 `verifyEnvKeys`를 멈춘다. 실패 쪽이고 메시지가 고칠 곳을 말하므로 결함으로 보지 않았다.
- `StartupRuleRunner`가 모든 프로필에서 비밀 목록을 먼저 만드는 것은 non-static 비밀 목록을 쓰던 파생 서비스의 dev·test 기동도 멈춘다. B-15·표 4번 행에 적혀 있어 의도된 변경으로 봤다. 템플릿의 비밀 목록 bean 둘은 모두 `static` 무인자다(`JpaStartupAutoConfiguration.java:163`, `RedisCapabilityConfig.java:91`).
- watchdog이 HTTP/2·TLS에서 `in.close()`를 하다 늦어지면 다른 스트림의 wake도 늦어진다. 측정하지 않았다(2차 리뷰에서도 미판단).
- watchdog 스레드가 처음 예약한 요청 스레드의 `InheritableThreadLocal`을 물려받는다. 그 스레드는 닫기만 하므로 영향은 없다고 보고 판단하지 않았다.
- scope digest가 이제 tracing span의 예외 메시지(`spanErrorRecorder.recordException`)에도 실린다. HMAC 값이라 문제로 보지 않았다.
- `SingleSidedAssociationCondition`이 양쪽 모두 같은 `@JoinTable`을 명시한 쌍을 "두 번 저장"이라고 말할 수 있다. 드문 모양이라 판단하지 않았다.
- gRPC ledger IT의 상대 경로 `Path.of("src/main/resources/…")`와 평평한 `Files.list`는 IDE에서 저장소 루트로 돌리면 실패하고 하위 폴더를 못 본다. Gradle lane에서는 맞게 돈다.
- 새 transitive 규칙의 실행 시간(README의 5.7초)은 전체 run에서 다시 재지 않았다.
- 파생 서비스(tech-log-backend)에 RR4-01-02 모양의 설정이 있는지는 보지 않았다. `@SystemCaller`가 아직 main에 없어 지금은 해당이 없다.
- README 12절에 이미 남은 것으로 적힌 항목(`graphql..` fixture 없음, `spotbugsTestFixtures` ReDoS 경고, `failure-retention ≥ replay-ttl` 기동 검사, `-mx` 같은 짧은 플래그 묶음, RR3-04-03 코드 수정)은 다시 판단하지 않았다.
## 수렴 판단
이 라운드가 만든 새 결함 가운데 Important 이상은 **없다**.
- 새 발견 6건(RR4-01-01·02, RR4-02-01, RR4-03-01·02·04)은 모두 Low다. 넷은 이번 수정이 만든 규칙·검사기·테스트·runbook의 경계이고, 실패 쪽으로 틀리거나 비기본 조건(`mixed=true`, 2 vCPU CI, WAR 재배포)이 겹쳐야 한다.
- RR4-01-01은 경계에 있다. 같은 leaf 조건에 인터페이스 주입이 겹치면 Medium에 닿는다. 원 발견 RR3-01-01과 같은 기준으로 낮은 쪽에 뒀다.
- 이전부터 있던 것 1건(RR4-03-03).
- 회귀 0건. 3차 확인 리뷰 Minor 19건 중 18건 닫힘, 1건(RR3-04-03) 결정으로 닫힘.
11.1절 멈춤 기준대로 다음 수정 라운드는 필요 없다. Minor는 남은 것으로 기록한다.
## Assessment
**Ready to merge? Yes**
새 Critical·Important가 없고 회귀도 없다. Minor 7건(이전부터 1건 포함)은 기록만 하고, 가장 먼저 볼 것은 RR4-01-01의 문서 정정(못 보는 경로를 바르게 적기)이다.