docs(reviews): round9 기록에 그룹 C PR과 고치며 찾은 발견 다섯을 더한다
pr / done (pull_request) Canceled after 0s

- 그룹 C 묶음 PR(#25 계약·오류 코드, #27 시험·빌드·스크립트, #26 문서)과 새 묶음
  B20(objectstorage 포트 계약)을 4절 표에 적었다. #26은 #23·#24·#25 뒤에 병합한다.
- 그룹 C 묶음의 새 눈 리뷰가 찾은 기존 결함 다섯(RR9-03-31·32, RR9-04-43~45)을
  색인·영역 문서·「고치며 찾은 것」에 더하고 총수를 158건으로 고쳤다. 묶음 PR이 만든
  회귀는 그 PR에서 고쳤고 세지 않는다.
- 6절에 ⑦(callback의 본문 없는 응답을 Envelope 예외로 적는 권하는 안), 5절에 CI 세션
  넘김 10번(build-logic AGENTS의 lane 문장)을 더했다.

검증: check-review-index.py(색인 158/158), check-docs.py·check-work-docs.py rc=0.

Refs: RR9-03-31, RR9-03-32, RR9-04-43, RR9-04-44, RR9-04-45
This commit is contained in:
DongHyeonka
2026-11-13 06:51:28 +09:00
parent afaf408d70
commit 33d54c99bd
3 changed files with 47 additions and 3 deletions
@@ -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절 ⑦.
@@ -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`가 있다. 고침: 그 키 하나를 적는다.
@@ -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 `<Aggregate>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절의 결정이 남았다.