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 index d29e3040..d5ee2d01 100644 --- a/docs/reviews/2026-11-12-round9-review/03-contract-testing.md +++ b/docs/reviews/2026-11-12-round9-review/03-contract-testing.md @@ -226,3 +226,31 @@ - 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 - 묶음: B18c 낡은 이름·leaf 안내 - 내용: `NotificationCallbackMvcController`는 204·400·413·503을 본문 없이 답한다. `docs/web/http-contract.md` §1과 `docs/fileserver/http-contract.md` 「Envelope 규칙의 프로토콜 예외」는 Envelope가 아닌 응답을 fileserver 프로토콜 예외뿐인 것처럼 적는다. 고침: 동작은 그대로 두고(provider는 status만 읽고, 인증 전 경로라 이유를 싣지 않는다) 예외로 적는다. 6절 ⑦. + +### RR9-03-33 · Medium · 불변 Set capability로 만든 objectstorage 요청이 NullPointerException을 낸다 + +- 출처: 고치며 찾음(B20 포트 계약 첫 실행, 2026-11-13) +- 증거: E2(desktop 실행: 계약 시험이 fake·adapter 모두 `ObjectRequestSupport.immutableCapabilities`의 NPE로 실패) · 이전부터 +- 묶음: B20 objectstorage 포트 계약 +- 내용: `src/application/objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRequestSupport.java`가 null 원소를 거르려고 `capabilities.contains(null)`을 불렀다. JDK 불변 Set(`Set.of`, `Set.copyOf`)은 `contains(null)`에서 false 대신 NPE를 던진다. 지금 호출자가 모두 `EnumSet`을 넘겨 드러나지 않았다. 고침: 원소를 하나씩 본다. + +### RR9-03-34 · Medium · adapter 전용 예외가 objectstorage 포트 밖으로 나간다 + +- 출처: 고치며 찾음(B20 새 눈 리뷰, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B21 objectstorage 포트 예외 +- 내용: routing adapter(`RoutingObjectReadAdapter`, `RoutingObjectMutationAdapter`, `RoutingObjectScanMaintenanceAdapter`)가 운영 bean으로 그대로 노출되고, provider의 `ObjectStorageProviderException`(adapter 패키지)을 감싸지 않고 던진다(바이트 불일치, consumer 실패, IO 실패). 포트를 쓰는 유스케이스가 adapter 타입을 잡아야 하거나 RuntimeException으로만 다룬다. 포트 계약도 그 경우는 unchecked 예외까지만 단언한다. 겹친 managed 게시에서 `PUBLISHED`로 바꾸기 직전에 다른 호출에 진 쪽도 `REPLAYED`가 아니라 adapter의 `ObjectControlConflictException`을 받는다(B20 3차 리뷰). 고침: 포트 수준 예외 타입을 두고 routing adapter가 포트 경계에서 바꾼다. + +### RR9-03-35 · Low · 실패 뒤 다시 한 managed 게시가 REPLAYED로 답한다 + +- 출처: 고치며 찾음(B20 새 눈 리뷰, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B20 objectstorage 포트 계약 +- 내용: `ManagedObjectPublicationKernel`이 예약 결과만 보고 REPLAYED를 정해, 실패한 시도를 이어 이번 호출이 게시해도 REPLAYED였다. stage 재시도는 APPLIED라 둘이 달랐다. 고침: PUBLISHED로 바꾼 호출 하나만 APPLIED(같은 key로 겹친 호출은 REPLAYED, `ManagedPublicationOutcomeTest`). + +### RR9-03-36 · Medium · main 단계 lane의 벽시계 시험이 부하 아래에서 흔들린다 + +- 출처: 고치며 찾음(main 단계 실패 run 추적, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B22 벽시계 시험 +- 내용: 시간 한도를 재는 시험이 준비 시간까지 재거나, 한도와 거의 같은 상한을 두거나, `sleep`으로 서버 처리 시간을 흉내 냈다. CPU가 바쁜 runner에서는 원인과 상관없이 시간만 넘겨 실패한다. 대상은 httpclient `FailureInjectionContractTest`·`AttemptDeadlineTest`, gRPC `GrpcP1BoundaryWireTest`·`GrpcServerRunnerBootTest`, graphql `GraphQlRequestDeadlineTest`, persistence-jpa lock·migration 시험, cache-redis lease 시험이다. 고침: 원인(타입·SQLSTATE·`lock_timeout`)을 먼저 단언하고, 재는 구간에서 준비를 빼고, 상한은 주장을 가를 만큼 넉넉히 두고, 서버 쪽 대기는 latch gate로 바꾼다. 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 index 3b5fde3d..fabab9e2 100644 --- a/docs/reviews/2026-11-12-round9-review/04-build-docs.md +++ b/docs/reviews/2026-11-12-round9-review/04-build-docs.md @@ -317,3 +317,17 @@ - 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 - 묶음: B18c 낡은 이름·leaf 안내 - 내용: `src/adapter/outbound/objectstorage/README.md` 「env 키」가 「전용 `APP_*` 키는 없다」고 하지만 `docs/registries/env-keys.yaml`에 `APP_OBJECTSTORAGE_ENABLED`가 있다. 고침: 그 키 하나를 적는다. + +### RR9-04-46 · Low · capability-status가 objectstorage를 MinIO로 조립한다고 적는다 + +- 출처: 고치며 찾음(B20 조사, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B20 objectstorage 포트 계약 +- 내용: `docs/capability-status.md` Object storage 증거 칸이 「`app-bootstrap:integrationTest` assembles it against digest-pinned MinIO」라고 적는다. 실제 시험(`ObjectStorageCompositionIntegrationTest`)은 local-dev provider로 조립하고 bootstrap 통합 시험에 MinIO는 없다. 고침: 실제 조립과 MinIO provider 계약 lane을 나눠 적는다. + +### RR9-04-47 · Low · 순수성 검사가 순수 모듈의 testFixturesCompileOnly를 보지 않는다 + +- 출처: 고치며 찾음(B20 구조 리뷰, 2026-11-13) +- 증거: E2(desktop 실행: 기준 플러그인에서 `testFixturesCompileOnly`에 Spring을 둔 functional fixture가 순수성 검사를 통과) · 이전부터 +- 묶음: B20 objectstorage 포트 계약 +- 내용: `build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitecturePlugin.java`가 순수 모듈의 compile·runtime·test classpath만 풀었다. testFixtures를 쓰는 순수 leaf 다섯 곳에서 fixtures에 framework를 compileOnly로 두면 통과했다. 고침: testFixtures classpath 둘도 같은 금지 group으로 본다. diff --git a/docs/reviews/2026-11-12-round9-review/README.md b/docs/reviews/2026-11-12-round9-review/README.md index ef6c2c03..1960daaa 100644 --- a/docs/reviews/2026-11-12-round9-review/README.md +++ b/docs/reviews/2026-11-12-round9-review/README.md @@ -3,7 +3,7 @@ ## 1. 결론 main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분야 전문가 스킬, CI 재편, red team 수정이 들어간 뒤)을 -새 눈으로 전체 리뷰했다. 발견 152건: Critical 0, High 2, Medium 72, Low 78. 고치며 6건(Medium 2, Low 4)을 더 찾아 모두 158건이다. 이 밖에 CI workflow·`build.gradle`·`gates.md`처럼 +새 눈으로 전체 리뷰했다. 발견 152건: Critical 0, High 2, Medium 72, Low 78. 고치며 12건(Medium 5, Low 7)을 더 찾아 모두 164건이다. 이 밖에 CI workflow·`build.gradle`·`gates.md`처럼 백엔드 CI 세션이 고치는 중인 파일의 발견 9건은 그 세션에 넘겼다(5절). - High 둘은 아키텍처 규칙의 사각지대다(HARD-STOP 2). controller가 domain repository 포트를 들어도, inbound 밖 사용자 @@ -138,6 +138,10 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 | RR9-03-30 | Medium | API 계약·시험 | compose 병합 특성 시험이 어느 lane에서도 돌지 않았다 | B19 compose·Docker 운영 | | RR9-03-31 | Medium | API 계약·시험 | application-objectstorage에 포트 계약 시험이 없다(manual 10 기준 5) | B20 objectstorage 포트 계약 | | RR9-03-32 | Low | API 계약·시험 | 알림 provider callback의 본문 없는 응답이 Envelope 예외로 적혀 있지 않다 | B18c 낡은 이름·leaf 안내 | +| RR9-03-33 | Medium | API 계약·시험 | 불변 Set capability로 만든 objectstorage 요청이 NullPointerException을 낸다 | B20 objectstorage 포트 계약 | +| RR9-03-34 | Medium | API 계약·시험 | adapter 전용 예외가 objectstorage 포트 밖으로 나간다 | B21 objectstorage 포트 예외 | +| RR9-03-35 | Low | API 계약·시험 | 실패 뒤 다시 한 managed 게시가 REPLAYED로 답한다 | B20 objectstorage 포트 계약 | +| RR9-03-36 | Medium | API 계약·시험 | main 단계 lane의 벽시계 시험이 부하 아래에서 흔들린다 | B22 벽시계 시험 | | 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 문서·지침 | @@ -183,6 +187,8 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 | RR9-04-43 | Low | 빌드·문서 | persistence-jpa release registry가 아무도 읽지 않는 PostgreSQL tag를 적는다 | B17 빌드 정리 | | RR9-04-44 | Low | 빌드·문서 | web 한도 표가 아무도 막지 않는 칸을 「늘 애플리케이션」이라 적는다 | B18c 낡은 이름·leaf 안내 | | RR9-04-45 | Low | 빌드·문서 | objectstorage README가 registry에 있는 env 키를 「없다」고 한다 | B18c 낡은 이름·leaf 안내 | +| RR9-04-46 | Low | 빌드·문서 | capability-status가 objectstorage를 MinIO로 조립한다고 적는다 | B20 objectstorage 포트 계약 | +| RR9-04-47 | Low | 빌드·문서 | 순수성 검사가 순수 모듈의 testFixturesCompileOnly를 보지 않는다 | B20 objectstorage 포트 계약 | | 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 아키텍처 규칙 | @@ -209,6 +215,10 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 원인 묶음마다 브랜치 하나·PR 하나다. 묶음의 발견 목록은 위 색인의 「묶음」 칸이다. +runner 대기를 풀려고 PR #17·#19~#27은 main `d3a90479` 위에 차례로 합친 트리 하나(PR #28)로 한 번 검사하고 +#28로 함께 병합했다(2026-11-13, main `3d31896a`, run 218 `pr / done` 초록). 아래 PR 번호는 그 묶음의 원래 PR이고, +각 PR은 「#28로 병합됨」 댓글을 달고 닫았다. + | 묶음 | 브랜치 | 상태 | | --- | --- | --- | | B1 문서·지침 | `claude/r9-docs-work` | PR #16 | @@ -218,10 +228,12 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 | B14 아키텍처 규칙 | `claude/r9-arch-rules` | PR #19 | | B18c 낡은 이름(RR9-04-38~41) | `claude/r9-stale-names` | PR #22 | | B19 compose·Docker 운영(RR9-01-21, RR9-03-30) | `claude/r9-compose-ops` | PR #24 | -| 그룹 A 보안·관측·전송: B4, B5, B6a, B6b, B7, B11b | 그룹 세션 | 대기 | -| 그룹 B 영속성·outbound·application: B8, B9 나머지, B10a, B10b, B15a, B15b, B16 일부 | 그룹 세션 | 대기 | +| 그룹 A 보안·관측·전송: B4, B5, B6a, B6b, B7, B11b | `claude/r9-a-runbooks`·`claude/r9-a-authz`·`claude/r9-a-obs-logs` | PR #30(B7, 병합 `e6c3b159`), #31(B4·B11b, 병합 `3e908c02`), #32(B5·B6a·B6b) | +| 그룹 B 영속성·outbound·application: B8, B9 나머지, B10a, B10b, B15a, B15b, B16 일부 | `claude/r9-b-claim-tx`와 그 위에 쌓는 둘 | PR #33(B8·B9 나머지·B16 일부). B10a·B10b, B15a·B15b는 #33 위에 쌓아 연다 | | 그룹 C 계약·시험·빌드·문서: B11a, B12, B13, B16, B17, B18a, B18b, B18c 나머지(RR9-04-35·36·42) | `claude/r9-c-contracts`·`claude/r9-c-tests-build`·`claude/r9-c-docs-body` | PR #25(B11a·B12·B13), #27(B16·B17·B18a), #26(B18b·B18c 나머지, #23·#24·#25 뒤) | -| B20 objectstorage 포트 계약(RR9-03-31) | `claude/r9-objstore-contract` | 진행 중 | +| B20 objectstorage 포트 계약(RR9-03-31·33·35, RR9-04-46·47) | `claude/r9-objstore-contract` | PR #35 | +| B21 objectstorage 포트 예외(RR9-03-34) | (B20 뒤) | 대기 | +| B22 벽시계 시험(RR9-03-36) | `claude/r9-wallclock-tests` | PR #34 | 그룹은 서로 파일이 겹치지 않게 나눴다. 묶음과 경로는 위 색인의 「묶음」 칸과 같다. @@ -229,6 +241,8 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 - RR9-03-30(Medium): 고치는 중에 찾은 발견이다. 색인과 `03-contract-testing.md`에 더했다. - RR9-03-31(Medium)·RR9-03-32·RR9-04-43~45(Low): 그룹 C 묶음의 새 눈 리뷰가 찾은 기존 결함이다(2026-11-13). 색인과 `03-contract-testing.md`·`04-build-docs.md`에 더했다. 묶음 PR이 만든 회귀는 그 PR에서 고쳤고 여기 세지 않는다. +- RR9-03-33·34(Medium)·RR9-03-35·RR9-04-46·47(Low): B20(objectstorage 포트 계약)의 첫 실행과 새 눈 리뷰가 찾은 기존 결함이다(2026-11-13). RR9-03-34는 포트 수준 예외 타입을 새로 두는 일이라 B21로 나눴다. 겹친 managed 게시에서 진 호출이 adapter의 충돌 예외를 받는 것(B20 3차 리뷰)도 같은 부류라 RR9-03-34에 넣었다. +- RR9-03-36(Medium): main 단계 run이 gRPC·httpclient 시험에서 빨갛게 된 것을 따라가 찾았다(2026-11-13). desktop에서 부하를 걸어도 다시 나지 않았다. 그래서 main 단계 lane의 벽시계 시험 모두를 원인 단언과 gate로 바꿨다(B22). ## 5. 다른 세션에 넘긴 것 @@ -261,10 +275,12 @@ compose README를 고치는 중)에 9건을 넘겼다(2026-11-12). 그 세션 PR | ⑤ | RR9-05-12 notification 멱등 판정이 executor와 다르다 | 근거를 보고 executor로 옮기거나 결정으로 기록 — 묶음이 고른다 | | ⑥ | env 이름 `SECURITY_PUBLIC_PATHS`·`PRESENTATION_API_BASE_PATH`의 `APP_` 접두 | 지금 이름 그대로 registry에 등록(바꾸면 파생 서비스 배포 env가 소리 없이 무시됨). 이름 변경은 소유자 결정 | | ⑦ | RR9-03-32 provider callback의 본문 없는 응답: 소유자 결정 12 「Envelope가 아닌 실패는 Draft-12 offset 문서 하나」 | 동작 그대로(provider는 status만 읽고, 인증 전 경로라 거절 이유를 싣지 않음), HTTP 계약 §1에 예외로 적는다 | +| ⑧ | RR9-03-31 objectstorage fake: TESTING_STRATEGY 9.2 「소비자 없는 fake 금지」(결정 2026-11-03) vs capability 기준 5(fake와 adapter가 같은 계약) | fake를 둔다. 소비자는 객체 저장소를 쓰는 서비스의 유스케이스 시험이다. TESTING_STRATEGY 9.4에 예외로 적는다 | +| ⑨ | RR9-03-31 objectstorage 포트의 거절: 타입 있는 결과로 바꾸기 vs 지금 예외를 선언 | 지금 동작(`IllegalArgumentException`=요청 그대로, `IllegalStateException`=지금 상태)을 포트 Javadoc에 선언하고 유스케이스가 기능 오류로 감싼다. 타입 결과는 공개 API 변경이라 하지 않는다 | ## 7. 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) -1. 마지막 확인 리뷰 발견 0: 아님. 이 라운드 158건을 고친 뒤 확인 리뷰(독립 리뷰어 둘)가 판정한다. +1. 마지막 확인 리뷰 발견 0: 아님. 이 라운드 164건을 고친 뒤 확인 리뷰(독립 리뷰어 둘)가 판정한다. 2. 열린 「Declined to judge」 0: 참. 판정을 미룬 항목은 없다. 못 본 경로는 2절에 적었다. 3. 합친 트리의 라운드 끝 게이트: 아직. 묶음을 합친 뒤 돈다. 4. README의 남은 항목 0: 아님. 4절의 대기 묶음과 6절의 결정이 남았다.