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 2074348d..d29e3040 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 @@ -212,3 +212,17 @@ - 증거: E2(desktop 실행: `:app-bootstrap:integrationTest --tests '*ComposeMergeCharacterizationTest'`가 「No tests found」) · 이전부터 - 묶음: B19 compose·Docker 운영 - 내용: `src/bootstrap/app/src/integrationTest/java/dev/caskeleton/bootstrap/compose/ComposeMergeCharacterizationTest.java` — `integrationTest` lane은 `requires`로 적은 클래스 넷만 고른다(`StrictTestLanePlugin.java:228-232`). `src/bootstrap/app/build.gradle`은 그 lane 입력에 compose 파일을 선언해 이 시험이 돈다고 적었다. 시험이 보던 것(기본·dev 조합 렌더링, 계약 스크립트)은 PR 단계 `verifyComposeProfiles`가 18개 lane으로 이미 본다. 고침: 시험과 입력 선언을 지운다. + +### RR9-03-31 · Medium · application-objectstorage에 포트 계약 시험이 없다 + +- 출처: 고치며 찾음(그룹 C 문서 묶음 구조 리뷰, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B20 objectstorage 포트 계약 +- 내용: `docs/manual/10-capabilities.md` 기준 5는 포트를 가진 모듈의 testFixtures에 포트 계약(추상 클래스)을 두고 fake와 실제 adapter가 모두 통과하게 한다. `src/application/objectstorage`에는 testFixtures가 없다. adapter testFixtures의 `ObjectStorageProviderContract`는 adapter 안 provider SPI를 시험하고 application 포트는 시험하지 않는다. 고침: 포트 계약을 application-objectstorage testFixtures에 두고 fake와 adapter(실제 벤더 lane 포함)가 상속한다. + +### RR9-03-32 · Low · 알림 provider callback의 본문 없는 응답이 Envelope 예외로 적혀 있지 않다 + +- 출처: 고치며 찾음(그룹 C 문서 묶음 구조 리뷰, 2026-11-13) +- 증거: 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절 ⑦. 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 3a263304..3b5fde3d 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 @@ -296,3 +296,24 @@ - 증거: 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). + +### RR9-04-43 · Low · persistence-jpa release registry가 아무도 읽지 않는 PostgreSQL tag를 적는다 + +- 출처: 고치며 찾음(그룹 C 시험·빌드 묶음 리뷰, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B17 빌드 정리 +- 내용: `src/adapter/outbound/persistence-jpa/release/release-registry.json`의 `databases[].image`가 `postgres:NN-alpine` tag다. `JpaReleaseManifest`는 major와 support-level만 읽고 lane은 `gradle/container-images.properties`의 digest를 쓴다. 카탈로그 밖에 이미지를 한 번 더 적은 곳이다. 고침: 칸을 지우고 이미지는 카탈로그가 정한다고 적는다. + +### RR9-04-44 · Low · web 한도 표가 아무도 막지 않는 칸을 「늘 애플리케이션」이라 적는다 + +- 출처: 고치며 찾음(그룹 C 문서 묶음 리뷰, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: `docs/web/repository-adaptation.md` 8절 표의 query parameter 수·JSON 깊이·배열 크기·응답 크기 행이 「넘으면 누가 답하나」를 「늘 애플리케이션」이라 한다. 같은 절 머리말대로 그 칸은 `budget` 목록 값뿐이고 강제하는 코드가 없다. 고침: 실제로 막는 쪽(없음, Jackson 기본 한도, edge)을 적는다. + +### RR9-04-45 · Low · objectstorage README가 registry에 있는 env 키를 「없다」고 한다 + +- 출처: 고치며 찾음(그룹 C 문서 묶음 구조 리뷰, 2026-11-13) +- 증거: E1(현재 커밋 코드·문서 정적 확인) · 이전부터 +- 묶음: B18c 낡은 이름·leaf 안내 +- 내용: `src/adapter/outbound/objectstorage/README.md` 「env 키」가 「전용 `APP_*` 키는 없다」고 하지만 `docs/registries/env-keys.yaml`에 `APP_OBJECTSTORAGE_ENABLED`가 있다. 고침: 그 키 하나를 적는다. diff --git a/docs/reviews/2026-11-12-round9-review/README.md b/docs/reviews/2026-11-12-round9-review/README.md index 92745392..ef6c2c03 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. 고치며 1건(Medium)을 더 찾아 모두 153건이다. 이 밖에 CI workflow·`build.gradle`·`gates.md`처럼 +새 눈으로 전체 리뷰했다. 발견 152건: Critical 0, High 2, Medium 72, Low 78. 고치며 6건(Medium 2, Low 4)을 더 찾아 모두 158건이다. 이 밖에 CI workflow·`build.gradle`·`gates.md`처럼 백엔드 CI 세션이 고치는 중인 파일의 발견 9건은 그 세션에 넘겼다(5절). - High 둘은 아키텍처 규칙의 사각지대다(HARD-STOP 2). controller가 domain repository 포트를 들어도, inbound 밖 사용자 @@ -136,6 +136,8 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 | 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-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-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 문서·지침 | @@ -178,6 +180,9 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 | 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-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-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 아키텍처 규칙 | @@ -215,13 +220,15 @@ main `a7e38c10`(Gradle 루트 재배치, gRPC·메시징 플랫폼 분리, 분 | 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 일부 | 그룹 세션 | 대기 | -| 그룹 C 계약·시험·빌드·문서: B11a, B12, B13, B16, B17, B18a, B18b, B18c 나머지(RR9-04-35·36·42) | 그룹 세션 | 대기 | +| 그룹 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` | 진행 중 | 그룹은 서로 파일이 겹치지 않게 나눴다. 묶음과 경로는 위 색인의 「묶음」 칸과 같다. ### 고치며 찾은 것 - 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에서 고쳤고 여기 세지 않는다. ## 5. 다른 세션에 넘긴 것 @@ -238,6 +245,7 @@ compose README를 고치는 중)에 9건을 넘겼다(2026-11-12). 그 세션 PR 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이 고침) +10. [Low] `build-logic/AGENTS.md:17` 「저장소 루트(`ca.repository.root`)는 이 두 레인에만 준다」: 루트는 leaf `build.gradle`의 lane이 `systemProperty`로 준다(build-logic이 주지 않는다). 그룹 C 시험·빌드 PR이 graphql `graphqlDocumentContractTest`에도 준다(2026-11-13 넘김). ## 6. 결정이 필요한 것 @@ -252,10 +260,11 @@ compose README를 고치는 중)에 9건을 넘겼다(2026-11-12). 그 세션 PR | ④ | RR9-03-22 영어 `@DisplayName`·`// when` 없는 시험의 일괄 전환 | 규칙 그대로(고치는 시험에 적용). 일괄 전환하지 않고 결정 색인에 적는다 | | ⑤ | 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에 예외로 적는다 | ## 7. 멈춤 기준 상태 (`docs/work/improve.md` 4.5절) -1. 마지막 확인 리뷰 발견 0: 아님. 이 라운드 153건을 고친 뒤 확인 리뷰(독립 리뷰어 둘)가 판정한다. +1. 마지막 확인 리뷰 발견 0: 아님. 이 라운드 158건을 고친 뒤 확인 리뷰(독립 리뷰어 둘)가 판정한다. 2. 열린 「Declined to judge」 0: 참. 판정을 미룬 항목은 없다. 못 본 경로는 2절에 적었다. 3. 합친 트리의 라운드 끝 게이트: 아직. 묶음을 합친 뒤 돈다. 4. README의 남은 항목 0: 아님. 4절의 대기 묶음과 6절의 결정이 남았다.