diff --git a/docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.md b/docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.md new file mode 100644 index 00000000..5010112d --- /dev/null +++ b/docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.md @@ -0,0 +1,221 @@ +# round9 영역 01 — 영속성·메시징·성능 + +- 대상: main `a7e38c10`(2026-11-12). 범위와 방법은 [README](README.md) 「범위」다. +- 발견마다: 출처(리뷰어), 증거 수준, 이전부터/최근 변경, 고칠 묶음(README 「묶음」). 원문의 `파일:줄`은 저장소 루트 기준이다. + +### RR9-01-01 · Medium · inbox TransactionRunner `new TransactionTemplate` timeout 없음 → 유스케이스… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: inbound/messaging `MessagingInboxAutoConfiguration.java:76` — inbox TransactionRunner `new TransactionTemplate` timeout 없음 → 유스케이스 tx.inWrite가 합류해 30초 상한 버림(`SpringTransaction.java:200`). 근거 persistence-jpa/AGENTS.md:138, manual 09:123. 고침: setTimeout(write-timeout) + 테스트. 이전부터. + +### RR9-01-02 · Medium · heartbeat·progress·succeed·fail이 lease_owner=:workerId만 확인, fence 없음. 같은… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: persistence-jpa `DurableOperationJpaRepository.java:121,143,168,194` — heartbeat·progress·succeed·fail이 lease_owner=:workerId만 확인, fence 없음. 같은 workerId 재claim 시 앞 실행이 true. 포트 `DurableOperationStorePort.java:14,57`은 workerId 유일 조건 안 적음. outbox lease_token·알림 lease_fence·reconciliation claim_fence·fileserver claim_token과 갈림. 고침: claimNext가 token 돌려주고 조건에 넣기 or 포트에 유일성 명시 + 계약 케이스. 이전부터. + +### RR9-01-03 · Medium · live_event_log 행 retention 지나도 안 지움, sweepExpired 호출자·스케줄 없음, 문서도 서비스 의무로 안… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: persistence-jpa `JpaLiveEventReplay.java:142` — live_event_log 행 retention 지나도 안 지움, sweepExpired 호출자·스케줄 없음, 문서도 서비스 의무로 안 적음(inbox는 09장 179줄에 적음). 고침: reaper 조립 or 문서 의무. 이전부터. + +### RR9-01-04 · Low · 상한 없는 DELETE 한 문장(outbox는 1000행씩, OutboxEventJpaRepository.java:35-47),… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: persistence-jpa `IdempotencyReaper.java:27-29` — 상한 없는 DELETE 한 문장(outbox는 1000행씩, OutboxEventJpaRepository.java:35-47), expires_at은 DB 시계(IdempotencyClaimGateway.java:90 clock_timestamp())인데 비교는 앱 clock. 고침: 묶음 삭제 + SQL now(). 이전부터. + +### RR9-01-05 · Low · join() 시간 상한 없음,… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10a 발행·발송·캐시 +- 내용: messaging `OutboxMessagePublishAdapter.java:53` — join() 시간 상한 없음, longestAttempt()(PlatformIntegrationEventPublishAdapter.java:93-96) 검사가 실제 대기에 안 걸림 → lease 지나 중복 발행, 종료 대기 약속 깨짐. VerificationCoordinator.java:56은 get(timeout). 고침: orTimeout(longestAttempt) + AMBIGUOUS. 이전부터. + +### RR9-01-06 · Low · Javadoc "enqueue is an upsert"인데 UPDATE 0행이면 INSERT 두 단계, 동시 enqueue 시… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: persistence-fileserver `JpaRecoveryQueue.java:18,43-46` — Javadoc "enqueue is an upsert"인데 UPDATE 0행이면 INSERT 두 단계, 동시 enqueue 시 uq_fs_recovery_open(V2:53) 위반·25P02, DefaultFileReconciliationService.java:242가 그대로 던짐. 고침: INSERT … ON CONFLICT (file_id) WHERE status='PENDING' DO UPDATE. 이전부터. + +### RR9-01-07 · Low · app.lock.wait-time 읽는 곳 없음(lease-ttl 교차 검사로 기동 막기만). README:559… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: persistence-jpa `LockSettings.java:21-41` — app.lock.wait-time 읽는 곳 없음(lease-ttl 교차 검사로 기동 막기만). README:559 "@EnableConfigurationProperties가 바인딩"(실제 StrictSettingsBinder), :536 데코레이터 위치 "컴포지션 루트". 근거 manual 10 기준 3. 이전부터. + +### RR9-01-08 · Low · 408·429를 조건 없이 재시도로 적음, 코드(DefaultRetryEligibilityEngine.java:81-99,… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `docs/httpclient/retry-and-ambiguity.md:53,55` — 408·429를 조건 없이 재시도로 적음, 코드(DefaultRetryEligibilityEngine.java:81-99, RetryEligibilityEngineTest.java:200-207)는 비멱등에서 408 결과모름·429 거부. 이전부터. + +### RR9-01-09 · Low · 주석 "retention has no default on purpose"인데… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: persistence-jpa `JpaAdapterBeansConfig.java:124-125` — 주석 "retention has no default on purpose"인데 persistence-jpa.yml:212·env-keys.yaml:387 기본 1h. 이전부터. + +### RR9-01-10 · Low · Javadoc lane 목록에 lock timeout runbook… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: persistence-jpa postgresqlIntegrationTest `readiness/RunbookSql.java:10-13` — Javadoc lane 목록에 lock timeout runbook lane(PostgreSqlDistributedLockIntegrationTest.java:36,137,162) 빠짐. 이전부터(ba189869). + +### RR9-01-11 · Low · Redis 같은 키 재전송 안 돌린다를 조건 없이 약속, Sentinel·Cluster failover 비동기 복제 손실… + +- 출처: 물결 1 영속성·메시징·성능 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `docs/manual/05-idempotency.md:59` — Redis 같은 키 재전송 안 돌린다를 조건 없이 약속, Sentinel·Cluster failover 비동기 복제 손실 한계(redis-capability-incident.md:145-151) 안 적음. 이전부터. + +### RR9-01-12 · Medium · 회복이 행 잠금 없이 읽고(RecipientDeliveryJpaRepository.java:187-194) requeue 무조건… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: `LeaseRecoveryService.java:113,157-164`, `JpaRecipientDeliveryStore.java:59-71` — 회복이 행 잠금 없이 읽고(RecipientDeliveryJpaRepository.java:187-194) requeue 무조건 read-modify-write, 인스턴스마다 돎(NotificationBackgroundWorkers.java:77) → 완료·재claim 행을 READY로. 고침: state·lease_until·lease_fence 조건부 UPDATE. + +### RR9-01-13 · Medium · UPDATE … WHERE id IN (SELECT … LIMIT), 상태 조건 subquery 안만 → READ COMMITTED 재평가 안… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: `RecipientClaimSql.java:55-68`(EXPIRE_OVERDUE), `InboxItemJpaRepository.java:89-106`(markAllRead) — UPDATE … WHERE id IN (SELECT … LIMIT), 상태 조건 subquery 안만 → READ COMMITTED 재평가 안 함, claim된 행 EXPIRED, archive 행 READ(주석 96-97이 막겠다던 것). 고침: 바깥 WHERE 상태 조건 or FOR UPDATE SKIP LOCKED. + +### RR9-01-14 · Medium · poll마다 SQL 4개, PROJECTION_LAG WHERE 없음 → notification_provider_event 전체 스캔(지우는… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: `JdbcNotificationServingState.java:60-69,89-118`, `NotificationSchedulerWorker.java:84-87` — poll마다 SQL 4개, PROJECTION_LAG WHERE 없음 → notification_provider_event 전체 스캔(지우는 경로 없음), Javadoc 20-22 「claim 인덱스」. 고침: backlog만 or 캐시, 부분 인덱스 조건. + +### RR9-01-15 · Medium · ThreadPoolExecutor(1,n,LinkedBlockingQueue(4n)) 큐 찰 때까지 스레드 1, limiter 4로 큐 안… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10a 발행·발송·캐시 +- 내용: `NotificationSmtpProviderConfig.java:117-129` — ThreadPoolExecutor(1,n,LinkedBlockingQueue(4n)) 큐 찰 때까지 스레드 1, limiter 4로 큐 안 참(SmtpProviderRuntimeAssembler.java:110) → SMTP 직렬, NotificationSmtpSettings.java:22. 고침: core=max + allowCoreThreadTimeOut. + +### RR9-01-16 · Medium · RejectedExecution을 AMBIGUOUS_SUBMISSION으로(SMTP 상태 조회 없음 → 운영자 대기),… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10a 발행·발송·캐시 +- 내용: 같은 executor + `RegistryProviderDispatchGateway.java:59-61`, `ProviderOutcomeClassifier.java:49-57` — RejectedExecution을 AMBIGUOUS_SUBMISSION으로(SMTP 상태 조회 없음 → 운영자 대기), max-concurrency > 5×dispatch-concurrency 조건, 기동 검사 없음. 고침: ProviderCallNotStartedException + 기동 검사. + +### RR9-01-17 · Medium · 캐시가 대기 예산 없는 run → lane 대기 2s + commandTimeout, @param "ceiling on one cache… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10a 발행·발송·캐시 +- 내용: `RedisCacheRegionAdapter.java:118,131-138,161,270,346`, `SemanticRedisCall.java:115-117,134-137`, `RedisRuntimeOwner.java:171-172` — 캐시가 대기 예산 없는 run → lane 대기 2s + commandTimeout, @param "ceiling on one cache operation". rate limit은 effectWithin. 고침: effectWithin(commandTimeout). + +### RR9-01-18 · Medium · 캐시 값 크기 상한 없음(옛 키 폐기 env-keys.yaml:2686-2689, RedisKeyRules는 키만). 고침: encode 길이… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10a 발행·발송·캐시 +- 내용: `RedisCacheRegionAdapter.java:233-341` — 캐시 값 크기 상한 없음(옛 키 폐기 env-keys.yaml:2686-2689, RedisKeyRules는 키만). 고침: encode 길이 검사. + +### RR9-01-19 · Medium · 조건부 PUT 본문 재전송 가능 → SDK 재시도가 412 → ObjectControlConflictException,… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `S3ConditionalObjectControlStore.java:101-118`, `S3AsyncClientFactory.java:38-48` — 조건부 PUT 본문 재전송 가능 → SDK 재시도가 412 → ObjectControlConflictException, reconcileLostResponse(121) 안 돎, CAS(ObjectOperationKernel.java:112-125)는 자기 쓰기를 stale로. 조건 retry.maximum-attempts>1. 고침: 조건부 PUT 재시도 끔 or 412에서 다시 읽어 비교. + +### RR9-01-20 · Medium · getMappedResults 전부 메모리 후 셈, maxResultBytes 미집행(95), query-aggregation-guide… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `PolicyAwareMongoAggregationExecutor.java:76-85`, `MongoOperationBudget.java:5-11` — getMappedResults 전부 메모리 후 셈, maxResultBytes 미집행(95), query-aggregation-guide 3절. 고침: $limit(max+1) + cursor 바이트 누적. + +### RR9-01-21 · Medium · heap 384m을 512m tmpfs에 dump, 같은 cgroup·swap 없음 → dump 중 OOM kill 가능,… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B19 compose·Docker 운영 +- 내용: (넘어온 2) Dockerfile:157-163, compose.yaml:113-123, docs/runbooks/internal-error-spike.md:39 — heap 384m을 512m tmpfs에 dump, 같은 cgroup·swap 없음 → dump 중 OOM kill 가능, ExitOnOutOfMemoryError로 tmpfs 사라짐. dev.yaml:25-28만 volume. 고침: named volume or runbook. + +### RR9-01-22 · Low · (넘어온 1) .env.example:193 POSITIVE_SOFT_TTL= → 빈 Duration null → setter 안 불림 →… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: (넘어온 1) .env.example:193 POSITIVE_SOFT_TTL= → 빈 Duration null → setter 안 불림 → 필드 기본 30s(RedisCapabilitySettings.java:85), HARD_TTL<30s면 운영자가 정하지 않은 soft로 기동 실패(101-105). 고침: soft 비면 min(30s,hard). + +### RR9-01-23 · Low · max-items 100을 10분 lease로 한꺼번에 claim, lease 안에 끝나는지 검사 없음(outbox… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: `DefaultCleanupService.java:50,96-122` — max-items 100을 10분 lease로 한꺼번에 claim, lease 안에 끝나는지 검사 없음(outbox OutboxSettings.java:68-96, notification NotificationSchedulerWorker.java:71-75와 갈림). + +### RR9-01-24 · Low · "lease > provider 호출·timeout" 주석만, 검사 없음. + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: notification.yml:46-48, NotificationDispatchProperties.java:40-48 — "lease > provider 호출·timeout" 주석만, 검사 없음. + +### RR9-01-25 · Low · 트랜잭션 30초 상한 없음(decisions 2.5), row cap 사후 검사(inbox 건과 같은 원인). + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: `HibernateStatelessSessionRunner.java:56-67` — 트랜잭션 30초 상한 없음(decisions 2.5), row cap 사후 검사(inbox 건과 같은 원인). + +### RR9-01-26 · Low · 새 pool 크기 모른 채 합계 미만만 봄 → 상한 초과, Javadoc "would exceed". + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B9 트랜잭션 시한·정리 +- 내용: `TenantPoolBudget.java:29-33`, `TenantDataSourceRegistry.java:54` — 새 pool 크기 모른 채 합계 미만만 봄 → 상한 초과, Javadoc "would exceed". + +### RR9-01-27 · Low · acquire void, idle 판정 마지막 acquire 시각 → 사용 중 client 닫음, 닫기 실패가 다른 tenant… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `MongoTenantClientRegistry.java:85-128,130-156` — acquire void, idle 판정 마지막 acquire 시각 → 사용 중 client 닫음, 닫기 실패가 다른 tenant acquire에서(153). Experimental. + +### RR9-01-28 · Low · requireCurrentFence가 UNFENCED만 거름(MongoMigrationLock.java:32), refresh(166-170)… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `MongoCollectionMigrationLedger.java:93,120,177` — requireCurrentFence가 UNFENCED만 거름(MongoMigrationLock.java:32), refresh(166-170) ISE vs MongoMigrationHeartbeat.java:22 MongoOperationRejectedException 약속. + +### RR9-01-29 · Low · lease 만료 시계 구현마다 다름: JpaRecipientLeaseStore.java:52,117,… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B8 claim·fence +- 내용: lease 만료 시계 구현마다 다름: JpaRecipientLeaseStore.java:52,117, DefaultCleanupService.java:88, MongoCollectionMigrationLock.java:76-80(JVM) vs 멱등·rate limit(서버). R1-4와 같은 원인. + +### RR9-01-30 · Low · compression=true면 Apache가 푼 스트림을 wire 계수기가 셈(ApacheClientFactory.java:114-116)… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `RestClientResponseReader.java:112-124`, `ResponseLimits.java:8-13` — compression=true면 Apache가 푼 스트림을 wire 계수기가 셈(ApacheClientFactory.java:114-116) → 6MiB 응답 wire 초과 거절. + +### RR9-01-31 · Low · ProxyType.SOCKS를 HTTP 프록시로, capability… + +- 출처: 물결 2 outbound +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B10b S3·Mongo·httpclient +- 내용: `ApacheClientFactory.java:117-123` — ProxyType.SOCKS를 HTTP 프록시로, capability proxySupport=true(BlockingTransportCapabilities.java:33-35). diff --git a/docs/reviews/2026-11-12-round9-review/02-security-observability.md b/docs/reviews/2026-11-12-round9-review/02-security-observability.md new file mode 100644 index 00000000..7da3676a --- /dev/null +++ b/docs/reviews/2026-11-12-round9-review/02-security-observability.md @@ -0,0 +1,221 @@ +# round9 영역 02 — 보안·관측 + +- 대상: main `a7e38c10`(2026-11-12). 범위와 방법은 [README](README.md) 「범위」다. +- 발견마다: 출처(리뷰어), 증거 수준, 이전부터/최근 변경, 고칠 묶음(README 「묶음」). 원문의 `파일:줄`은 저장소 루트 기준이다. + +### RR9-02-01 · Medium · 관리 포트 기본 127.0.0.1(PR #12)인데 service-runtime/README.md:275-276·Dockerfile:221은… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B3 공개 경로·관리 포트 +- 내용: bootstrap/app `config/observability.yml:34` — 관리 포트 기본 127.0.0.1(PR #12)인데 service-runtime/README.md:275-276·Dockerfile:221은 k8s 프로브·Prometheus가 닿는다고 약속. `MANAGEMENT_SERVER_ADDRESS`가 docs/build.md:573·.env.example·env-keys에 없음. compose.yaml:88-91·compose-lanes/dev.yaml:70 `127.0.0.1:9001:9001` publish는 컨테이너 loopback에 못 닿음(죽은 설정). 고침: 세 문서에 원격 프로브는 MANAGEMENT_SERVER_ADDRESS 필요, .env.example 행, publish 줄 정리. 최근(PR #12, 9fb5a61f). + +### RR9-02-02 · Medium · 최상위 `roles` 클레임 fallback을 권한에 합침. manual 07:51-53·decisions 2.6 「JWT… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: web `auth/JwtToAuthenticatedPrincipalConverter.java:101-105` — 최상위 `roles` 클레임 fallback을 권한에 합침. manual 07:51-53·decisions 2.6 「JWT audience·role」은 realm_access·자기 client resource_access만. 고침: fallback 삭제 + 시험 "최상위 roles만 → 권한 0". 이전부터. + +### RR9-02-03 · Medium · config/security.yml 한 줄만 읽음, 문서(gates.md:63, build.md:166)는 보안 체인 전체 약속.… + +- 출처: 물결 1 보안·관측(같은 결함을 물결 1 API 계약·시험도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B3 공개 경로·관리 포트 +- 내용: bootstrap/app test `PublicPathSnapshotTest.java:31` — config/security.yml 한 줄만 읽음, 문서(gates.md:63, build.md:166)는 보안 체인 전체 약속. profile의 public-paths(application-local.yml:161), 모듈 체인 permitAll(web-notification CallbackMvcSecurityConfiguration.java:29-35 `/internal/notification/callbacks/**`) 우회. 고침: 입력 넓히기(context 띄워 matcher 나열) or 약속 좁히기. 이전부터. + +### RR9-02-04 · Medium · runbook 둘이 없는 신호로 탐지:… + +- 출처: 물결 1 보안·관측(같은 결함을 물결 2 계약·문서도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B7 runbook 신호 +- 내용: runbook 둘이 없는 신호로 탐지: `docs/runbooks/management-actuator-forbidden.md:15-16`(403 ACTUATOR_FORBIDDEN; 실제 404·본문없는 401 ManagementSecurityConfig.java:55-56, 코드 OperationalError.java:89 선언만), `docs/runbooks/authz-cross-tenant-violation.md:18-21,27,37`(403 AUTHZ_TENANT_MISMATCH 경보, 칸·지표 authz_denied_total 등 없음; 실제 404·로그·지표 없음). 고침: 신호 만들기(WARN+counter) 후 runbook 맞추기 or 신호 없음 명시. 이전부터. + +### RR9-02-05 · Medium · `docs/registries/metrics.yaml` 양방향 불일치: 코드 없는… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B5 관측 registry +- 내용: `docs/registries/metrics.yaml` 양방향 불일치: 코드 없는 행(http.server.requests.latency:47, dependency.client.requests:72, db.query.duration:211, resilience4j.* 98·117·137, cache.invalidations.total:454, cache.local.* 473·492·508), 행 없는 코드(http.client.* 25개, notification.* 16, graphql.* 4, jpa.query.*, backend.redis.*, mongodb.driver.*, fileserver.*.duration), http.server.requests tag 표기(uri_template·2xx vs uri·숫자·outcome·exception), MetricsDistributionMeterFilter.java:19-24 없는 이름에 SLO, CardinalityBounds Javadoc "used by MeterFilter" 미사용, 단위 접미사 규칙 위반 lock.acquisition:308·executor.saturation:233. 고침: 행↔meter 맞추기 + "registry ⊆ 등록 meter" 시험. 이전부터. + +### RR9-02-06 · Medium · JMX 9999 무인증·무TLS, jmxremote.host 없어 모든 인터페이스. 주석 15·54 "localhost only". 고침:… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B3 공개 경로·관리 포트 +- 내용: `src/bootstrap/app/compose-lanes/dev.yaml:62-67` — JMX 9999 무인증·무TLS, jmxremote.host 없어 모든 인터페이스. 주석 15·54 "localhost only". 고침: -Dcom.sun.management.jmxremote.host=127.0.0.1 or JMX 제거. 이전부터. + +### RR9-02-07 · Low · 18키 중 5개만 코드가 넣음(logback-spring.xml:90-94). tenant_id(77-88) required_in인데… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B5 관측 registry +- 내용: `docs/registries/mdc-keys.yaml` — 18키 중 5개만 코드가 넣음(logback-spring.xml:90-94). tenant_id(77-88) required_in인데 없음(JwtToAuthenticatedPrincipalConverter.java:40-41 "tenant_id is also the MDC key"). method·status·duration_ms 메시지에만(RequestLoggingFilter.java:52-57). request_id·correlation_id type ulid인데 UUIDv4(WebMvcRequestIdFilter.java:159, GrpcCorrelationInterceptor.java:67, WebSocketCorrelationInterceptor.java:34). required_test contract-verification:* 시험 없음. 이전부터. + +### RR9-02-08 · Low · 전송별 correlation 규칙 다름: web(WebMvcRequestIdFilter.java:189-191),… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B5 관측 registry +- 내용: 전송별 correlation 규칙 다름: web(WebMvcRequestIdFilter.java:189-191), gRPC(GrpcCorrelationInterceptor.java:65-74 correlation_id 없음, traceparent 없으면 trace_id 없음; Javadoc 17 "same keys"), STOMP 세션 id(WebSocketCorrelationInterceptor.java:34-37). mdc-keys.yaml:60-71. 고침: shared-contract에 결정 하나. 이전부터. + +### RR9-02-09 · Low · 401·403 WARN에 원본 getRequestURI(Javadoc 15-19 "only redacted"). 같은 모양… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6a 로그 내용 +- 내용: web `auth/AuthErrorResponseWriter.java:35-41` — 401·403 WARN에 원본 getRequestURI(Javadoc 15-19 "only redacted"). 같은 모양 RequestLoggingFilter.java:66-69, GlobalExceptionHandler.java:213 getDescription(false). 고침: 매칭 pattern·분류. 이전부터. + +### RR9-02-10 · Low · IP 신뢰 문서 둘: application-local.yml:120-121 "framework via… + +- 출처: 물결 1 보안·관측(같은 결함을 물결 2 계약·문서도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B6b 비밀·IP 문서 +- 내용: IP 신뢰 문서 둘: application-local.yml:120-121 "framework via env"(server.yml:12·env-keys.yaml:133-141 금지), docs/security/rate-limiting.md:18 지운 APP_RATE_LIMIT_CLIENT_IP_MODE(capability-status.md:319 삭제). 고침: native + internal-proxies. local은 이전부터, rate-limiting은 PR #12(1444d1e0). + +### RR9-02-11 · Low · config/security.yml:23 `SECURITY_PUBLIC_PATHS`, config/runtime.yml:18… + +- 출처: 물결 1 보안·관측(같은 결함을 물결 1 API 계약·시험도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: config/security.yml:23 `SECURITY_PUBLIC_PATHS`, config/runtime.yml:18 `PRESENTATION_API_BASE_PATH` env-keys·.env.example 미등록(머리말 7-10 "APP_, 예외 SPRING_*"). 이전부터. + +### RR9-02-12 · Low · masking_rule full_except_last_4 구현 없음(LogMaskingPatterns.java:23-41 URI… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6b 비밀·IP 문서 +- 내용: `docs/registries/secrets-classification.yaml` — masking_rule full_except_last_4 구현 없음(LogMaskingPatterns.java:23-41 URI userinfo 못 가림), 죽은 행 APP_PROFILE:399·SERVER_PORT:415·APP_NOTIFICATION_SLACK_WEBHOOK_URL:330·APP_SECURITY_GOOGLE_OAUTH_CLIENT_ID:344, required_test secrets-contract:* 없음. 이전부터. + +### RR9-02-13 · Low · 로컬 비밀 기본값 `__LOCAL_DEV_` 규칙 미준수: compose.yaml:108·158, application-local.yml:55… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6b 비밀·IP 문서 +- 내용: 로컬 비밀 기본값 `__LOCAL_DEV_` 규칙 미준수: compose.yaml:108·158, application-local.yml:55 `ca_skeleton`, compose.yaml:337·366 `caskeleton-local`, compose.yaml:388 `admin`. SecretSourceValidator(146-161) sentinel 못 알아봄. 이전부터. + +### RR9-02-14 · Low · "The standalone sample does that." 지운 샘플(ab5982e9). 최근. + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B6b 비밀·IP 문서 +- 내용: service-runtime `management/security/ManagementSecurityConfig.java:33-35` — "The standalone sample does that." 지운 샘플(ab5982e9). 최근. + +### RR9-02-15 · Low · main 호출자 없음, WebMvcRequestIdFilter.java:182-188이 버린 규칙. 고침: 클래스·시험·README:511… + +- 출처: 물결 1 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6a 로그 내용 +- 내용: web `observability/HeaderSanitizer.java:3-6` — main 호출자 없음, WebMvcRequestIdFilter.java:182-188이 버린 규칙. 고침: 클래스·시험·README:511 삭제. 이전부터. + +### RR9-02-16 · Medium · 인증 없는 모르는 profile POST → ISE → GlobalExceptionHandler.java:213… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: `ProviderCallbackIngressBridge.java:51-61`, `MapProviderCallbackAdapterRegistry.java:50`, `NotificationCallbackMvcController.java:105` — 인증 없는 모르는 profile POST → ISE → GlobalExceptionHandler.java:213 ERROR(스택·URI)+500 envelope("bare status, no body" Javadoc), 크기·content-type 검사가 profile 확인보다 먼저라 공격자 profile 문자열이 notification.security WARN. 고침: require 먼저, CallbackValidationException. + +### RR9-02-17 · Medium · root 좌표만 판정, GraphQlAuthorizationPolicy.java:11-16 builder는 User.salary 하위 좌표… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: `GraphQlDocumentAuthorizationHandler.java:69` — root 좌표만 판정, GraphQlAuthorizationPolicy.java:11-16 builder는 User.salary 하위 좌표 규칙 받고 버림 → 누구나 실행. 고침: 기동 거절 or 모든 필드 판정. + +### RR9-02-18 · Medium · @RequiresPermission web만: gRPC principal을… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: @RequiresPermission web만: gRPC principal을 Context에만(GrpcAuthenticationInterceptor.java:38), STOMP SecurityContext 전파 없음(WebSocketConfig.java:94), RequiresPermissionAuthorizationManager.java:56은 SecurityContextHolder → 항상 거부. 거부 결과도 web 403, gRPC INTERNAL+ERROR(GrpcExceptionHandlingInterceptor.java:147), STOMP ERROR(StompHandlerFailureLog.java:76), GraphQL masked INTERNAL_ERROR+ERROR(GraphQlExceptionResolver.java:66). manual 07, gRPC README AUTHZ→PERMISSION_DENIED. 고침: 전송별 SecurityContext 전달 + 같은 코드. + +### RR9-02-19 · Medium · 모든 projection을 /topic 하나로 모든 인증 세션에, tenant·소유자 판정 없음, README 「한계」 95-106 없음.… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11b graphql·websocket 계약 +- 내용: `LiveEventStompBroadcaster.java:89-92` — 모든 projection을 /topic 하나로 모든 인증 세션에, tenant·소유자 판정 없음, README 「한계」 95-106 없음. 고침: 목적지 분리 or 규칙·시험. + +### RR9-02-20 · Medium · SPRING_PROFILES_ACTIVE=test면 배포 jar 통과 → prod 검사 모두 꺼짐(SecretSourceValidator… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: `RuntimeEnvironmentProfileValidator.java:50` — SPRING_PROFILES_ACTIVE=test면 배포 jar 통과 → prod 검사 모두 꺼짐(SecretSourceValidator __LOCAL_DEV_·fixture-, fileserver unenforced, GraphQL 모드), JpaSafetySettings.java:32-33 local 편의 켜짐. RuntimeEnvironment.java:52 "test는 배포 환경 아님" 장치 없음. 고침: 배포 jar + test 표지 없음 → 기동 실패. + +### RR9-02-21 · Medium · INFO 이하 로거 구분 없이 버림, 감사 로거 INFO(LoggingNotificationAudit.java:31,… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6a 로그 내용 +- 내용: `SamplingTurboFilter.java:46-56` — INFO 이하 로거 구분 없이 버림, 감사 로거 INFO(LoggingNotificationAudit.java:31, StructuredAdminAudit.java:25, StructuredFileserverAudit.java:21), prod 0.1 권장(app README:349, env-keys.yaml:838) → 감사 90% 손실. 고침: 감사 로거·marker 제외 + 시험. + +### RR9-02-22 · Medium · 예외 통째 로그 → SQL·제약·값, 전송은 ServerFailureLog.of(ServerFailureLog.java:59-63). 고침:… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6a 로그 내용 +- 내용: `OutboxRelayScheduler.java:115-121`, `FileserverCleanupWorker.java:79-85,110-116` — 예외 통째 로그 → SQL·제약·값, 전송은 ServerFailureLog.of(ServerFailureLog.java:59-63). 고침: carrier면 ServerFailureLog 줄. + +### RR9-02-23 · Medium · sub 없는 토큰 idpUserId=null → FileAccessSubject.java:24,… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: `JwtToAuthenticatedPrincipalConverter.java:57` — sub 없는 토큰 idpUserId=null → FileAccessSubject.java:24, EdgeRateLimitSubject.java:25 NPE 500. AUTH_CLAIM_MAPPING_FAILED(OperationalError.java:33) 안 던짐, tenant claim 틀리면(:78) 문자열 매칭으로 AUTH_TOKEN_MALFORMED(SecurityErrorClassifier.java:110). 고침: 변환기에서 AUTH_CLAIM_MAPPING_FAILED 구조화. 구조적 위험. + +### RR9-02-24 · Low · 금지 값; auth-kid-unknown.md:25, auth-token-rotation-failure.md:29 없는 JWKS 손잡이;… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B7 runbook 신호 +- 내용: auth runbook(R2-4와 같은 원인): auth-claim-mapping-failed.md:20 토큰 payload, auth-token-malformed.md:20 Authorization 원문, auth-token-missing.md:20 — 금지 값; auth-kid-unknown.md:25, auth-token-rotation-failure.md:29 없는 JWKS 손잡이; auth-token-rotation-failure.md:16,33,64 없는 경보·지표; auth-issuer-mismatch.md:20 키 이름(app.security.issuer-uri / APP_SECURITY_JWT_ISSUER). + +### RR9-02-25 · Low · `WebSocketConfig.java:93` 주석 틀림(거부 preSend… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6a 로그 내용 +- 내용: `WebSocketConfig.java:93` 주석 틀림(거부 preSend WebSocketInboundAuthorizationInterceptor.java:49, request_id는 beforeHandle WebSocketCorrelationInterceptor.java:34), 플랫폼 거부 로그 없음, Spring StompSubProtocolHandler가 거부 SEND만 ERROR, SUBSCRIBE 흔적 없음(A8). 고침: 거부 WARN, Spring 로거 레벨, 주석. + +### RR9-02-26 · Low · 컨텍스트 속성만 바꿈, logback-spring.xml:89,122 ${APP_PROFILE}은 이미 치환 → JSON profile 칸… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B6a 로그 내용 +- 내용: `ResolvedProfileLoggingContextListener.java:56` — 컨텍스트 속성만 바꿈, logback-spring.xml:89,122 ${APP_PROFILE}은 이미 치환 → JSON profile 칸 그대로, LogProfileDriftCharacterizationTest:38 속성만. 구조적 위험. + +### RR9-02-27 · Low · in-process lock 미계량 → lock.acquisition 0, metrics.yaml:307 "1:1",… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B5 관측 registry +- 내용: `DistributedLockPersistenceConfig.java:48-50` — in-process lock 미계량 → lock.acquisition 0, metrics.yaml:307 "1:1", persistence-jpa README:563-564 "호출마다". + +### RR9-02-28 · Low · "서버 허용 목록 이름이라 echo 안전"인데 요청 값 echo(PatchFieldAuthorization.java:59,… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: `PatchAuthorizationException.java:15,25` — "서버 허용 목록 이름이라 echo 안전"인데 요청 값 echo(PatchFieldAuthorization.java:59, JsonPointerAuthorization.java:76) → details·메시지. + +### RR9-02-29 · Low · tenant 규칙 갈림: WebTenantContextResolver.java:19-20 거부 목록에 tenant_id 없음,… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B4 인증·인가 +- 내용: tenant 규칙 갈림: WebTenantContextResolver.java:19-20 거부 목록에 tenant_id 없음, GraphQlTenantIsolationPolicy.java:59 호출자 목록·대소문자, :41 source()==null 죽은 코드, 익명에 SYSTEM tenant(GraphQlRequestContextConfiguration.java:128, TenantContext.java:25), GraphQlContextPropagator.java:14 "모든 스레드 이동" 호출 0. + +### RR9-02-30 · Low · `compose/redis/acl/README.md:43` advanced 계정 pub/sub 더함, 실제… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B19 compose·Docker 운영 +- 내용: `compose/redis/acl/README.md:43` advanced 계정 pub/sub 더함, 실제 application-advanced.acl:1에 @pubsub 없음, redis-sdk README:58 "pub/sub 없음". + +### RR9-02-31 · Low · `GraphQlClientPolicy.java:24` maxInputListElements "한 input list 상한"인데… + +- 출처: 물결 2 보안·관측 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11b graphql·websocket 계약 +- 내용: `GraphQlClientPolicy.java:24` maxInputListElements "한 input list 상한"인데 variables·extensions만(GraphQlJsonStructurePolicy.java:54). diff --git a/docs/reviews/2026-11-12-round9-review/03-contract-testing.md b/docs/reviews/2026-11-12-round9-review/03-contract-testing.md new file mode 100644 index 00000000..42394306 --- /dev/null +++ b/docs/reviews/2026-11-12-round9-review/03-contract-testing.md @@ -0,0 +1,207 @@ +# round9 영역 03 — API 계약·시험 + +- 대상: main `a7e38c10`(2026-11-12). 범위와 방법은 [README](README.md) 「범위」다. +- 발견마다: 출처(리뷰어), 증거 수준, 이전부터/최근 변경, 고칠 묶음(README 「묶음」). 원문의 `파일:줄`은 저장소 루트 기준이다. + +### RR9-03-01 · Medium · 부분 실패 batch가 success:true + data.results. fullySucceeded() 미사용. 약속 충돌: web… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: web-fileserver `FileUploadController.java:128-136`, `dto/BatchUploadResponse.java:18` — 부분 실패 batch가 success:true + data.results. fullySucceeded() 미사용. 약속 충돌: web AGENTS B8·docs/web/http-contract.md:29(success:false+BATCH_PARTIAL_FAILURE) vs docs/fileserver/http-contract.md:12,100·upgrade-guide:65(200+results[].error). → 소유자 결정 필요(약속끼리 다름). 이전부터. + +### RR9-03-02 · Medium · partial() error.message 영어 고정, BulkItemResult 호출자 문구 그대로·null 키 남김(mix-in 아님,… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: shared-contract `response/BulkEnvelope.java:28`, `BulkItemResult.java:13-21` — partial() error.message 영어 고정, BulkItemResult 호출자 문구 그대로·null 키 남김(mix-in 아님, EnvelopeWireFormatConfig.java:34-37). 근거 http-contract.md:44, error-codes.yaml:15-16(ClientErrorMessages). 고침: ClientErrorMessages.of(BATCH_PARTIAL_FAILURE), 항목 message 정리, mix-in. 이전부터. + +### RR9-03-03 · Medium · 실제 long maxAgeSeconds(CorsSettings.java:19-20, config/security.yml:54) → 예시 그대로… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: `.env.example:79` APP_SECURITY_CORS_MAX_AGE=600s, env-keys.yaml:941-948(duration, 600s) — 실제 long maxAgeSeconds(CorsSettings.java:19-20, config/security.yml:54) → 예시 그대로 쓰면 기동 실패. 고침: int(초)·600. 이전부터. + +### RR9-03-04 · Medium · env-keys.yaml:2563-2577·2670-2684… + +- 출처: 물결 1 API 계약·시험(같은 결함을 물결 2 outbound도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: env-keys.yaml:2563-2577·2670-2684 APP_CACHE_REDIS_COMMAND_TIMEOUT·SEMANTIC_REGION "닿지 않음, 2026-11-30 제거"인데 cache-redis.yml:32,35 바인딩(기본 200ms vs registry 2s). 기본값 불일치: APP_RATE_LIMIT_REDIS_COMMAND_TIMEOUT 1s/200ms(cache-redis.yml:69), APP_LOG_LEVEL_SQL WARN/INFO(observability.yml:117), APP_CACHE_REDIS_POSITIVE_SOFT_TTL null/30s(cache-redis.yml:36). 이전부터. + +### RR9-03-05 · Medium · docs/registries/headers.yaml:16,154 X-Request-Id·X-Correlation-Id type ulid(코드… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B5 관측 registry +- 내용: docs/registries/headers.yaml:16,154 X-Request-Id·X-Correlation-Id type ulid(코드 UUID, WebMvcRequestIdFilter.java:159,163,191; correlation [A-Za-z0-9._-]{1,128}). ETag·Location·Allow·Cache-Control·Vary·Content-Range·tus·Upload-* 행 없음. web README.md:487-490 "코드 미러, 맞추는 시험 있음", 없는 X-Api-Version "여기서 생산". HeaderRegistryRuntimeAlignmentTest 행 3개만. 고침: 타입·행·ApiHeaders 대조 시험. 이전부터. + +### RR9-03-06 · Medium · 서버 포화를 전송마다 다른 코드: gRPC GrpcCallAdmission.java:82-83 RATE_LIMIT_EXCEEDED("요청이… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B13 전송 오류 코드 +- 내용: 서버 포화를 전송마다 다른 코드: gRPC GrpcCallAdmission.java:82-83 RATE_LIMIT_EXCEEDED("요청이 너무 잦습니다"), web-advanced WebAdvancedError.java:23 ADMISSION_REFUSED 503, fileserver FileserverErrorCode.java:45 429 RATE_LIMIT, 공용 OperationalError.java:81 JOB_EXECUTOR_REJECTED. decisions 2.3 행 없음 → 소유자 결정(wire 바뀜). 이전부터. + +### RR9-03-07 · Medium · 27개 중 23개 계약 문서에 없음, docs/fileserver/http-contract.md:79 예시 "data":… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: application/fileserver `api/error/FileserverErrorCode.java` — 27개 중 23개 계약 문서에 없음, docs/fileserver/http-contract.md:79 예시 "data": null(NON_NULL 결정과 다름). 고침: 코드 표 + 예시. 이전부터. + +### RR9-03-08 · Medium · grpc README.md:26-28 "전용 APP_* 키 registry에 없다"인데 APP_GRPC_SERVER_ENABLED… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: grpc README.md:26-28 "전용 APP_* 키 registry에 없다"인데 APP_GRPC_SERVER_ENABLED 등록(env-keys.yaml:4059). APP_GRPC_SERVER_ALLOW_INSECURE_LOCAL registry·.env.example 없음. 이전부터. + +### RR9-03-09 · Medium · Content-Range(MvcDownloadResponseWriter.java:43,… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: FileserverHttpSurfaceConfiguration.java:43-56, http-contract.md:178-180 — Content-Range(MvcDownloadResponseWriter.java:43, FileserverProblemHeaders.java:55) 노출 헤더 목록 없음 → CORS 이어받기 못 함. 이전부터. + +### RR9-03-10 · Low · MANAGEMENT_SERVER_ADDRESS registry 있음·.env.example 없음(R2-1 일부). 최근(#12). + +- 출처: 물결 1 API 계약·시험(같은 결함을 물결 2 계약·문서도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B2 env 계약 +- 내용: observability.yml:34, .env.example:22 — MANAGEMENT_SERVER_ADDRESS registry 있음·.env.example 없음(R2-1 일부). 최근(#12). + +### RR9-03-11 · Low · OPERATION_NOT_FOUND(operation/OperationErrorCode.java) §4에 없음(decisions 2.3 「새… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B13 전송 오류 코드 +- 내용: docs/web/http-contract.md:184-193 — OPERATION_NOT_FOUND(operation/OperationErrorCode.java) §4에 없음(decisions 2.3 「새 오류 코드 소유」). 이전부터. + +### RR9-03-12 · Low · 모든 503이 REQUEST_TIMEOUT(retryable). §4는 비동기 시간 초과에만. 이전부터. + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B13 전송 오류 코드 +- 내용: web `error/HttpStatusErrorCodes.java:31` — 모든 503이 REQUEST_TIMEOUT(retryable). §4는 비동기 시간 초과에만. 이전부터. + +### RR9-03-13 · Low · 모르는 channel·slot·locale이 details 없는 BAD_PARAMETER(주석은 validation error, S4는… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: NotificationSubmissionController.java:98-104,114-121, NotificationTemplateController.java:85,119-131 — 모르는 channel·slot·locale이 details 없는 BAD_PARAMETER(주석은 validation error, S4는 VALIDATION_FAILED), 201에 Location 없음, 경로 /notification-templates lowerCamel 아님(manual 11:37). 이전부터. + +### RR9-03-14 · Low · ERROR frame code만(category·retryable 없음), 원인 사슬 어디 IAE든 BAD_PARAMETER(다른 전송은 실패… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11b graphql·websocket 계약 +- 내용: websocket `SafeStompSubProtocolErrorHandler.java:51-58,62-67` — ERROR frame code만(category·retryable 없음), 원인 사슬 어디 IAE든 BAD_PARAMETER(다른 전송은 실패 자신만), Javadoc:16-17 "다른 전송과 같은 코드". 이전부터. + +### RR9-03-15 · Low · Retry-After를 occurrence만 보고 붙임, 본문은 코드 값으로 좁힘(ErrorResponseFactory.java:42) →… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: FileserverProblemHeaders.java:51 — Retry-After를 occurrence만 보고 붙임, 본문은 코드 값으로 좁힘(ErrorResponseFactory.java:42) → ATOMIC_PUBLISH_UNSUPPORTED 행 어긋남. 이전부터. + +### RR9-03-16 · Low · 낡은 문서: GrpcStatusMapper.java:21 WORKLOG_NOT_FOUND 예시(ab5982e95 이후), graphql 스냅숏… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B13 전송 오류 코드 +- 내용: 낡은 문서: GrpcStatusMapper.java:21 WORKLOG_NOT_FOUND 예시(ab5982e95 이후), graphql 스냅숏 머리말 없는 spi 패키지(graphql/build.gradle:149). + +### RR9-03-17 · Medium · test에서 태그 없이 env-keys.yaml 읽음, modules.json 거슬러 ca.repository.root 가드 우회, 입력… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B16 시험 품질 +- 내용: GraphQlDeploymentModeRegistryParityTest.java:26-46 — test에서 태그 없이 env-keys.yaml 읽음, modules.json 거슬러 ca.repository.root 가드 우회, 입력 미선언 → 캐시가 registry 변경 놓침. 근거 build-logic/AGENTS.md:14-17. 고침: document-contract로. 이전부터. + +### RR9-03-18 · Medium · "값을 싣지 않는다" 단언에 예외 타입 없음 → 메시지 null NPE로 바꿔도 통과. 이전부터. + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B16 시험 품질 +- 내용: WebSecurityContextBridgeTest.java:39-43, GraphQlScalarContractTest.java:83-89, GraphQlScalarSymmetryTest.java:80-85 — "값을 싣지 않는다" 단언에 예외 타입 없음 → 메시지 null NPE로 바꿔도 통과. 이전부터. + +### RR9-03-19 · Low · 빈 목록이면 통과, GWT 없음. 고침: 메서드 목록 고정. 최근(#12 bb8bb31b9). + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B16 시험 품질 +- 내용: FileserverAdminControllerRequestBodyValidationTest.java:27-41 — 빈 목록이면 통과, GWT 없음. 고침: 메서드 목록 고정. 최근(#12 bb8bb31b9). + +### RR9-03-20 · Low · MvcUploadExecutorSaturationTest.java:112-121(이름 timeout인데 타입만), :45 sleep(200),… + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B16 시험 품질 +- 내용: MvcUploadExecutorSaturationTest.java:112-121(이름 timeout인데 타입만), :45 sleep(200), GraphQlRequestDeadlineTest.java:101-104 sleep(500) 뒤 부재 단언. 이전부터. + +### RR9-03-21 · Low · EnvelopeWireShapeTest + +- 출처: 물결 1 API 계약·시험 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B16 시험 품질 +- 내용: EnvelopeWireShapeTest — http-contract.md:9가 §1 증거로 대는데 data null 키 없음(:32), String→Envelope(:33), sort:null(:55), 부분 실패 message 안 봄. EnvelopeTest.java:34 when 둘. 이전부터. + +### RR9-03-22 · Low · 영어 @DisplayName 381/940, // when 없는 3문장+ 테스트 약 890/1550(휴리스틱). 규칙은 "손댈 때 고침" →… + +- 출처: 물결 1 API 계약·시험(같은 결함을 물결 2 arch-reviewer도 적음) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B16 시험 품질 +- 내용: 영어 @DisplayName 381/940, // when 없는 3문장+ 테스트 약 890/1550(휴리스틱). 규칙은 "손댈 때 고침" → 일괄 전환은 소유자 결정. 표 입력 반복문·when 둘: WebSecurityContextBridgeTest.everySpelling…, HmacGraphQlCursorCodecTest:232, GraphQlMutationResultMapperTest:44. + +### RR9-03-23 · Medium · web-advanced patch 위반이 세 코드(PATCH_REJECTED 400 / BAD_PARAMETER 400 IAE /… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11a web-advanced 계약 +- 내용: web-advanced patch 위반이 세 코드(PATCH_REJECTED 400 / BAD_PARAMETER 400 IAE / PATCH_PATH_FORBIDDEN 403), 비JSON 본문 → readTree JacksonException → GlobalExceptionHandler.java:207 500 INTERNAL_ERROR. JsonPatchDocument.java:151-155,175, JsonPatchOperation.java:28-53, JsonMergePatchDocument.java:55-62,92, JsonPointerAuthorization.java:128-130. 근거 WebAdvancedError.java:26, README:61. 고침: JsonPatchRejectedException 통일 + 파싱 감쌈 + upgrade 행. + +### RR9-03-24 · Medium · "결과를 문서 전체로 검증 후 적용" 약속, 검증기 안 받음. + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11a web-advanced 계약 +- 내용: JsonMergePatchApplier.java:42-44, JsonPatchApplier.java:14-16, patch-contract.md:43-44,62-64 — "결과를 문서 전체로 검증 후 적용" 약속, 검증기 안 받음. + +### RR9-03-25 · Medium · sequence 엄격 증가·heartbeat·idle·max-age·버퍼 상한·drain 재연결 약속, writer 아무것도 안… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11a web-advanced 계약 +- 내용: streaming-contract.md:25,58-62,66-67,71-72 vs MvcStreamWriter.java:52-77 — sequence 엄격 증가·heartbeat·idle·max-age·버퍼 상한·drain 재연결 약속, writer 아무것도 안 함(GapAndDuplicateGuard·WebStreamSession·WebStreamDrainCoordinator main에 없음, IDLE_TIMEOUT·MAX_AGE 안 냄). + +### RR9-03-26 · Medium · commit 뒤 실패 코드 DEPENDENCY_FAILURE 고정(registry·WebAdvancedError·§4 없음),… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11a web-advanced 계약 +- 내용: MvcStreamWriter.java:97-100 — commit 뒤 실패 코드 DEPENDENCY_FAILURE 고정(registry·WebAdvancedError·§4 없음), StreamItemTooLargeException(README:67)·carrier 코드 버림. + +### RR9-03-27 · Medium · 503+Retry-After 약속, guard bean만, 요청 경로에서 run 안 부름(manual 10 기준 3). + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11a web-advanced 계약 +- 내용: virtual-thread-profile.md:16-17,36-40, advanced-capabilities.md:13 vs VirtualThreadMvcConfiguration.java:53-58 — 503+Retry-After 약속, guard bean만, 요청 경로에서 run 안 부름(manual 10 기준 3). + +### RR9-03-28 · Medium · 정본 충돌 → 소유자 결정. + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11a web-advanced 계약 +- 내용: web AGENTS.md:65 B2 "merge-patch+json 안 씀" vs patch-contract.md:22 "필드 변경은 merge patch" — 정본 충돌 → 소유자 결정. + +### RR9-03-29 · Medium · Javadoc "Stable request-error code GRAPHQL_CURSOR_REJECTED"인데 플랫폼 거부·carrier 아님… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B11b graphql·websocket 계약 +- 내용: GraphQlCursorException.java:10-15, GraphQlConnectionException.java:8-13 — Javadoc "Stable request-error code GRAPHQL_CURSOR_REJECTED"인데 플랫폼 거부·carrier 아님 → resolver 안에서 INTERNAL_ERROR+ERROR(GraphQlErrorCodeCatalogTest:58-61). diff --git a/docs/reviews/2026-11-12-round9-review/04-build-docs.md b/docs/reviews/2026-11-12-round9-review/04-build-docs.md new file mode 100644 index 00000000..3a263304 --- /dev/null +++ b/docs/reviews/2026-11-12-round9-review/04-build-docs.md @@ -0,0 +1,298 @@ +# round9 영역 04 — 빌드·문서 + +- 대상: main `a7e38c10`(2026-11-12). 범위와 방법은 [README](README.md) 「범위」다. +- 발견마다: 출처(리뷰어), 증거 수준, 이전부터/최근 변경, 고칠 묶음(README 「묶음」). 원문의 `파일:줄`은 저장소 루트 기준이다. + +### RR9-04-01 · Medium · #12가 줄 더해 151/150, check-work-docs rc=1 → verify.sh docs·라운드 끝 실패. 같은 줄 "(W4… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · E2(실행) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `docs/work/operate.md:120` — #12가 줄 더해 151/150, check-work-docs rc=1 → verify.sh docs·라운드 끝 실패. 같은 줄 "(W4 BE-OBS-A)" 묶음 ID(docs/work 금지), --history가 못 잡음. 고침: 문장 옮기고 ID 삭제, `W\d BE-` 패턴 검사에. E2. 최근 #12(1444d1e0). + +### RR9-04-02 · Medium · `cd ~/workspace/<작업>/src` 뒤 ./gradlew(#10 뒤 src에 gradlew 없음). desktop-gates… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `docs/work/operate.md:57,87` — `cd ~/workspace/<작업>/src` 뒤 ./gradlew(#10 뒤 src에 gradlew 없음). desktop-gates 6단계가 이 절차로 보냄. 최근 #10. + +### RR9-04-03 · Medium · "Gradle 루트가 src/라 두 단계 위", `--include-build ../../messaging-library` →… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `docs/work/reference/related-repos.md:19,22` — "Gradle 루트가 src/라 두 단계 위", `--include-build ../../messaging-library` → `../messaging-library`. 최근 #10. + +### RR9-04-04 · Medium · 이름 바꾸기 `git grep -l 'dev\.caskeleton' -- src scripts`가 build.gradle:26,… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18a 스크립트 +- 내용: `README.md:122` — 이름 바꾸기 `git grep -l 'dev\.caskeleton' -- src scripts`가 build.gradle:26, JavaConventionsPlugin.java:67, config/spotbugs/exclude.xml(69줄)·exclude-test.xml(8줄) 놓침 → qualityCheck 실패. 고침: pathspec 넓힘. 최근 #10. + +### RR9-04-05 · Medium · 없는 PublicPathSnapshotPlugin.java·updatePublicPathSnapshot, 없는 CI step. 고침:… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B3 공개 경로·관리 포트 +- 내용: `docs/build.md:156,160,169` — 없는 PublicPathSnapshotPlugin.java·updatePublicPathSnapshot, 없는 CI step. 고침: `./gradlew verifyPublicPathSnapshot -PapprovePublicPathChange`. 이전부터. (R2-3·R3-7 문서 부분과 같은 자리) + +### RR9-04-06 · Medium · `:app-bootstrap:test --tests '*CleanArchitectureTest'` 고르는 클래스… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: `scripts/verify-mongodb-platform.sh:130` — `:app-bootstrap:test --tests '*CleanArchitectureTest'` 고르는 클래스 없음(architectureTest source set) → 항상 FAILED. persistence-mongo/AGENTS.md:155·docs/mongodb/repository-adaptation.md:123가 시킴. :156 태그 증거. 고침: :app-bootstrap:architectureTest, 이미지는 카탈로그 mongo-8. 이전부터. + +### RR9-04-07 · Medium · `docs/work/experts.md:56-66` 3절 표가 스킬 paths와 갈림(be-build-ci… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `docs/work/experts.md:56-66` 3절 표가 스킬 paths와 갈림(be-build-ci settings.gradle·gradle.properties·Dockerfile·renovate.json, be-api-contract .env.example·docs/upgrade/**, be-security .trivyignore.yaml, be-testing docs/testing/**·container-images.properties, be-observability docs/runbooks/**, be-persistence docs/jpa/**·docs/mongodb/**, be-docs **/CLAUDE.md). test_claude_setup.py:158 이름만. 고침: 표가 paths 가리키게 or 대조 시험. 최근 #14(c611b06f). + +### RR9-04-08 · Medium · 행이 코드와 다르고 「바뀜」 표시 없음: 64 docs-check workflow 없음, 193 build-logic 잠그지 않음 vs… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `docs/work/reference/decisions.md:64,193,194,199` — 행이 코드와 다르고 「바뀜」 표시 없음: 64 docs-check workflow 없음, 193 build-logic 잠그지 않음 vs build-logic/build.gradle:35-38 STRICT, 194 cosign keyless vs release.yml:8-11 키 쌍(11-07), 199 cd 따라감 vs 11-08 형식 검사 셸 거절(StrictLaneStagesPlugin.java:46-48). 193 이전부터, 나머지 최근 #7. + +### RR9-04-09 · Medium · 단계 구성표 네 곳: docs/testing/TESTING_STRATEGY.md:146-148(틀림,… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18b 문서 본문 +- 내용: 단계 구성표 네 곳: docs/testing/TESTING_STRATEGY.md:146-148(틀림, build.gradle:175-181,269-274), docs/build.md:28,34(testQualityCheck·verifyFeatureScaffold·graphqlStableTest 빠짐), gates.md:42, build.gradle:62-85 주석. 고침: gates.md 1절만 남기고 가리킴. 이전부터. + +### RR9-04-10 · Medium · 33·36 지운… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18b 문서 본문 +- 내용: `docs/capability-status.md:16,33,35,36` — 33·36 지운 redis-sdk-topology.yml·notification-platform.yml·verifyNotificationEvidence, 35 relay가 app-bootstrap OutboxConfig(지금 :composition:outbox-relay, 같은 문서 :439), 없는 lane postgresqlLegacyOutboxConcurrentRelayIntegrationTest. HISTORY_HOLDERS라 reference 검사 안 봄. 최근 #7·이전부터. + +### RR9-04-11 · Medium · nightly jpa-postgresql·release jpa-release-gate. 고침: digest. 이전부터. + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: `gradle/container-images.properties:27-30` postgres-17·18 태그만(머리말 :8, gates.md:193, 함정 12와 다름) — nightly jpa-postgresql·release jpa-release-gate. 고침: digest. 이전부터. + +### RR9-04-12 · Medium · 모든 ca.spring-library leaf(30) testImplementation에… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: build-logic `SpringLibraryConventionPlugin.java:12-15` — 모든 ca.spring-library leaf(30) testImplementation에 spring-boot-starter-webmvc-test(Tomcat 포함), MockMvc 쓰는 leaf 5개. 예 identifier/gradle.lockfile:68-131, Tomcat 테스트 classpath lockfile 14개. 고침: 쓰는 leaf만. 이전부터(60b6a319). + +### RR9-04-13 · Low · `gradle/libs.versions.toml` 미사용 칸: 120 errorprone-core, 121 findsecbugs-plugin,… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: `gradle/libs.versions.toml` 미사용 칸: 120 errorprone-core, 121 findsecbugs-plugin, 123 jackson3-core, 125·126 jmh, 130 junit-platform-launcher(+70), 142 protobuf-java-legacy(+91 주석), 148·149 spock(+97-98, 머리말 12-18), 플러그인 174-177 spring-dependency-management·spotless·spotbugs·errorprone(루트 미적용 build.gradle:5-9), 167-170 주석의 libs.errorprone.core. 이전부터. + +### RR9-04-14 · Low · "쓰는 lane만 다시 돈다"인데 JavaConventionsPlugin.java:279-288이 파일 전체를 모든 leaf 모든 Test… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: `gradle/container-images.properties:3-5` — "쓰는 lane만 다시 돈다"인데 JavaConventionsPlugin.java:279-288이 파일 전체를 모든 leaf 모든 Test 입력으로 → 이미지 하나 바꿔도 domain-core 캐시 무효. postgres-16-4(:24-26) 미사용. 이전부터. + +### RR9-04-15 · Low · 없는 클래스… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: `config/spotbugs/exclude.xml:62-70` — 없는 클래스 ...bootstrap.autoconfigure.notification.observation.NotificationObservationTest, exclude-test.xml:102-109에 이미 있음. 이전부터. + +### RR9-04-16 · Low · `src/adapter/outbound/notification/build.gradle:104` additionalSourceRoots 상대… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 +- 내용: `src/adapter/outbound/notification/build.gradle:104` additionalSourceRoots 상대 경로 `../../../application/notification/src/main/java`(함정 10), JavaPublicTypes.java:35-37 없는 폴더 말없이 건너뜀 → 승인 update 시 줄어든 surface 기록. 고침: project(':application-notification').file(...), 없으면 실패. 이전부터. + +### RR9-04-17 · Low · 검사 스크립트 정비: check-repo-layout.py:90-96 HISTORY_PREFIXES 없는 폴더… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18a 스크립트 +- 내용: 검사 스크립트 정비: check-repo-layout.py:90-96 HISTORY_PREFIXES 없는 폴더 셋(superpowers·evidence·study), docs/history/·docs/design/ 빠짐; 머리 주석에 부르는 쪽 없음(check-repo-layout, check-docs, check-work-docs, verify-httpclient-docs, verify-compose-profile-contracts); scripts/tests 시험 없음(check-repo-layout, check-review-index, verify-httpclient-docs). 이전부터·#10. + +### RR9-04-18 · Low · docstring 낡음: check-docs.py:2,18,41 "검사 여섯"(여덟), check-work-docs.py:31 lychee… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18a 스크립트 +- 내용: docstring 낡음: check-docs.py:2,18,41 "검사 여섯"(여덟), check-work-docs.py:31 lychee "PR workflow"(main). 이전부터·#7. + +### RR9-04-19 · Low · `docs/README.md:187` "PR마다 workflow docs-check" → pr.yml done → :prCheck →… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `docs/README.md:187` "PR마다 workflow docs-check" → pr.yml done → :prCheck → documentCheck. 최근 #7. + +### RR9-04-20 · Low · 기본 조립: docs/build.md:50-56·scripts/bootstrap-local.sh:12-14,42 "app 기동(Flyway… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18b 문서 본문 +- 내용: 기본 조립: docs/build.md:50-56·scripts/bootstrap-local.sh:12-14,42 "app 기동(Flyway 포함)"(기본 web만, build.md:254), build.md:279 알림 키 "8종"(7개). 이전부터. + +### RR9-04-21 · Low · `docs/roadmap/messaging-r2.md:45,48` 지운… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18b 문서 본문 +- 내용: `docs/roadmap/messaging-r2.md:45,48` 지운 VerifyMessagingEvidenceTask·MessagingQualificationPlugin. 이전부터. + +### RR9-04-22 · Low · #13이 합친 integration job을 가리킴: cache-redis/README.md:332,… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18b 문서 본문 +- 내용: #13이 합친 integration job을 가리킴: cache-redis/README.md:332, cache-redis/build.gradle:74, httpclient/build.gradle:233. 최근 #13. + +### RR9-04-23 · Low · bootstrap-local.sh를 flock으로 직접(:33 ./gradlew --no-daemon 없음), "4.1절의 정리법"… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `.claude/agents/verify-api.md:21,23` — bootstrap-local.sh를 flock으로 직접(:33 ./gradlew --no-daemon 없음), "4.1절의 정리법" operate.md에 없음. 고침: scripts/verify.sh app --on here. 최근 c67c7131. + +### RR9-04-24 · Low · `CLAUDE.md:8` "분야 지식 be-* 10개" 개수 복사(함정 6). 최근 #14. + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: `CLAUDE.md:8` "분야 지식 be-* 10개" 개수 복사(함정 6). 최근 #14. + +### RR9-04-25 · Low · `renovate.json:9,17` "either bot"·GitHub vulnerability alerts 전제, Gitea에서… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18b 문서 본문 +- 내용: `renovate.json:9,17` "either bot"·GitHub vulnerability alerts 전제, Gitea에서 Renovate 근거 없음, .github/dependency-vulnerability-policy.md:7,95 정책 수단으로 듦. 최근 #7. + +### RR9-04-26 · Low · `scripts/run-compose-runtime-smoke.sh:388` lane마다 정적 계약 전체 재실행(compose config… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18a 스크립트 +- 내용: `scripts/run-compose-runtime-smoke.sh:388` lane마다 정적 계약 전체 재실행(compose config ~650회/nightly), PR이 verifyComposeProfiles로 이미 함. 고침: 루프 전 한 번. 이전부터. + +### RR9-04-27 · Low · handoff --force-recreate가 1단계 재시작 수 지움, ps -a -q 빈 결과면 restarts.txt 비고 || true로… + +- 출처: 물결 1 빌드·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18a 스크립트 +- 내용: `run-compose-runtime-smoke.sh:533-537,602-606` — handoff --force-recreate가 1단계 재시작 수 지움, ps -a -q 빈 결과면 restarts.txt 비고 || true로 통과. 최근 50cd7154. + +### RR9-04-28 · Medium · graphql AGENTS·README가 「모듈별 yml 금지」라 하지만 모듈이 config/graphql.yml을 읽는다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18b 문서 본문 +- 내용: graphql AGENTS.md:116, README.md:126,152,166-168 — "모듈별 yml 금지·없음"인데 config/graphql.yml 직접 읽음(GraphQlActivationEnvironmentPostProcessor:55, manual 10:67 예외), app.graphql.console.*, 지운 "execution profile". + +### RR9-04-29 · Medium · `.env.example`의 APP_DATASOURCE_CONNECTION_TIMEOUT=5s는 registry가 기동 실패라 적은 값이다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: .env.example:45 APP_DATASOURCE_CONNECTION_TIMEOUT=5s(registry가 기동 실패라 적은 값) — B2 묶음. + +### RR9-04-30 · Medium · `.env.example`의 FORWARD_HEADERS_STRATEGY=native가 registry 기본 none과 다르다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: .env.example:25 FORWARD_HEADERS_STRATEGY=native — registry 기본 none·"기본은 닫힘"(env-keys.yaml:135-140). 고침: 비우거나 none. — B2 묶음(기존 안은 example: native였음 → 리뷰어는 none 권함). + +### RR9-04-31 · Low · `.env.example` 머리말 「Seven values」가 여섯만 나열하고, 폐기 키 48개에 값이 들어 있다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: .env.example:12-15 "Seven values" 여섯, deprecated 48개 — B2 묶음. + +### RR9-04-32 · Medium · cache-redis README가 운영 비밀로 폐기 키 넷을 넣으라고 한다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B2 env 계약 +- 내용: cache-redis/README.md:49-50 운영 비밀로 deprecated_orphaned 키 넷(APP_CACHE_REDIS_PASSWORD·_KEY_HMAC_SECRET, APP_IDEMPOTENCY_/LEASE_REDIS_KEY_HMAC_SECRET). 고침: APP_REDIS_AUTHENTICATION_*. + +### RR9-04-33 · Medium · 지식 스킬 넷이 재배치 뒤에도 「명령은 src/에서」라고 한다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B1 문서·지침 +- 내용: 스킬 넷 "명령은 src/에서" — PR #16에서 고침(2249d442). + +### RR9-04-34 · Low · docs/web/runbook.md:37,49,56-58 TTL "연산마다"(전역 APP_IDEMPOTENCY_TTL),… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B7 runbook 신호 +- 내용: docs/web/runbook.md:37,49,56-58 TTL "연산마다"(전역 APP_IDEMPOTENCY_TTL), GracefulShutdownProbe(testFixtures)를 운영 장치로, routeTemplate tag 없음. + +### RR9-04-35 · Low · docs/web/repository-adaptation.md:146-162 "앱은 애플리케이션 칸 강제 안 함" vs… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: docs/web/repository-adaptation.md:146-162 "앱은 애플리케이션 칸 강제 안 함" vs app.web.mvc.max-json-body-size 1MB 413(WebMvcPlatformSettings.java:31). + +### RR9-04-36 · Low · openapi-32-compatibility.md가 아무도 만들지 않는 3.1.2 산출물·snapshot 불변식을 적는다 + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: docs/web/openapi-32-compatibility.md:10,14,26 "3.1.2 릴리스 산출물", "3.1 snapshot" 불변식 — 만드는·대조하는 build 없음(샘플 삭제 뒤). + +### RR9-04-37 · Low · 없는 metric·행 가리키는 runbook: authz-cross-tenant-violation.md:38,67,… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B7 runbook 신호 +- 내용: 없는 metric·행 가리키는 runbook: authz-cross-tenant-violation.md:38,67, rate-limit-exceeded.md:38,68(gateway_rate_limit_*, 헤더 X-RateLimit-Remaining), dependency-unavailable.md:75(CACHE_UNAVAILABLE). + +### RR9-04-38 · Low · 옮기거나 바꾼 타입: persistence-jpa/README.md:43 OutboxConfig,… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: 옮기거나 바꾼 타입: persistence-jpa/README.md:43 OutboxConfig, :220·application/core/README.md:287 IdempotencyProviderSelectionConfig→IdempotencyAutoConfiguration, docs/build.md:413 TracingProperties→TracingSettings, bootstrap/app/README.md:88 SecretSource→SecretSourcePort, web/README.md:472 JsonNullableModule, graphql AGENTS.md:104·README.md:130 GraphQlPlatformProperties→Settings, web/AGENTS.md:139 PeriodTest, application/core/AGENTS.md:80 OutboxEventIdFactory. + +### RR9-04-39 · Low · 지운 샘플: defect-patterns.md:68 SampleDemoProfilesStartupSystemTest,… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: 지운 샘플: defect-patterns.md:68 SampleDemoProfilesStartupSystemTest, TESTING_STRATEGY.md:292, IdempotencyAutoConfiguration.java:24, ManagementSecurityConfig.java:35 Javadoc. + +### RR9-04-40 · Low · graphql AGENTS.md:23-33·README.md:186 "messaging leaf registry 등록, 두 패턴… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: graphql AGENTS.md:23-33·README.md:186 "messaging leaf registry 등록, 두 패턴 공존"(#8), grpc AGENTS.md:44-45·README.md:62 "vendored 플랫폼 starter"(#6), docs/websocket/runbook.md:5·defect-patterns.md:20 leaf CLAUDE.md(지금 AGENTS.md). + +### RR9-04-41 · Low · graphql AGENTS.md:19·README.md:183 "366개 java 파일"(246), AGENTS.md:160 "23… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: graphql AGENTS.md:19·README.md:183 "366개 java 파일"(246), AGENTS.md:160 "23 tests"(34), manual 06:58 registry 머리말 옛 영어 인용. + +### RR9-04-42 · Low · leaf 안내 공백: application-notification·-fileserver·-objectstorage 가장 가까운 AGENTS가… + +- 출처: 물결 2 계약·문서 +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 최근 변경 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: leaf 안내 공백: application-notification·-fileserver·-objectstorage 가장 가까운 AGENTS가 루트뿐·README 없음, web-notification·web-fileserver·redis-runtime 자기 AGENTS·README 없음, docs/README.md 지도 security/ 행이 rate-limiting.md 안 덮음(#12). diff --git a/docs/reviews/2026-11-12-round9-review/05-architecture-domain.md b/docs/reviews/2026-11-12-round9-review/05-architecture-domain.md new file mode 100644 index 00000000..ed46d6b8 --- /dev/null +++ b/docs/reviews/2026-11-12-round9-review/05-architecture-domain.md @@ -0,0 +1,137 @@ +# round9 영역 05 — 계층·도메인·SRP + +- 대상: main `a7e38c10`(2026-11-12). 범위와 방법은 [README](README.md) 「범위」다. +- 발견마다: 출처(리뷰어), 증거 수준, 이전부터/최근 변경, 고칠 묶음(README 「묶음」). 원문의 `파일:줄`은 저장소 루트 기준이다. + +### RR9-05-01 · High · controller가 domain `Repository` 포트를 주입해도 안 걸림(HARD-STOP 2). 생성 명령이… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B14 아키텍처 규칙 +- 내용: architectureTest `AdapterBoundaryArchitectureTest.java:410-421`, `WebForbiddenTypeCatalog.java:23` — controller가 domain `Repository` 포트를 주입해도 안 걸림(HARD-STOP 2). 생성 명령이 포트를 `dev.caskeleton.domain.`에 둠(Create__Feature__UseCase.java.tmpl:13), 규칙은 `..repository..`만, web testkit은 Spring Data·JPA만. gRPC 서비스는 ARE_CONTROLLERS 밖. 고침: inbound가 domain *Repository·*IdFactory, application *StorePort·*QueryPort 못 쓰게 + fixture. 현재 inbound import 0건. + +### RR9-05-02 · High · inbound 밖 사용자 전송(bootstrap·composition controller, JWT converter)이… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B14 아키텍처 규칙 +- 내용: `ApplicationBoundaryArchitectureTest.java:759-774,736-747,822-826` — inbound 밖 사용자 전송(bootstrap·composition controller, JWT converter)이 @SystemInvoked 유스케이스에 닿아도 통과, `new`·비@SystemCaller 중간 클래스 경유도 통과(OutboxRelayScheduler.java:51). manual 07:75 "빌드 실패" 약속. "bootstrap에 controller 금지"(app AGENTS) 규칙 없음. 고침: USER_TRANSPORTS 전이 대상에 @SystemInvoked, controller는 ..adapter.inbound.. 규칙. + +### RR9-05-03 · Medium · web 밖 JWT… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B14 아키텍처 규칙 +- 내용: (a) `ApplicationBoundaryArchitectureTest.java:472-494,523-558` — web 밖 JWT converter·JwtDecoder·OAuth2TokenValidator·AuthenticationProvider·AuthorizationManager·HttpSecurity 람다 설정 못 잡음(Filter·EntryPoint·AccessDeniedHandler·BearerTokenResolver는 잡힘). 고침: spring security web·oauth2 resource server·jwt 패키지와 두 타입을 목록에 + fixture. + +### RR9-05-04 · Medium · `registration.interceptors(x)`에서 x가 구체 클래스 필드·생성자·new, ChannelInterceptor 지역… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B14 아키텍처 규칙 +- 내용: (b) `:584-587,626-627` — `registration.interceptors(x)`에서 x가 구체 클래스 필드·생성자·new, ChannelInterceptor 지역 변수, 구체 반환 @Bean이면 설정 자신 안 잡힘(ArchUnit 1.3.0 anewarray 미기록). manual 07:107 과대 약속. 고침: assignable 검사 or 문서 한계. + +### RR9-05-05 · Medium · capabilityProjects에 :adapter:inbound:messaging 없음 → 전체 ArchUnit이… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B14 아키텍처 규칙 +- 내용: `src/bootstrap/app/build.gradle:131-143` — capabilityProjects에 :adapter:inbound:messaging 없음 → 전체 ArchUnit이 MessagingInboxAutoConfiguration 안 읽음. 125줄 주석 "모든 모듈". 고침: 목록·주석 runtimeOnly 줄. + +### RR9-05-06 · Medium · 시스템 호출 쓰기가 유스케이스 계약 밖: fileserver DefaultCleanupService.java:32,… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15a application 구조 +- 내용: `FileserverUseCaseContractDeviationTest.java:22-30,42-43` — 시스템 호출 쓰기가 유스케이스 계약 밖: fileserver DefaultCleanupService.java:32, DefaultFileReconciliationService.java:28; notification NotificationDispatchService.java:49, LeaseRecoveryService.java:36, ReconciliationService.java:32, ProviderEventProjectionService.java:17. 사용자·시스템이 같은 서비스(CleanupUploadsApplicationUseCase·FileserverCleanupWorker, admin·LeaseRecoveryService). 고침: @SystemInvoked 분리 or 결정 기록 + notification freeze 시험. + +### RR9-05-07 · Medium · 연산 4개 inbound 포트, UseCase·capability·@RequiresPermission 없음, 쓰는 전송… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15a application 구조 +- 내용: `NotificationAdminService.java:9`, `NotificationAdminApplicationService.java:45` — 연산 4개 inbound 포트, UseCase·capability·@RequiresPermission 없음, 쓰는 전송 없음(NotificationDeliveryConfiguration.java:167-169), 협력 객체 12. 고침: 유스케이스 4개 or 삭제. + +### RR9-05-08 · Medium · `FileserverMaintenanceServiceConfiguration.java:27-63`(outbound adapter가… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15a application 구조 +- 내용: `FileserverMaintenanceServiceConfiguration.java:27-63`(outbound adapter가 application 서비스 조립), NotificationPlatformPolicyConfig.java:79·89-92·140(retry ofMinutes(1)·jitter를 설정에서), NotificationPlatformDispatchConfig.java:65, notification worker가 adapter.outbound.notification(NotificationSchedulerWorker.java:31). 고침: composition으로, retry 값 settings. + +### RR9-05-09 · Medium · 전송 4곳이 "upload.bin" 기본 이름(HARD-STOP 4·중복), application… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: `RawUploadRequestMapper.java:23,44` 외 MultipartUploadRequestMapper.java:16, Draft12UploadController.java:244, TusController.java:115 — 전송 4곳이 "upload.bin" 기본 이름(HARD-STOP 4·중복), application OriginalFilenamePolicy.java:16은 "file". 고침: 전송은 없음으로, 정책 한 곳. + +### RR9-05-10 · Medium · web이 outbound LiveEventReplayPort 직접 읽음(application-core AGENTS 「읽기·query 경로」).… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15a application 구조 +- 내용: `MessagingReplayBridge.java:31,68` — web이 outbound LiveEventReplayPort 직접 읽음(application-core AGENTS 「읽기·query 경로」). 고침: 조회 유스케이스 + 1번 규칙. + +### RR9-05-11 · Medium · operation id 문법 셋, owner token 64 hex(IdempotencyClaimAttempt.java:19) vs… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: `OperationId.java:24`·`LeaseValidation.java:16-20`·`DurableOperationId.java:16` — operation id 문법 셋, owner token 64 hex(IdempotencyClaimAttempt.java:19) vs base64url. 고침: 값 타입 통일 or 이유. + +### RR9-05-12 · Medium · 표시·문서만), notification… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: 멱등 판정 세 벌: durable operation SubmitDurableOperationUseCase.java:54 KEYED인데 executor 안 씀(결정 15·26 지문 방식 — 표시·문서만), notification AcceptNotificationApplicationUseCase.java:140-155·NotificationRequestRecord.java:17·NotificationRequestStorePort.java:36 원본 키 저장·자체 판정(결정 없음). 고침: executor or 결정. + +### RR9-05-13 · Low · durable operation이 core 공통 타입 안 따름: tenant·principal… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: durable operation이 core 공통 타입 안 따름: tenant·principal String(OperationCommand.java:31-32, GetDurableOperationQuery.java:14, CancelDurableOperationCommand.java:14, DurableOperationAccessPolicy.java:25), DurableOperationIdFactory·Id가 IdFactory·ResourceId 아님(AGENTS:80 예외 없음), id를 controller에서 만듦. + +### RR9-05-14 · Low · `SubmitDurableOperationUseCase.java:177-190` UUIDv7 파생을 유스케이스가 →… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: `SubmitDurableOperationUseCase.java:177-190` UUIDv7 파생을 유스케이스가 → IntegrationIdentity로. + +### RR9-05-15 · Low · 미사용 추상화: ReadConsistency.java:4(참조 0, persistence-jpa에 다른 모양 동명),… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: 미사용 추상화: ReadConsistency.java:4(참조 0, persistence-jpa에 다른 모양 동명), FileserverSpans.java(span 안 냄), ProviderEventId.java, NotificationExpiredException.java, BatchNotificationProviderAdapter.java, CollapseCapability.java(시험만). + +### RR9-05-16 · Low · application-core README.md:780 "final이 아니다", be-domain 함정 12. + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: GetDurableOperationUseCase.java:18, PublishPendingOutboxEventsUseCase.java:43 final — application-core README.md:780 "final이 아니다", be-domain 함정 12. + +### RR9-05-17 · Low · FileMetadataPort(insert·transition·markDeleting·relocate),… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: FileMetadataPort(insert·transition·markDeleting·relocate), UploadSessionPort(acquireLease·commitOffset) 실패 결과 Javadoc 없음(어댑터 JpaFileMetadata.java:146-168만). + +### RR9-05-18 · Low · `CanonicalNotificationPlanEncoder.java:73,78,262,264,265,282,299` 문자열에 NUL 바이트… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B15b application 작은 것 +- 내용: `CanonicalNotificationPlanEncoder.java:73,78,262,264,265,282,299` 문자열에 NUL 바이트 → git·grep 바이너리. 고침: "\u0000". + +### RR9-05-19 · Low · `FileserverAdminController.java:151-152,164-176` orphan apply·cleanup… + +- 출처: 물결 2 arch-reviewer +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B12 fileserver·notification HTTP +- 내용: `FileserverAdminController.java:151-152,164-176` orphan apply·cleanup 기본값(maxBytes 1<<30, reasonCode, dryRun)을 controller가 → application command 팩터리. diff --git a/docs/reviews/2026-11-12-round9-review/README.md b/docs/reviews/2026-11-12-round9-review/README.md new file mode 100644 index 00000000..bd3aeae0 --- /dev/null +++ b/docs/reviews/2026-11-12-round9-review/README.md @@ -0,0 +1,250 @@ +# round9 전체 리뷰 (2026-11-12) + +## 1. 결론 + +main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분야 전문가 스킬, CI 재편, red team 수정이 들어간 뒤)을 +새 눈으로 전체 리뷰했다. 발견 152건: Critical 0, High 2, Medium 72, Low 78. 이 밖에 CI workflow·`build.gradle`·`gates.md`처럼 +백엔드 CI 세션이 고치는 중인 파일의 발견 9건은 그 세션에 넘겼다(5절). + +- High 둘은 아키텍처 규칙의 사각지대다(HARD-STOP 2). controller가 domain repository 포트를 들어도, inbound 밖 사용자 + 전송이 `@SystemInvoked` 유스케이스에 닿아도 빌드가 통과한다(RR9-05-01·02). +- Medium의 큰 덩어리: env 계약이 registry·`.env.example`·배포 설정 사이에서 갈렸다(예시를 그대로 복사하면 JPA 배포가 + 기동하지 않는 값 포함), 공개 경로 게이트가 모듈 chain을 못 본다, 관측 registry와 코드의 지표·MDC 이름이 어긋난다, + claim·lease의 fence가 구현마다 갈렸다, 문서가 재배치 뒤 낡은 경로·명령을 가리킨다. +- 결함은 모두 고친다(`docs/work/improve.md` 4.5절). 원인 묶음마다 PR 하나다(4절). + +## 2. 범위 + +- 대상: main `a7e38c10`, 작업 트리 깨끗함, 2026-11-12. 기준 게이트: `scripts/verify.sh pr --no-cache` rc=0(desktop, 21:06~21:39). + `main` 단계는 6절에 결과를 적는다. +- 방법: `docs/work/experts.md`의 분야 렌즈로 `reviewer` 서브에이전트를 두 물결에 나눠 띄웠다(lead 스킬, 한 물결 4명). + 모든 발견은 E1(현재 커밋 코드·문서 정적 확인)이고, 고칠 때 RED 시험(수정 전 실패)으로 다시 확인한다. + +| 물결 | 렌즈 | 경로 | +| --- | --- | --- | +| 1 | be-persistence + be-messaging + be-performance | `src/adapter/outbound/**`, inbound messaging, outbox·멱등·durable operation 조립, 마이그레이션·runbook | +| 1 | be-security + be-observability | `src/bootstrap/app`, service-runtime, inbound 보안·필터, 보안·관측 registry, Dockerfile·compose | +| 1 | be-api-contract + be-testing | inbound 전송 계약, shared-contract, 계약 registry·스냅숏, 시험 품질 | +| 1 | be-build-ci + be-docs | build-logic, gradle, config, scripts, 진입 문서·`docs/**`·`.claude/**` | +| 2 | be-domain(`arch-reviewer`) | domain·application·shared-contract, HARD-STOP 1~5 전체, ArchUnit 사각지대 | +| 2 | be-persistence + be-performance + be-messaging | 물결 1이 못 본 outbound(mongo, redis-sdk, httpclient, objectstorage, notification, fileserver 등) | +| 2 | be-security + be-observability | 물결 1이 못 본 web-advanced·graphql·grpc·websocket·web-fileserver 보안, 조립 모듈, logback, auth runbook | +| 2 | be-api-contract + be-docs | web-advanced·graphql·websocket·tus 계약, 매뉴얼·runbook·모듈 README 본문 | + +- 못 본 것(두 물결이 모두 「못 본 하위 경로」로 적은 곳): redis-sdk의 programmability·cluster·reactive, persistence-mongo의 + csfle·qe·sharding, httpclient의 auth·dynamic·http3, objectstorage publication kernel 본문, web-advanced의 codec·openapi· + versioning, graphql의 cost scorer 내부. 다음 확인 리뷰가 표본으로 본다. +- 지난 라운드가 넘긴 항목: 동시 인덱스 `_ccold`(결함 아님, E1), 멱등 Redis Lua의 cluster 원자성(결함 아님, 남는 것은 + failover 내구성 RR9-01-11), `RunbookSql` lane 목록(RR9-01-10), 메시징 인증 증거 대조(이 repo에서 닫힘, 라이브러리 + repo의 일), compose smoke OOM(고쳐짐, 남은 틈 RR9-04-27), STOMP 밖 Spring Security 확장점·`registration.interceptors(x)` + 사각지대(RR9-05-03·04). + +## 3. 색인 + +| ID | 심각도 | 영역 | 내용 | 묶음 | +| --- | --- | --- | --- | --- | +| RR9-01-01 | Medium | 영속성·메시징·성능 | inbox TransactionRunner `new TransactionTemplate` timeout 없음 → 유스케이스… | B9 트랜잭션 시한·정리 | +| RR9-01-02 | Medium | 영속성·메시징·성능 | heartbeat·progress·succeed·fail이 lease_owner=:workerId만 확인, fence 없음. 같은… | B8 claim·fence | +| RR9-01-03 | Medium | 영속성·메시징·성능 | live_event_log 행 retention 지나도 안 지움, sweepExpired 호출자·스케줄 없음, 문서도 서비스 의무로 안… | B9 트랜잭션 시한·정리 | +| RR9-01-04 | Low | 영속성·메시징·성능 | 상한 없는 DELETE 한 문장(outbox는 1000행씩, OutboxEventJpaRepository.java:35-47),… | B8 claim·fence | +| RR9-01-05 | Low | 영속성·메시징·성능 | join() 시간 상한 없음,… | B10a 발행·발송·캐시 | +| RR9-01-06 | Low | 영속성·메시징·성능 | Javadoc "enqueue is an upsert"인데 UPDATE 0행이면 INSERT 두 단계, 동시 enqueue 시… | B8 claim·fence | +| RR9-01-07 | Low | 영속성·메시징·성능 | app.lock.wait-time 읽는 곳 없음(lease-ttl 교차 검사로 기동 막기만). README:559… | B9 트랜잭션 시한·정리 | +| RR9-01-08 | Low | 영속성·메시징·성능 | 408·429를 조건 없이 재시도로 적음, 코드(DefaultRetryEligibilityEngine.java:81-99,… | B10b S3·Mongo·httpclient | +| RR9-01-09 | Low | 영속성·메시징·성능 | 주석 "retention has no default on purpose"인데… | B9 트랜잭션 시한·정리 | +| RR9-01-10 | Low | 영속성·메시징·성능 | Javadoc lane 목록에 lock timeout runbook… | B9 트랜잭션 시한·정리 | +| RR9-01-11 | Low | 영속성·메시징·성능 | Redis 같은 키 재전송 안 돌린다를 조건 없이 약속, Sentinel·Cluster failover 비동기 복제 손실… | B10b S3·Mongo·httpclient | +| RR9-01-12 | Medium | 영속성·메시징·성능 | 회복이 행 잠금 없이 읽고(RecipientDeliveryJpaRepository.java:187-194) requeue 무조건… | B8 claim·fence | +| RR9-01-13 | Medium | 영속성·메시징·성능 | UPDATE … WHERE id IN (SELECT … LIMIT), 상태 조건 subquery 안만 → READ COMMITTED 재평가 안… | B8 claim·fence | +| RR9-01-14 | Medium | 영속성·메시징·성능 | poll마다 SQL 4개, PROJECTION_LAG WHERE 없음 → notification_provider_event 전체 스캔(지우는… | B9 트랜잭션 시한·정리 | +| RR9-01-15 | Medium | 영속성·메시징·성능 | ThreadPoolExecutor(1,n,LinkedBlockingQueue(4n)) 큐 찰 때까지 스레드 1, limiter 4로 큐 안… | B10a 발행·발송·캐시 | +| RR9-01-16 | Medium | 영속성·메시징·성능 | RejectedExecution을 AMBIGUOUS_SUBMISSION으로(SMTP 상태 조회 없음 → 운영자 대기),… | B10a 발행·발송·캐시 | +| RR9-01-17 | Medium | 영속성·메시징·성능 | 캐시가 대기 예산 없는 run → lane 대기 2s + commandTimeout, @param "ceiling on one cache… | B10a 발행·발송·캐시 | +| RR9-01-18 | Medium | 영속성·메시징·성능 | 캐시 값 크기 상한 없음(옛 키 폐기 env-keys.yaml:2686-2689, RedisKeyRules는 키만). 고침: encode 길이… | B10a 발행·발송·캐시 | +| RR9-01-19 | Medium | 영속성·메시징·성능 | 조건부 PUT 본문 재전송 가능 → SDK 재시도가 412 → ObjectControlConflictException,… | B10b S3·Mongo·httpclient | +| RR9-01-20 | Medium | 영속성·메시징·성능 | getMappedResults 전부 메모리 후 셈, maxResultBytes 미집행(95), query-aggregation-guide… | B10b S3·Mongo·httpclient | +| RR9-01-21 | Medium | 영속성·메시징·성능 | heap 384m을 512m tmpfs에 dump, 같은 cgroup·swap 없음 → dump 중 OOM kill 가능,… | B19 compose·Docker 운영 | +| RR9-01-22 | Low | 영속성·메시징·성능 | (넘어온 1) .env.example:193 POSITIVE_SOFT_TTL= → 빈 Duration null → setter 안 불림 →… | B2 env 계약 | +| RR9-01-23 | Low | 영속성·메시징·성능 | max-items 100을 10분 lease로 한꺼번에 claim, lease 안에 끝나는지 검사 없음(outbox… | B8 claim·fence | +| RR9-01-24 | Low | 영속성·메시징·성능 | "lease > provider 호출·timeout" 주석만, 검사 없음. | B8 claim·fence | +| RR9-01-25 | Low | 영속성·메시징·성능 | 트랜잭션 30초 상한 없음(decisions 2.5), row cap 사후 검사(inbox 건과 같은 원인). | B9 트랜잭션 시한·정리 | +| RR9-01-26 | Low | 영속성·메시징·성능 | 새 pool 크기 모른 채 합계 미만만 봄 → 상한 초과, Javadoc "would exceed". | B9 트랜잭션 시한·정리 | +| RR9-01-27 | Low | 영속성·메시징·성능 | acquire void, idle 판정 마지막 acquire 시각 → 사용 중 client 닫음, 닫기 실패가 다른 tenant… | B10b S3·Mongo·httpclient | +| RR9-01-28 | Low | 영속성·메시징·성능 | requireCurrentFence가 UNFENCED만 거름(MongoMigrationLock.java:32), refresh(166-170)… | B10b S3·Mongo·httpclient | +| RR9-01-29 | Low | 영속성·메시징·성능 | lease 만료 시계 구현마다 다름: JpaRecipientLeaseStore.java:52,117,… | B8 claim·fence | +| RR9-01-30 | Low | 영속성·메시징·성능 | compression=true면 Apache가 푼 스트림을 wire 계수기가 셈(ApacheClientFactory.java:114-116)… | B10b S3·Mongo·httpclient | +| RR9-01-31 | Low | 영속성·메시징·성능 | ProxyType.SOCKS를 HTTP 프록시로, capability… | B10b S3·Mongo·httpclient | +| RR9-02-01 | Medium | 보안·관측 | 관리 포트 기본 127.0.0.1(PR #12)인데 service-runtime/README.md:275-276·Dockerfile:221은… | B3 공개 경로·관리 포트 | +| RR9-02-02 | Medium | 보안·관측 | 최상위 `roles` 클레임 fallback을 권한에 합침. manual 07:51-53·decisions 2.6 「JWT… | B4 인증·인가 | +| RR9-02-03 | Medium | 보안·관측 | config/security.yml 한 줄만 읽음, 문서(gates.md:63, build.md:166)는 보안 체인 전체 약속.… | B3 공개 경로·관리 포트 | +| RR9-02-04 | Medium | 보안·관측 | runbook 둘이 없는 신호로 탐지:… | B7 runbook 신호 | +| RR9-02-05 | Medium | 보안·관측 | `docs/registries/metrics.yaml` 양방향 불일치: 코드 없는… | B5 관측 registry | +| RR9-02-06 | Medium | 보안·관측 | JMX 9999 무인증·무TLS, jmxremote.host 없어 모든 인터페이스. 주석 15·54 "localhost only". 고침:… | B3 공개 경로·관리 포트 | +| RR9-02-07 | Low | 보안·관측 | 18키 중 5개만 코드가 넣음(logback-spring.xml:90-94). tenant_id(77-88) required_in인데… | B5 관측 registry | +| RR9-02-08 | Low | 보안·관측 | 전송별 correlation 규칙 다름: web(WebMvcRequestIdFilter.java:189-191),… | B5 관측 registry | +| RR9-02-09 | Low | 보안·관측 | 401·403 WARN에 원본 getRequestURI(Javadoc 15-19 "only redacted"). 같은 모양… | B6a 로그 내용 | +| RR9-02-10 | Low | 보안·관측 | IP 신뢰 문서 둘: application-local.yml:120-121 "framework via… | B6b 비밀·IP 문서 | +| RR9-02-11 | Low | 보안·관측 | config/security.yml:23 `SECURITY_PUBLIC_PATHS`, config/runtime.yml:18… | B2 env 계약 | +| RR9-02-12 | Low | 보안·관측 | masking_rule full_except_last_4 구현 없음(LogMaskingPatterns.java:23-41 URI… | B6b 비밀·IP 문서 | +| RR9-02-13 | Low | 보안·관측 | 로컬 비밀 기본값 `__LOCAL_DEV_` 규칙 미준수: compose.yaml:108·158, application-local.yml:55… | B6b 비밀·IP 문서 | +| RR9-02-14 | Low | 보안·관측 | "The standalone sample does that." 지운 샘플(ab5982e9). 최근. | B6b 비밀·IP 문서 | +| RR9-02-15 | Low | 보안·관측 | main 호출자 없음, WebMvcRequestIdFilter.java:182-188이 버린 규칙. 고침: 클래스·시험·README:511… | B6a 로그 내용 | +| RR9-02-16 | Medium | 보안·관측 | 인증 없는 모르는 profile POST → ISE → GlobalExceptionHandler.java:213… | B4 인증·인가 | +| RR9-02-17 | Medium | 보안·관측 | root 좌표만 판정, GraphQlAuthorizationPolicy.java:11-16 builder는 User.salary 하위 좌표… | B4 인증·인가 | +| RR9-02-18 | Medium | 보안·관측 | @RequiresPermission web만: gRPC principal을… | B4 인증·인가 | +| RR9-02-19 | Medium | 보안·관측 | 모든 projection을 /topic 하나로 모든 인증 세션에, tenant·소유자 판정 없음, README 「한계」 95-106 없음.… | B11b graphql·websocket 계약 | +| RR9-02-20 | Medium | 보안·관측 | SPRING_PROFILES_ACTIVE=test면 배포 jar 통과 → prod 검사 모두 꺼짐(SecretSourceValidator… | B4 인증·인가 | +| RR9-02-21 | Medium | 보안·관측 | INFO 이하 로거 구분 없이 버림, 감사 로거 INFO(LoggingNotificationAudit.java:31,… | B6a 로그 내용 | +| RR9-02-22 | Medium | 보안·관측 | 예외 통째 로그 → SQL·제약·값, 전송은 ServerFailureLog.of(ServerFailureLog.java:59-63). 고침:… | B6a 로그 내용 | +| RR9-02-23 | Medium | 보안·관측 | sub 없는 토큰 idpUserId=null → FileAccessSubject.java:24,… | B4 인증·인가 | +| RR9-02-24 | Low | 보안·관측 | 금지 값; auth-kid-unknown.md:25, auth-token-rotation-failure.md:29 없는 JWKS 손잡이;… | B7 runbook 신호 | +| RR9-02-25 | Low | 보안·관측 | `WebSocketConfig.java:93` 주석 틀림(거부 preSend… | B6a 로그 내용 | +| RR9-02-26 | Low | 보안·관측 | 컨텍스트 속성만 바꿈, logback-spring.xml:89,122 ${APP_PROFILE}은 이미 치환 → JSON profile 칸… | B6a 로그 내용 | +| RR9-02-27 | Low | 보안·관측 | in-process lock 미계량 → lock.acquisition 0, metrics.yaml:307 "1:1",… | B5 관측 registry | +| RR9-02-28 | Low | 보안·관측 | "서버 허용 목록 이름이라 echo 안전"인데 요청 값 echo(PatchFieldAuthorization.java:59,… | B4 인증·인가 | +| RR9-02-29 | Low | 보안·관측 | tenant 규칙 갈림: WebTenantContextResolver.java:19-20 거부 목록에 tenant_id 없음,… | B4 인증·인가 | +| RR9-02-30 | Low | 보안·관측 | `compose/redis/acl/README.md:43` advanced 계정 pub/sub 더함, 실제… | B19 compose·Docker 운영 | +| RR9-02-31 | Low | 보안·관측 | `GraphQlClientPolicy.java:24` maxInputListElements "한 input list 상한"인데… | B11b graphql·websocket 계약 | +| RR9-03-01 | Medium | API 계약·시험 | 부분 실패 batch가 success:true + data.results. fullySucceeded() 미사용. 약속 충돌: web… | B12 fileserver·notification HTTP | +| RR9-03-02 | Medium | API 계약·시험 | partial() error.message 영어 고정, BulkItemResult 호출자 문구 그대로·null 키 남김(mix-in 아님,… | B12 fileserver·notification HTTP | +| RR9-03-03 | Medium | API 계약·시험 | 실제 long maxAgeSeconds(CorsSettings.java:19-20, config/security.yml:54) → 예시 그대로… | B2 env 계약 | +| RR9-03-04 | Medium | API 계약·시험 | env-keys.yaml:2563-2577·2670-2684… | B2 env 계약 | +| RR9-03-05 | Medium | API 계약·시험 | docs/registries/headers.yaml:16,154 X-Request-Id·X-Correlation-Id type ulid(코드… | B5 관측 registry | +| RR9-03-06 | Medium | API 계약·시험 | 서버 포화를 전송마다 다른 코드: gRPC GrpcCallAdmission.java:82-83 RATE_LIMIT_EXCEEDED("요청이… | B13 전송 오류 코드 | +| RR9-03-07 | Medium | API 계약·시험 | 27개 중 23개 계약 문서에 없음, docs/fileserver/http-contract.md:79 예시 "data":… | B12 fileserver·notification HTTP | +| RR9-03-08 | Medium | API 계약·시험 | grpc README.md:26-28 "전용 APP_* 키 registry에 없다"인데 APP_GRPC_SERVER_ENABLED… | B2 env 계약 | +| RR9-03-09 | Medium | API 계약·시험 | Content-Range(MvcDownloadResponseWriter.java:43,… | B12 fileserver·notification HTTP | +| RR9-03-10 | Low | API 계약·시험 | MANAGEMENT_SERVER_ADDRESS registry 있음·.env.example 없음(R2-1 일부). 최근(#12). | B2 env 계약 | +| RR9-03-11 | Low | API 계약·시험 | OPERATION_NOT_FOUND(operation/OperationErrorCode.java) §4에 없음(decisions 2.3 「새… | B13 전송 오류 코드 | +| RR9-03-12 | Low | API 계약·시험 | 모든 503이 REQUEST_TIMEOUT(retryable). §4는 비동기 시간 초과에만. 이전부터. | B13 전송 오류 코드 | +| RR9-03-13 | Low | API 계약·시험 | 모르는 channel·slot·locale이 details 없는 BAD_PARAMETER(주석은 validation error, S4는… | B12 fileserver·notification HTTP | +| RR9-03-14 | Low | API 계약·시험 | ERROR frame code만(category·retryable 없음), 원인 사슬 어디 IAE든 BAD_PARAMETER(다른 전송은 실패… | B11b graphql·websocket 계약 | +| RR9-03-15 | Low | API 계약·시험 | Retry-After를 occurrence만 보고 붙임, 본문은 코드 값으로 좁힘(ErrorResponseFactory.java:42) →… | B12 fileserver·notification HTTP | +| RR9-03-16 | Low | API 계약·시험 | 낡은 문서: GrpcStatusMapper.java:21 WORKLOG_NOT_FOUND 예시(ab5982e95 이후), graphql 스냅숏… | B13 전송 오류 코드 | +| RR9-03-17 | Medium | API 계약·시험 | test에서 태그 없이 env-keys.yaml 읽음, modules.json 거슬러 ca.repository.root 가드 우회, 입력… | B16 시험 품질 | +| RR9-03-18 | Medium | API 계약·시험 | "값을 싣지 않는다" 단언에 예외 타입 없음 → 메시지 null NPE로 바꿔도 통과. 이전부터. | B16 시험 품질 | +| RR9-03-19 | Low | API 계약·시험 | 빈 목록이면 통과, GWT 없음. 고침: 메서드 목록 고정. 최근(#12 bb8bb31b9). | B16 시험 품질 | +| RR9-03-20 | Low | API 계약·시험 | MvcUploadExecutorSaturationTest.java:112-121(이름 timeout인데 타입만), :45 sleep(200),… | B16 시험 품질 | +| RR9-03-21 | Low | API 계약·시험 | EnvelopeWireShapeTest | B16 시험 품질 | +| RR9-03-22 | Low | API 계약·시험 | 영어 @DisplayName 381/940, // when 없는 3문장+ 테스트 약 890/1550(휴리스틱). 규칙은 "손댈 때 고침" →… | B16 시험 품질 | +| RR9-03-23 | Medium | API 계약·시험 | web-advanced patch 위반이 세 코드(PATCH_REJECTED 400 / BAD_PARAMETER 400 IAE /… | B11a web-advanced 계약 | +| RR9-03-24 | Medium | API 계약·시험 | "결과를 문서 전체로 검증 후 적용" 약속, 검증기 안 받음. | B11a web-advanced 계약 | +| RR9-03-25 | Medium | API 계약·시험 | sequence 엄격 증가·heartbeat·idle·max-age·버퍼 상한·drain 재연결 약속, writer 아무것도 안… | B11a web-advanced 계약 | +| RR9-03-26 | Medium | API 계약·시험 | commit 뒤 실패 코드 DEPENDENCY_FAILURE 고정(registry·WebAdvancedError·§4 없음),… | B11a web-advanced 계약 | +| RR9-03-27 | Medium | API 계약·시험 | 503+Retry-After 약속, guard bean만, 요청 경로에서 run 안 부름(manual 10 기준 3). | B11a web-advanced 계약 | +| RR9-03-28 | Medium | API 계약·시험 | 정본 충돌 → 소유자 결정. | B11a web-advanced 계약 | +| RR9-03-29 | Medium | API 계약·시험 | Javadoc "Stable request-error code GRAPHQL_CURSOR_REJECTED"인데 플랫폼 거부·carrier 아님… | B11b graphql·websocket 계약 | +| RR9-04-01 | Medium | 빌드·문서 | #12가 줄 더해 151/150, check-work-docs rc=1 → verify.sh docs·라운드 끝 실패. 같은 줄 "(W4… | B1 문서·지침 | +| RR9-04-02 | Medium | 빌드·문서 | `cd ~/workspace/<작업>/src` 뒤 ./gradlew(#10 뒤 src에 gradlew 없음). desktop-gates… | B1 문서·지침 | +| RR9-04-03 | Medium | 빌드·문서 | "Gradle 루트가 src/라 두 단계 위", `--include-build ../../messaging-library` →… | B1 문서·지침 | +| RR9-04-04 | Medium | 빌드·문서 | 이름 바꾸기 `git grep -l 'dev\.caskeleton' -- src scripts`가 build.gradle:26,… | B18a 스크립트 | +| RR9-04-05 | Medium | 빌드·문서 | 없는 PublicPathSnapshotPlugin.java·updatePublicPathSnapshot, 없는 CI step. 고침:… | B3 공개 경로·관리 포트 | +| RR9-04-06 | Medium | 빌드·문서 | `:app-bootstrap:test --tests '*CleanArchitectureTest'` 고르는 클래스… | B17 빌드 | +| RR9-04-07 | Medium | 빌드·문서 | `docs/work/experts.md:56-66` 3절 표가 스킬 paths와 갈림(be-build-ci… | B1 문서·지침 | +| RR9-04-08 | Medium | 빌드·문서 | 행이 코드와 다르고 「바뀜」 표시 없음: 64 docs-check workflow 없음, 193 build-logic 잠그지 않음 vs… | B1 문서·지침 | +| RR9-04-09 | Medium | 빌드·문서 | 단계 구성표 네 곳: docs/testing/TESTING_STRATEGY.md:146-148(틀림,… | B18b 문서 본문 | +| RR9-04-10 | Medium | 빌드·문서 | 33·36 지운… | B18b 문서 본문 | +| RR9-04-11 | Medium | 빌드·문서 | nightly jpa-postgresql·release jpa-release-gate. 고침: digest. 이전부터. | B17 빌드 | +| RR9-04-12 | Medium | 빌드·문서 | 모든 ca.spring-library leaf(30) testImplementation에… | B17 빌드 | +| RR9-04-13 | Low | 빌드·문서 | `gradle/libs.versions.toml` 미사용 칸: 120 errorprone-core, 121 findsecbugs-plugin,… | B17 빌드 | +| RR9-04-14 | Low | 빌드·문서 | "쓰는 lane만 다시 돈다"인데 JavaConventionsPlugin.java:279-288이 파일 전체를 모든 leaf 모든 Test… | B17 빌드 | +| RR9-04-15 | Low | 빌드·문서 | 없는 클래스… | B17 빌드 | +| RR9-04-16 | Low | 빌드·문서 | `src/adapter/outbound/notification/build.gradle:104` additionalSourceRoots 상대… | B17 빌드 | +| RR9-04-17 | Low | 빌드·문서 | 검사 스크립트 정비: check-repo-layout.py:90-96 HISTORY_PREFIXES 없는 폴더… | B18a 스크립트 | +| RR9-04-18 | Low | 빌드·문서 | docstring 낡음: check-docs.py:2,18,41 "검사 여섯"(여덟), check-work-docs.py:31 lychee… | B18a 스크립트 | +| RR9-04-19 | Low | 빌드·문서 | `docs/README.md:187` "PR마다 workflow docs-check" → pr.yml done → :prCheck →… | B1 문서·지침 | +| RR9-04-20 | Low | 빌드·문서 | 기본 조립: docs/build.md:50-56·scripts/bootstrap-local.sh:12-14,42 "app 기동(Flyway… | B18b 문서 본문 | +| RR9-04-21 | Low | 빌드·문서 | `docs/roadmap/messaging-r2.md:45,48` 지운… | B18b 문서 본문 | +| RR9-04-22 | Low | 빌드·문서 | #13이 합친 integration job을 가리킴: cache-redis/README.md:332,… | B18b 문서 본문 | +| RR9-04-23 | Low | 빌드·문서 | bootstrap-local.sh를 flock으로 직접(:33 ./gradlew --no-daemon 없음), "4.1절의 정리법"… | B1 문서·지침 | +| RR9-04-24 | Low | 빌드·문서 | `CLAUDE.md:8` "분야 지식 be-* 10개" 개수 복사(함정 6). 최근 #14. | B1 문서·지침 | +| RR9-04-25 | Low | 빌드·문서 | `renovate.json:9,17` "either bot"·GitHub vulnerability alerts 전제, Gitea에서… | B18b 문서 본문 | +| RR9-04-26 | Low | 빌드·문서 | `scripts/run-compose-runtime-smoke.sh:388` lane마다 정적 계약 전체 재실행(compose config… | B18a 스크립트 | +| RR9-04-27 | Low | 빌드·문서 | handoff --force-recreate가 1단계 재시작 수 지움, ps -a -q 빈 결과면 restarts.txt 비고 || true로… | B18a 스크립트 | +| RR9-04-28 | Medium | 빌드·문서 | graphql AGENTS·README가 「모듈별 yml 금지」라 하지만 모듈이 config/graphql.yml을 읽는다 | B18b 문서 본문 | +| RR9-04-29 | Medium | 빌드·문서 | `.env.example`의 APP_DATASOURCE_CONNECTION_TIMEOUT=5s는 registry가 기동 실패라 적은 값이다 | B2 env 계약 | +| RR9-04-30 | Medium | 빌드·문서 | `.env.example`의 FORWARD_HEADERS_STRATEGY=native가 registry 기본 none과 다르다 | B2 env 계약 | +| RR9-04-31 | Low | 빌드·문서 | `.env.example` 머리말 「Seven values」가 여섯만 나열하고, 폐기 키 48개에 값이 들어 있다 | B2 env 계약 | +| RR9-04-32 | Medium | 빌드·문서 | cache-redis README가 운영 비밀로 폐기 키 넷을 넣으라고 한다 | B2 env 계약 | +| RR9-04-33 | Medium | 빌드·문서 | 지식 스킬 넷이 재배치 뒤에도 「명령은 src/에서」라고 한다 | B1 문서·지침 | +| RR9-04-34 | Low | 빌드·문서 | docs/web/runbook.md:37,49,56-58 TTL "연산마다"(전역 APP_IDEMPOTENCY_TTL),… | B7 runbook 신호 | +| RR9-04-35 | Low | 빌드·문서 | docs/web/repository-adaptation.md:146-162 "앱은 애플리케이션 칸 강제 안 함" vs… | B18c 낡은 이름·leaf 안내 | +| RR9-04-36 | Low | 빌드·문서 | openapi-32-compatibility.md가 아무도 만들지 않는 3.1.2 산출물·snapshot 불변식을 적는다 | B18c 낡은 이름·leaf 안내 | +| RR9-04-37 | Low | 빌드·문서 | 없는 metric·행 가리키는 runbook: authz-cross-tenant-violation.md:38,67,… | B7 runbook 신호 | +| RR9-04-38 | Low | 빌드·문서 | 옮기거나 바꾼 타입: persistence-jpa/README.md:43 OutboxConfig,… | B18c 낡은 이름·leaf 안내 | +| RR9-04-39 | Low | 빌드·문서 | 지운 샘플: defect-patterns.md:68 SampleDemoProfilesStartupSystemTest,… | B18c 낡은 이름·leaf 안내 | +| RR9-04-40 | Low | 빌드·문서 | graphql AGENTS.md:23-33·README.md:186 "messaging leaf registry 등록, 두 패턴… | B18c 낡은 이름·leaf 안내 | +| RR9-04-41 | Low | 빌드·문서 | graphql AGENTS.md:19·README.md:183 "366개 java 파일"(246), AGENTS.md:160 "23… | B18c 낡은 이름·leaf 안내 | +| RR9-04-42 | Low | 빌드·문서 | leaf 안내 공백: application-notification·-fileserver·-objectstorage 가장 가까운 AGENTS가… | B18c 낡은 이름·leaf 안내 | +| RR9-05-01 | High | 계층·도메인·SRP | controller가 domain `Repository` 포트를 주입해도 안 걸림(HARD-STOP 2). 생성 명령이… | B14 아키텍처 규칙 | +| RR9-05-02 | High | 계층·도메인·SRP | inbound 밖 사용자 전송(bootstrap·composition controller, JWT converter)이… | B14 아키텍처 규칙 | +| RR9-05-03 | Medium | 계층·도메인·SRP | web 밖 JWT… | B14 아키텍처 규칙 | +| RR9-05-04 | Medium | 계층·도메인·SRP | `registration.interceptors(x)`에서 x가 구체 클래스 필드·생성자·new, ChannelInterceptor 지역… | B14 아키텍처 규칙 | +| RR9-05-05 | Medium | 계층·도메인·SRP | capabilityProjects에 :adapter:inbound:messaging 없음 → 전체 ArchUnit이… | B14 아키텍처 규칙 | +| RR9-05-06 | Medium | 계층·도메인·SRP | 시스템 호출 쓰기가 유스케이스 계약 밖: fileserver DefaultCleanupService.java:32,… | B15a application 구조 | +| RR9-05-07 | Medium | 계층·도메인·SRP | 연산 4개 inbound 포트, UseCase·capability·@RequiresPermission 없음, 쓰는 전송… | B15a application 구조 | +| RR9-05-08 | Medium | 계층·도메인·SRP | `FileserverMaintenanceServiceConfiguration.java:27-63`(outbound adapter가… | B15a application 구조 | +| RR9-05-09 | Medium | 계층·도메인·SRP | 전송 4곳이 "upload.bin" 기본 이름(HARD-STOP 4·중복), application… | B12 fileserver·notification HTTP | +| RR9-05-10 | Medium | 계층·도메인·SRP | web이 outbound LiveEventReplayPort 직접 읽음(application-core AGENTS 「읽기·query 경로」).… | B15a application 구조 | +| RR9-05-11 | Medium | 계층·도메인·SRP | operation id 문법 셋, owner token 64 hex(IdempotencyClaimAttempt.java:19) vs… | B15b application 작은 것 | +| RR9-05-12 | Medium | 계층·도메인·SRP | 표시·문서만), notification… | B15b application 작은 것 | +| RR9-05-13 | Low | 계층·도메인·SRP | durable operation이 core 공통 타입 안 따름: tenant·principal… | B15b application 작은 것 | +| RR9-05-14 | Low | 계층·도메인·SRP | `SubmitDurableOperationUseCase.java:177-190` UUIDv7 파생을 유스케이스가 →… | B15b application 작은 것 | +| RR9-05-15 | Low | 계층·도메인·SRP | 미사용 추상화: ReadConsistency.java:4(참조 0, persistence-jpa에 다른 모양 동명),… | B15b application 작은 것 | +| RR9-05-16 | Low | 계층·도메인·SRP | application-core README.md:780 "final이 아니다", be-domain 함정 12. | B15b application 작은 것 | +| RR9-05-17 | Low | 계층·도메인·SRP | FileMetadataPort(insert·transition·markDeleting·relocate),… | B15b application 작은 것 | +| RR9-05-18 | Low | 계층·도메인·SRP | `CanonicalNotificationPlanEncoder.java:73,78,262,264,265,282,299` 문자열에 NUL 바이트… | B15b application 작은 것 | +| RR9-05-19 | Low | 계층·도메인·SRP | `FileserverAdminController.java:151-152,164-176` orphan apply·cleanup… | B12 fileserver·notification HTTP | + +같은 결함을 두 리뷰어가 적은 것은 하나로 셌다(영역 문서 「출처」에 둘 다 적음). + +## 4. 묶음 + +원인 묶음마다 브랜치 하나·PR 하나다. 묶음의 발견 목록은 위 색인의 「묶음」 칸이다. + +| 묶음 | 브랜치 | 상태 | +| --- | --- | --- | +| B1 문서·지침 | `claude/r9-docs-work` | PR #16 | +| B2 env 계약 | `claude/r9-env-keys` | 진행 | +| B3 공개 경로·관리 포트 | `claude/r9-public-surface` | 진행 | +| B9 트랜잭션 시한·정리 | `claude/r9-tx-timeouts` | 진행(R1-1 먼저) | +| B14 아키텍처 규칙 | `claude/r9-arch-rules` | 진행 | +| B18c 낡은 이름·leaf 안내 | `claude/r9-stale-names` | 진행 | +| 나머지(B4~B8, B10~B13, B15~B19) | — | 대기 | + +## 5. 다른 세션에 넘긴 것 + +백엔드 CI 세션(workflow·루트 `build.gradle`·`gates.md`·`verify.sh`·`scripts/ci/**`·`template-vs-consumer.md`·redis-sdk +compose README를 고치는 중)에 9건을 넘겼다(2026-11-12). 그 세션 PR이 병합되면 확인 리뷰가 본다. + +1. [Medium] docs 단계(`check-work-docs.py`)가 어느 workflow에서도 돌지 않는데 문서는 「`prCheck` 안」이라 한다 + (`gates.md:17`, `verify.sh:7`, `build.gradle:196-198·218-233`). +2. [Low] `verify.sh:9`의 PR job 이름(`gradle` → `done`). +3. [Low] `build.gradle:11`「JMH leaf 셋」, `:147-150`「leaf 다섯 중첩 빌드」. +4. [Low] `release.yml:31-32`「ci를 다시 돌리지 않는다」와 재실행 job들. +5. [Low] `main.yml:100` lychee 범위(`src/**/CLAUDE.md`만, `AGENTS.md` 빠짐), `gates.md:86`. +6. [Low] `gates.md:115`의 desktop 직접 실행과 `redis-topology.sh:88` `--no-daemon` 없음, `gates.md:193` digest 문장. +7. [Low] `redis-sdk/compose/README.md:94-96` 필수 클래스 수. +8. [Low] `template-vs-consumer.md:20`(object-storage-aws를 nightly로), `:39`. +9. [Low] (1과 같은 원인의 문서 쪽 `operate.md`는 B1이 고침) + +## 6. 결정이 필요한 것 + +소유자 결정이 필요한 항목은 소유자 지시(중간 승인 없이 권하는 안으로 진행)대로 권하는 안을 적용하고, PR 본문 +「정한 기본값」과 여기에 남긴다. 소유자가 뒤집을 수 있다. + +| # | 항목 | 권하는 안 | +| --- | --- | --- | +| ① | RR9-03-01 batch 부분 실패 응답: web AGENTS B8·http-contract(`success:false`+`BATCH_PARTIAL_FAILURE`) vs fileserver 계약(200+`results[].error`) | 공용 B8로 맞춘다. upgrade 안내 행 | +| ② | RR9-03-06 서버 포화 오류 코드가 전송마다 다르다 | 서버 포화는 공용 코드 하나(503, retryable, `Retry-After`), 호출자 빈도 초과만 429 | +| ③ | RR9-03-28 merge patch: web AGENTS B2 「쓰지 않는다」 vs patch-contract 「필드 변경은 merge patch」 | patch-contract를 정본으로, web AGENTS B2가 그쪽을 가리킨다 | +| ④ | RR9-03-22 영어 `@DisplayName`·`// when` 없는 시험의 일괄 전환 | 규칙 그대로(고치는 시험에 적용). 일괄 전환하지 않고 결정 색인에 적는다 | +| ⑤ | RR9-05-12 notification 멱등 판정이 executor와 다르다 | 근거를 보고 executor로 옮기거나 결정으로 기록 — 묶음이 고른다 | +| ⑥ | env 이름 `SECURITY_PUBLIC_PATHS`·`PRESENTATION_API_BASE_PATH`의 `APP_` 접두 | 지금 이름 그대로 registry에 등록(바꾸면 파생 서비스 배포 env가 소리 없이 무시됨). 이름 변경은 소유자 결정 | + +## 7. 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) + +1. 마지막 확인 리뷰 발견 0: 아님. 이 라운드 152건을 고친 뒤 확인 리뷰(독립 리뷰어 둘)가 판정한다. +2. 열린 「Declined to judge」 0: 참. 판정을 미룬 항목은 없다. 못 본 경로는 2절에 적었다. +3. 합친 트리의 라운드 끝 게이트: 아직. 묶음을 합친 뒤 돈다. +4. README의 남은 항목 0: 아님. 4절의 대기 묶음과 6절의 결정이 남았다.