diff --git a/docs/reviews/2026-11-03-rereview/README.md b/docs/reviews/2026-11-03-rereview/README.md index d0ae256a..dfd63630 100644 --- a/docs/reviews/2026-11-03-rereview/README.md +++ b/docs/reviews/2026-11-03-rereview/README.md @@ -787,18 +787,21 @@ r8 수정이 고쳤다고 한 항목의 재확인(영역 문서 「항목 재확 ### 19.4 결정이 필요한 것 -| # | 항목 | 선택지 | 권하는 안과 이유 | 정할 사람 | -|---|---|---|---|---| -| ① | RR8-01-01 GraphQL 판정 순서: 앱이 등록한 매핑과 원인 사슬의 carrier 중 무엇이 먼저인가(공개 응답 코드) | (a) 플랫폼 거부 → 실패 **자신**이 carrier → 등록된 application 매핑 → 원인 사슬의 첫 carrier → 거부된 인자 → 가림 (b) 지금 순서를 두고 업그레이드 안내 B-46·GraphQL README·매퍼 Javadoc에 "원인 사슬의 carrier가 등록 매핑보다 먼저"를 적는다 (c) 등록 매핑을 실패 자신이 carrier인 경우보다도 먼저 본다 | (a). A·B가 같은 안을 권한다. r8-f1 전에 등록 매핑이 답하던 응답을 그대로 두고, 앱 도메인 advice가 먼저 받는 web과 맞으며, 결정 「감싼 carrier를 전송이 읽는 법」의 전제("바뀌는 응답은 500이던 경우뿐")로 돌아간다. (b)는 앱에 원인 버리기를 강요하고 web과 계속 다르다. (c)는 r8-f1 전에도 없던 변화라 범위가 넓다. 어느 안이든 B-45에 "GraphQL에서 `LockAcquisitionTimeoutException`을 등록한 매핑은 쓰이지 않는다"를 더한다((a)에서도 그 예외는 실패 자신이 carrier다) | 소유자 | -| ② | RR8-04-01 적용한 핸들의 markFailed 재전송에 인자가 다를 때의 답 | (a) 다른 disposition은 `OPERATION_CONFLICT`(세 저장소를 바꿈), 다른 retention은 "이미 처리됨"(PostgreSQL fail digest에서 retention을 뺌) (b) 다른 disposition은 `NOT_OWNER` 그대로(지금 세 저장소가 같음, Javadoc만 고침), 다른 retention은 "이미 처리됨" (c) 다른 retention도 `OPERATION_CONFLICT`(renew의 lease처럼. Redis 기록에 retention을 더하고 Lua를 바꿈) | (a)(A 권장). 결정 「전이의 operation id」(2026-11-06)가 `OPERATION_CONFLICT`를 "claim과 다른 id"와 "같은 id·다른 인자"로 정했다. 다른 disposition은 "같은 id·다른 인자"다. `NOT_OWNER`는 적용한 핸들에게 "넘겨받혔다"는 틀린 신호를 준다. retention은 complete의 replay TTL처럼 기록된 결과를 바꾸지 않는 보관 기간이라 비교하지 않는다(r8-f4가 complete 재전송을 응답 digest로만 판정하고 replay TTL을 비교하지 않은 것과 같다). B는 비용이 가장 작은 (b)를 권했다 — 세 저장소 코드를 disposition 쪽으로 바꾸지 않는다. 어느 안이든 공유 계약에 케이스 둘을 더한다 | 소유자 | -| ③ | 이력 ID 0 규칙을 `docs/manual`·`docs/work` 밖으로 넓힐지(18.6절 넷째) | (a) 넓히지 않는다 (b) 진입 문서만: `AGENTS.md`와 leaf `CLAUDE.md` (c) `docs/reviews/**` 밖 전부 | (b). 새 세션이 처음 읽는 규칙 문서에서만 ID가 이해를 막는다(매뉴얼 규칙을 만든 이유와 같다). 모듈 README·설계 문서의 ID는 같은 repo의 리뷰 문서로 따라갈 수 있다. (c)는 65줄을 걷어내고 이력 근거를 잃는다. B는 판정을 소유자에게 넘겼다 | 소유자 | -| ④ | 결정 「감싼 carrier를 전송이 읽는 법」이 인자 변환 단계까지 덮는지(round8/01 「Declined to judge」) | (a) 덮지 않는다. web의 인자 변환 실패(`MethodArgumentTypeMismatchException`·`HttpMessageNotReadableException`)는 원인에 carrier가 있어도 지금처럼 `BAD_PARAMETER`·`VALIDATION_FAILED`, STOMP도 `ConversionFailedException`·`MessageConversionException` 안의 carrier를 거부로 본다 (b) 덮는다. web 두 처리기와 STOMP 거부 판정이 원인 사슬의 carrier를 먼저 본다 | (a). 인자 변환 실패는 요청 형식 오류이고 그 코드는 전송이 정한다(매뉴얼 06 「요청 파라미터 형식 오류」). 템플릿에 carrier를 던지는 변환기가 없어 바뀌는 응답이 없다. 바뀌는 것은 STOMP 로그 줄 하나다 | 소유자 | +| # | 항목 | 선택지 | 권하는 안과 이유 | 정할 사람 | 소유자 답 | +|---|---|---|---|---|---| +| ① | RR8-01-01 GraphQL 판정 순서: 앱이 등록한 매핑과 원인 사슬의 carrier 중 무엇이 먼저인가(공개 응답 코드) | (a) 플랫폼 거부 → 실패 **자신**이 carrier → 등록된 application 매핑 → 원인 사슬의 첫 carrier → 거부된 인자 → 가림 (b) 지금 순서를 두고 업그레이드 안내 B-46·GraphQL README·매퍼 Javadoc에 "원인 사슬의 carrier가 등록 매핑보다 먼저"를 적는다 (c) 등록 매핑을 실패 자신이 carrier인 경우보다도 먼저 본다 | (a). A·B가 같은 안을 권한다. r8-f1 전에 등록 매핑이 답하던 응답을 그대로 두고, 앱 도메인 advice가 먼저 받는 web과 맞으며, 결정 「감싼 carrier를 전송이 읽는 법」의 전제("바뀌는 응답은 500이던 경우뿐")로 돌아간다. (b)는 앱에 원인 버리기를 강요하고 web과 계속 다르다. (c)는 r8-f1 전에도 없던 변화라 범위가 넓다. 어느 안이든 B-45에 "GraphQL에서 `LockAcquisitionTimeoutException`을 등록한 매핑은 쓰이지 않는다"를 더한다((a)에서도 그 예외는 실패 자신이 carrier다) | 소유자 | (a), 2026-11-07. 결정 색인 2.3절 「GraphQL 판정 순서」 | +| ② | RR8-04-01 적용한 핸들의 markFailed 재전송에 인자가 다를 때의 답 | (a) 다른 disposition은 `OPERATION_CONFLICT`(세 저장소를 바꿈), 다른 retention은 "이미 처리됨"(PostgreSQL fail digest에서 retention을 뺌) (b) 다른 disposition은 `NOT_OWNER` 그대로(지금 세 저장소가 같음, Javadoc만 고침), 다른 retention은 "이미 처리됨" (c) 다른 retention도 `OPERATION_CONFLICT`(renew의 lease처럼. Redis 기록에 retention을 더하고 Lua를 바꿈) | (a)(A 권장). 결정 「전이의 operation id」(2026-11-06)가 `OPERATION_CONFLICT`를 "claim과 다른 id"와 "같은 id·다른 인자"로 정했다. 다른 disposition은 "같은 id·다른 인자"다. `NOT_OWNER`는 적용한 핸들에게 "넘겨받혔다"는 틀린 신호를 준다. retention은 complete의 replay TTL처럼 기록된 결과를 바꾸지 않는 보관 기간이라 비교하지 않는다(r8-f4가 complete 재전송을 응답 digest로만 판정하고 replay TTL을 비교하지 않은 것과 같다). B는 비용이 가장 작은 (b)를 권했다 — 세 저장소 코드를 disposition 쪽으로 바꾸지 않는다. 어느 안이든 공유 계약에 케이스 둘을 더한다 | 소유자 | (a), 2026-11-07. 결정 색인 2.4절 「적용한 핸들의 markFailed 재전송 인자」 | +| ③ | 이력 ID 0 규칙을 `docs/manual`·`docs/work` 밖으로 넓힐지(18.6절 넷째) | (a) 넓히지 않는다 (b) 진입 문서만: `AGENTS.md`와 leaf `CLAUDE.md` (c) `docs/reviews/**` 밖 전부 | (b). 새 세션이 처음 읽는 규칙 문서에서만 ID가 이해를 막는다(매뉴얼 규칙을 만든 이유와 같다). 모듈 README·설계 문서의 ID는 같은 repo의 리뷰 문서로 따라갈 수 있다. (c)는 65줄을 걷어내고 이력 근거를 잃는다. B는 판정을 소유자에게 넘겼다 | 소유자 | (b), 2026-11-07. 결정 색인 2.1절 「이력 ID 0 규칙의 범위」 | +| ④ | 결정 「감싼 carrier를 전송이 읽는 법」이 인자 변환 단계까지 덮는지(round8/01 「Declined to judge」) | (a) 덮지 않는다. web의 인자 변환 실패(`MethodArgumentTypeMismatchException`·`HttpMessageNotReadableException`)는 원인에 carrier가 있어도 지금처럼 `BAD_PARAMETER`·`VALIDATION_FAILED`, STOMP도 `ConversionFailedException`·`MessageConversionException` 안의 carrier를 거부로 본다 (b) 덮는다. web 두 처리기와 STOMP 거부 판정이 원인 사슬의 carrier를 먼저 본다 | (a). 인자 변환 실패는 요청 형식 오류이고 그 코드는 전송이 정한다(매뉴얼 06 「요청 파라미터 형식 오류」). 템플릿에 carrier를 던지는 변환기가 없어 바뀌는 응답이 없다. 바뀌는 것은 STOMP 로그 줄 하나다 | 소유자 | (a), 2026-11-07. 결정 색인 2.3절 「인자 변환 단계의 감싼 carrier」 | 개선 제안(결함 아님, 총괄이 받거나 닫는다): B가 18.6절 셋째(web 필터가 던진 carrier)를 결함 아님으로 판정하며, web README에 "필터에서 던진 예외는 `GlobalExceptionHandler`를 거치지 않고 컨테이너가 예외째 로그를 남긴다(persistence 원인 포함)" 한 줄을 제안했다. web README 「EnvelopeErrorController」 절(`src/adapter/inbound/web/README.md:302-308`)이 이미 "필터가 던진 예외는 `GlobalExceptionHandler`를 지나지 않는다"를 적는다. 남는 것은 컨테이너 로그 이야기이고, 이 리뷰는 그것을 실행으로 확인하지 않았다. 받으면 그 줄을 확인하는 테스트와 함께 더한다. +네 결정 모두 소유자가 권하는 안으로 정했다(2026-11-07). 개선 제안도 받았다. 수정 세션이 실제 Tomcat에서 컨테이너 로그 줄을 +확인한 뒤 web README에 넣었다(`11c76089`, 확인 테스트 `FilterFailureContainerLogIT`). 적용한 커밋은 19.7절이다. + ### 19.5 18.6절에서 넘어온 「남은 항목」 판정 | 항목 | 판정 | 어디 | @@ -819,3 +822,26 @@ README 「EnvelopeErrorController」 절(`src/adapter/inbound/web/README.md:302- 다음 라운드는 수정 묶음 → round9 확인 리뷰다. 수정이 Important 둘(RR8-01-01, RR8-03-01)을 고치므로 round9도 독립 리뷰어 둘이다(4.1절 셋째 경우). RR8-06-01은 결함으로 두고 다음 수정 묶음에서 고친다. 고치기 전까지 독립 리뷰어 라운드의 정본 리뷰어는 이번처럼 임시 사본으로 색인 검사를 보인다. + +### 19.7 round8 처리 (2026-11-07) + +round8 결함 10건과 19.4절 결정 넷, 개선 제안 하나를 수정 브랜치 다섯이 고쳤다. RR8-06-01과 결정 ③은 매뉴얼 수정 2차 +(`claude/manual-gap-fix-2-9b0fe2`, 끝 `3eb3b067`)가, 나머지는 그 끝에서 딴 네 브랜치(`claude/r9-g1-inbound-456713`, +`claude/r9-g2-stomp-interceptor-f5675d`, `claude/r9-g3-migration-7ce36d`, `claude/r9-g4-idempotency-c669be`)가 고쳤다. +2026-11-07 `claude/integration-r9-f1bc5c`에 합쳤다(19.8절). 검증 칸은 각 커밋 본문에서 옮겼다. 모두 desktop에서 공유 잠금 아래 +돌렸고 로그 경로는 커밋 본문에 있다. 「결정」 칸은 수정 세션이 정한 기본값이다. 다섯 모두 소유자가 확인했다(2026-11-07). + +| 결함 | 상태 | 고친 커밋 | 검증 | 결정 | +|---|---|---|---|---| +| RR8-01-01 | 고침(19.4절 ① (a)) | `e1fb049b` | RED: 기준 `3eb3b067` + 테스트만으로 `GraphQlWireErrorMapperTest`·`GraphQlArgumentBindingFailureTest` 22건 중 1건 실패(기대 `[ORDER_UNAVAILABLE, BUSINESS]`, 실제 `[DB_UNAVAILABLE, DEPENDENCY]`). 지킴 테스트 둘(실패 자신이 carrier인 등록 타입, 등록 매핑이 답해도 남는 carrier 줄)은 기준에서도 통과. GREEN: graphql·shared-contract `check` rc=0(407·269건 실패 0), `check-work-docs.py` rc=0 | 등록된 매핑이 답해도 원인 사슬의 서버 쪽 carrier 로그 줄은 남긴다. 소유자 확인(2026-11-07) | +| RR8-01-02 | 고침 | `ba189869` | RED(문서 주장을 단언한 임시 탐침, 커밋 안 함): `integration_lock` 조회가 `BadSqlGrammarException`(`postgresqlDistributedLockIntegrationTest` 7건 중 1건 실패), timeout 뒤 metric에 outcome 밖 tag 없음(`MeteredDistributedLockTest` 11건 중 1건 실패). GREEN: application-core·persistence-jpa `check` rc=0(1,089건 실패 0), `postgresqlDistributedLockIntegrationTest` 8건(runbook의 SQL 두 블록을 파일에서 읽어 도는 새 2건 포함), `documentContractTest` 67건 rc=0 | runbook에 key → UUID 계산 SQL을 하나 더 넣었다(코드에서 아는 key의 보유자 찾기). 소유자 확인(2026-11-07) | +| 결정 ④(round8/01 「Declined to judge」) | 고침(19.4절 ④ (a)) | `ee5b4e1b` | RED: 기준 + 테스트만으로 `StompHandlerFailureLogTest` 13건 중 2건 실패(기대 WARN 거부 줄, 실제 ERROR persistence 줄). web·GraphQL은 RED 없음(지금 동작이 결정과 같음): 지킴 테스트가 기준에서 통과하고, web 변이(`handleTypeMismatch`가 원인의 carrier를 먼저 봄)는 12건 중 1건 실패(400 대신 503). GREEN: websocket·web·graphql·shared-contract `check` rc=0(107·343·408·269건 실패 0) | 결정 ④를 GraphQL `@Argument` binder에도 적용한다(동작 변화 없음, 지킴 테스트 하나). 소유자 확인(2026-11-07) | +| web README 개선 제안(19.4절 끝) | 받음, 넣음 | `11c76089` | 쓰기 전 확인: 기준 + `FilterFailureContainerLogIT`로 `:adapter:inbound:web:systemTest` rc=0. WARN 이상 줄은 Tomcat `[dispatcherServlet]` ERROR와 SQL 원인 사슬 하나뿐이고 `GlobalExceptionHandler` 줄은 없다. 브랜치 마지막 트리 `64089130`에서 PR 단계 게이트(`:ci :verifyDependencyLocks --warning-mode=fail` 등)와 바뀐 경로의 pr-adapters lane(web·websocket·jpa) rc=0 | — | +| RR8-02-01 | 고침 | `06b94338` | RED: 기준 + 테스트·fixture·의존성 줄만으로 `ArchitectureViolationFixtureTest` 99건 중 5건 실패(다섯 모두 위반 0건), 허용 2건 통과. GREEN: `:app-bootstrap:architectureTest --rerun` 249건 실패 0. 변이 셋이 각자 맡은 fixture만 실패시킴. 트리 `742428a9`에서 `:app-bootstrap:check`(305건), `architectureCheck`, `testQualityCheck`, `:ci :verifyDependencyLocks --warning-mode=fail`(6,906건 실패 0), 두 빌드 단계 검사, sample, optional `ci`, compose 검사 rc=0 | interceptor 두 타입(`ChannelInterceptor`·`ExecutorChannelInterceptor`)을 요청 처리기 목록에도 넣었다. 소유자 확인(2026-11-07) | +| RR8-03-01 | 고침(같은 절의 단계 순서도) | `8ebe98e6` | RED: 기준 + 임시 테스트로 `postgresqlConcurrentIndexMigrationIntegrationTest` 9건 중 2건 실패(기준 runbook대로 하면 재배포가 `42704 index does not exist`, 기준 순서의 drop 단계가 열린 쓰기 트랜잭션을 기다림). GREEN: persistence-jpa `check`(666건)·`testQualityCheck`, 같은 lane 9건(새 2건 포함), `documentContractTest` 67건, optional ledger `integrationTest` 47건 rc=0, 바꾼 문서 5개 상대 링크 깨짐 0 | — | +| RR8-03-02 | 고침 | `dae6dcaf` | RED 없음(Javadoc 문구). persistence-jpa `spotlessCheck`·`compilePostgresqlIntegrationTestJava` rc=0 | — | +| RR8-03-03 | 고침 | `e3ebc25e` | RED 없음(이름 문제). persistence-jpa `check`(666건), 사용처 lane 셋(동시 인덱스 7건, order key runbook 10건, disposition runbook 8건) rc=0 | — | +| RR8-03-04 | 고침 | `4cd38cf4` | RED 없음(테스트 구조 개선). 대신 변이: 기준 + 리뷰 변이 A11은 목록 검사가 통과(변이 생존), 이 커밋 + 같은 변이는 `GrpcOperationLedgerMigrationLockWaitIT` 8건 중 위반 fixture 4건 실패. GREEN: optional ledger `check`(13건)·`integrationTest`(52건, 새 5건 포함)·`testQualityCheck` rc=0 | — | +| RR8-04-01·02 | 고침(19.4절 ② (a)) | `7535a4ca` | RED: 기준 + 계약 케이스만으로 in-memory fake 62건 중 1, Redis 명령 fake 62건 중 2, 실 Redis 103건 중 2, 실 PostgreSQL 62건 중 2 실패. GREEN: application-core 426·cache-redis 228·redis-runtime 65·persistence-jpa 666건 `check`와 `testQualityCheck`, `redisContainerContractTest` 103, `jpaPlatformContractTest` 432, fake를 쓰는 leaf 넷(composition idempotency 32, redis-sdk 310, web 341, sample 339), `documentContractTest` 67 rc=0. `postgresqlIdempotencyIntegrationTest`는 1차에서 옛 동작(다른 retention → conflict)을 고정한 케이스 1건이 실패해 결정대로 고친 뒤 10건 실패 0 | claim·takeover도 `lastKind`에 `CLAIM`을 쓴다. 소유자 확인(2026-11-07) | +| RR8-06-01 | 고침 | `51230caf` | RED: 정본 리뷰어 커밋 `27260ad0`의 리뷰 폴더에 옵션 없이 `check-review-index.py` rc=1(180 중 172). GREEN: 리뷰어 A의 색인 표를 `--extra-index`로 넘기면 rc=0(180/180), 그 커밋 트리의 폴더 rc=0(182/182), 없는 파일을 넘기면 rc=1. `check-work-docs.py` 기본·`--history docs/manual`·`--links` rc=0 | — | +| 결정 ③ | 고침(19.4절 ③ (b)) | `6b253c6c` | `AGENTS.md`·`src/**/CLAUDE.md` 87줄의 이력 ID를 내용과 날짜로 바꾸고 근거를 `docs/work/evidence.md` 10절로 옮김. `check-work-docs.py` 기본(두 문서 묶음까지 봄)·`--history docs/manual`·lychee 범위 `--links`(578파일 깨짐 0) rc=0, `documentContractTest --rerun` 67건, `MongoNamespaceContractTest --rerun` 3건 rc=0 | — |