diff --git a/docs/reviews/2026-11-03-rereview/README.md b/docs/reviews/2026-11-03-rereview/README.md index daa932f1..d0ae256a 100644 --- a/docs/reviews/2026-11-03-rereview/README.md +++ b/docs/reviews/2026-11-03-rereview/README.md @@ -706,3 +706,116 @@ round7 결함 15건과 고치다 같이 고친 것을 수정 브랜치 다섯 - 경로가 안 걸린 PR workflow: `messaging-certification.yml`, `notification-platform.yml`의 pull request trigger(main push의 `pr` job은 위에서 돌림). - PR·main 단계가 아닌 것: nightly·수동 전용(`fileserver-nightly`, `jpa-nightly`, `jpa-next`, redis 전체 matrix, MinIO fault, AWS), `release.yml`의 `releaseCheck` 두 명령 밖 job(이미지·서명 등, 태그 단계). + +## 19. round7 수정 확인 리뷰 round8 (2026-11-07) + +`2c8a359d..83a12f66`(round7 결함 수정 다섯 브랜치와 매뉴얼 수정을 합친 것)을 봤다. 기준 커밋 `83a12f66`. 범위는 리뷰 기록 밖 116개 파일 ++3,747줄이라 독립 리뷰어 둘(`docs/work/improve.md` 4.1절)이 따로 봤다. + +- 정본 리뷰어 A: 영역 문서 `round8/01~06`(브랜치 `claude/r8-review-a-3851a7`). 상한(추가 1,500줄)을 넘어 영역 여섯과 공통 문서로 나눴다. 영역 표는 + [round8/01](round8/01-transport-errors.md) 「범위」다. +- 리뷰어 B: 공유 노트 `r8-review-b.md`(브랜치 `claude/r8-review-b-9079ca`, 리뷰 폴더에 커밋하지 않음). 임시 번호 `B-NN-MM`. +- 두 리뷰가 끝난 뒤 총괄이 같은 결함을 짝지었다. B에만 있던 둘은 정본 리뷰어가 근거와 변이 탐침으로 다시 확인해 다음 번호로 넣었다(round8/03 + 「합칠 때 넣은 결함」). 이 절은 총괄 지시로 정본 리뷰어가 썼다. + +| 영역 | 대상 커밋 | `git diff --shortstat` | +|---|---|---| +| [01 전송 오류](round8/01-transport-errors.md) | `5f6a86d7`, `ef8ef170` | 30 파일, +1056 −125 | +| [02 아키텍처 규칙](round8/02-architecture-rules.md) | `a8166598` | 14 파일, +725 −94 | +| [03 마이그레이션·Flyway 규칙](round8/03-migration.md) | `6ec0c4f7`, `6764246a` | 28 파일, +747 −125 | +| [04 멱등 저장소](round8/04-idempotency.md) | `14435106` | 12 파일, +382 −61 | +| [05 build-logic·httpclient·작은 문서](round8/05-build-logic-httpclient.md) | `6cd5e925`, `a490c20f`, `c746f980`, `eab82df1`, `ac3c6a81` | 11 파일, +547 −100 | +| [06 매뉴얼·검사 스크립트](round8/06-manual-scripts.md) | `b872b0ea`, `73d39212`, `6dd9ef76`, `b619c442`, `447a77a3`, `b7d13104`, `81ef58ab` | 18 파일, +253 −67 | +| 공통 문서 | 업그레이드 안내, application-core·persistence-jpa README | 3 파일, +37 −15 | +| 보지 않음 | 리뷰 기록 `cb340001`·`48565718`·`83a12f66`(README 18절) | — | + +### 19.1 결과 + +Critical 0, Important 2, Minor 8, 회귀 1. 결함 10건: 이번 수정이 만든 것 6건, 섞임 3건(이전부터 있던 것을 이번 수정이 넓히거나 새로 약속함), +이전부터 1건. + +| ID | 심각도 | 내용 | 이번 수정 / 이전부터 | 출처 | 증거 | 결정이 필요한 질문 | +|---|---|---|---|---|---|---| +| RR8-01-01 | Important(회귀) | GraphQL이 원인 사슬의 carrier를 앱이 등록한 매핑보다 먼저 보아, 등록한 실패가 carrier를 원인으로 들면 앱 코드 대신 carrier 코드로 답한다(수정 전 `ORDER_UNAVAILABLE`, 수정 뒤 `DB_UNAVAILABLE`) | 이번 수정 | A·B | E2 | 19.4절 ① | +| RR8-01-02 | Minor | 락 timeout이 4xx가 되며 어느 락인지 서버에 남지 않는데, stub runbook은 이름·시간이 없는 metric과 없는 `integration_lock` 테이블을 보라고 한다 | 섞임 | A·B | E1 | — | +| RR8-02-01 | Minor | STOMP inbound `ChannelInterceptor`가 사용자 전송 타입이 아니어서, 프레임마다 도는 interceptor가 `@SystemCaller`를 불러도 안 잡힌다. 매뉴얼 07의 새 문장은 중첩 클래스가 이 사각지대에 들지 않는다고 적는다 | 섞임 | A·B | E2(B 탐침 P4), E1 | — | +| RR8-03-01 | Important | 실패한 `DROP INDEX CONCURRENTLY` 마이그레이션에 runbook 복구 SQL을 그대로 따르면 재배포가 `42704 index does not exist`로 다시 막힌다 | 이번 수정 | A | E3 | — | +| RR8-03-02 | Minor | 동시 인덱스 IT의 Javadoc이 runbook에 없는 절 이름을 가리킨다 | 이번 수정 | A | E1 | — | +| RR8-03-03 | Minor | runbook SQL 리더 `OutboxRunbookSql`이 마이그레이션 runbook도 읽는데 이름은 outbox 전용이다 | 이번 수정 | B | E1 | — | +| RR8-03-04 | Minor | ledger IT의 예외 목록 검사 테스트가 빈 목록 위에서 돌아, 검사 코드를 망가뜨려도 통과한다(변이 생존) | 이번 수정 | B | E2 | — | +| RR8-04-01 | Minor | 적용한 핸들이 markFailed를 다른 retention·disposition으로 다시 보내면 fake·Redis·PostgreSQL의 답이 서로, 그리고 포트 Javadoc과 다르다 | 섞임 | A·B | E3 | 19.4절 ② | +| RR8-04-02 | Minor | Redis는 renew를 적용한 핸들이 start를 보내도 "이미 시작됨"이라 답해 호출자가 작업을 다시 실행한다(fake·PostgreSQL은 `NOT_OWNER`) | 이전부터 | A·B | E3 | — | +| RR8-06-01 | Minor | 독립 리뷰어 둘이면 정본 리뷰어가 커밋한 문서가 색인 검사를 rc=1로 남기는데, 매뉴얼은 리뷰어에게 rc=0을 요구한다 | 이번 수정 | A | E2 | — | + +심각도 조정: RR8-01-02를 A는 Important, B는 Minor로 봤다. `docs/work/reference/review-criteria.md` 3절로 Minor로 정했다. +- 이 runbook은 `status: stub`이고 본문을 "after domain adoption"에 쓰라고 적는다. 절차로 내놓은 문서가 아니다. +- 템플릿 코드는 `DistributedLockPort.tryAcquire`를 부르지 않는다. +- 피해는 진단을 못 하는 것이고, 응답·데이터·보안은 맞다. +- 이유와 반론은 round8/01 RR8-01-02 「심각도 조정」에 있다. + +r8 수정이 고쳤다고 한 항목의 재확인(영역 문서 「항목 재확인」): +- 닫힘: RR7-01-03·04·06, RR7-01-01·02, RR7-02-01·02, RR7-03-02·04·05·06, RR7-05-01, 멱등 남은 차이 3건, 태그·릴리스 workflow 결정, + `Retry-After` 7개, GraphQL `BindException`, 깨진 링크 셋, `AGENTS.md` 커밋 문장. +- 부분: RR7-01-05(GraphQL에서 RR8-01-01), RR7-03-01(RR8-03-04), RR7-03-03(RR8-03-01). + +### 19.2 리뷰어 B와의 대응 + +| B ID | 정본 ID | 처리 | +|---|---|---| +| B-01-01 | RR8-01-01 | 같은 결함. B가 더 본 모양(`LockAcquisitionTimeoutException` 자체를 등록한 GraphQL 매핑이 무시됨)은 round8/01 RR8-01-01 「합칠 때 덧붙인 것」 | +| B-01-02 | RR8-01-02 | 같은 결함. 심각도를 Minor로 맞춤(19.1절) | +| B-02-01 | RR8-02-01 | 같은 결함. B 탐침 P4(E2)를 증거에 더함. B는 「이전부터」, 정본은 「섞임」(매뉴얼 07의 새 문장이 이 빈칸을 덮었다고 약속함) | +| B-03-01 | RR8-03-03 | B에만 있음. 근거를 다시 읽고 넣음(이름 문제라 E1) | +| B-03-02 | RR8-03-04 | B에만 있음. 변이 탐침으로 확인하고 넣음(round8/03 명령 A10~A12) | +| B-04-01 | RR8-04-01 | 같은 결함, 같은 값. B는 「이전부터」, 정본은 「섞임」(fake의 다른 retention 답이 이번 수정으로 바뀜). 고치는 법이 달라 19.4절 ②에 두 안을 둠 | +| B-04-02 | RR8-04-02 | 같은 결함, 같은 값, 같은 분류 | + +겹침 비율: 두 리뷰가 모두 찾은 결함 5건 / 합친 결함 10건 = **50%**. A에만 있던 것 3건(RR8-03-01·02, RR8-06-01), B에만 있던 것 +2건(RR8-03-03·04). 이 비율은 「확인 리뷰 독립 리뷰어 둘」 결정(2026-11-07)이 다시 볼 값이다. design-docs `delegation-loop/metrics.md` M11 칸은 총괄이 적는다. + +### 19.3 실행 + +| 리뷰어 | 명령 | 결과 | 로그 | +|---|---|---|---| +| A | 탐침 A1~A7(GraphQL 등록 매핑을 두 커밋에서, 멱등 저장소를 fake·Redis 명령 fake·실 Redis·실 PostgreSQL에서, 실패한 `DROP INDEX CONCURRENTLY`의 runbook 복구를 실 PostgreSQL에서) | 모두 rc=0, 값은 각 영역 문서 | desktop `~/r8-review-a-logs/` | +| A | A8 바뀐 leaf 10개 `test`·`architectureTest --rerun`, A9 `-p build-logic test --rerun` | rc=0, FROM-CACHE 0, 실패 0(합계는 round8/03 「A8 결과」) | 같음 | +| A | A10~A12 ledger 예외 목록 테스트 원래·변이·대조 | rc=0·0·1(변이 생존, 대조는 잡힘) | `~/r8-review-a-logs/pass2/` | +| B | 탐침 P1~P6(GraphQL 등록 매핑, 멱등 저장소 넷, STOMP interceptor) | B 노트 3절 | desktop `~/r8-review-b-logs/` | + +탐침 코드는 공유 노트 폴더 `r8-review-a-probes/`(A), `r8-review-b-probes/`(B)에 있어 고칠 때 RED 테스트로 옮겨 쓸 수 있다. 두 리뷰 모두 라운드 끝 +게이트는 다시 돌리지 않았다. 마지막 실행은 18.8절의 `48565718`이다(`83a12f66`과 코드가 같다). + +### 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 로그 줄 하나다 | 소유자 | + +개선 제안(결함 아님, 총괄이 받거나 닫는다): B가 18.6절 셋째(web 필터가 던진 carrier)를 결함 아님으로 판정하며, web README에 "필터에서 +던진 예외는 `GlobalExceptionHandler`를 거치지 않고 컨테이너가 예외째 로그를 남긴다(persistence 원인 포함)" 한 줄을 제안했다. web +README 「EnvelopeErrorController」 절(`src/adapter/inbound/web/README.md:302-308`)이 이미 "필터가 던진 예외는 `GlobalExceptionHandler`를 지나지 +않는다"를 적는다. 남는 것은 컨테이너 로그 이야기이고, 이 리뷰는 그것을 실행으로 확인하지 않았다. 받으면 그 줄을 확인하는 테스트와 함께 더한다. + +### 19.5 18.6절에서 넘어온 「남은 항목」 판정 + +| 항목 | 판정 | 어디 | +|---|---|---| +| 멱등: 다른 retention의 markFailed, Redis start `ALREADY` | 결함 | RR8-04-01, RR8-04-02 | +| 아키텍처: STOMP channel interceptor | 결함 | RR8-02-01 | +| 아키텍처: 설정 클래스 자신에 쓴 WebFlux `WebFilter`·`WebHandler` | 결함 아님 | 매뉴얼 07 「규칙이 못 보는 길」이 적은 사각지대, WebFlux는 classpath에 없음(round8/02) | +| 전송 오류: web 필터가 던진 carrier → 500 | 결함 아님 | `EnvelopeErrorController` Javadoc·web README가 적은 동작, 템플릿 필터는 carrier를 던지지 않음(round8/01). B의 개선 제안은 19.4절 끝 | +| 이력 ID 범위 | 결정 필요 | 19.4절 ③ | + +### 19.6 멈춤 기준 상태 (`docs/work/improve.md` 4.5절, 2026-11-07) + +1. 마지막 확인 리뷰 발견 0: **아님.** round8 10건(19.1절). +2. 열린 「Declined to judge」 0: **아님.** round8/01의 1건(인자 변환 단계의 감싼 carrier)을 19.4절 ④로 올렸다. 답을 받으면 닫힌다. B는 Declined가 + 없다. +3. 합친 트리의 라운드 끝 게이트: 현재 트리는 **참**(18.8절, `48565718` = `83a12f66`과 코드가 같음). round8 수정을 합친 뒤 다시 돌린다. +4. README의 남은 항목 0: **아님.** 19.4절 결정 넷과 개선 제안 하나가 답을 기다린다. 18.6절 남은 항목 넷은 모두 판정했다(19.5절). + +다음 라운드는 수정 묶음 → round9 확인 리뷰다. 수정이 Important 둘(RR8-01-01, RR8-03-01)을 고치므로 round9도 독립 리뷰어 둘이다(4.1절 셋째 경우). +RR8-06-01은 결함으로 두고 다음 수정 묶음에서 고친다. 고치기 전까지 독립 리뷰어 라운드의 정본 리뷰어는 이번처럼 임시 사본으로 색인 검사를 보인다. diff --git a/docs/reviews/2026-11-03-rereview/round8/01-transport-errors.md b/docs/reviews/2026-11-03-rereview/round8/01-transport-errors.md index 647f2357..e001e292 100644 --- a/docs/reviews/2026-11-03-rereview/round8/01-transport-errors.md +++ b/docs/reviews/2026-11-03-rereview/round8/01-transport-errors.md @@ -117,8 +117,9 @@ desktop 임시 worktree `~/workspace/r8-review-a`(`83a12f66`)와 `~/workspace/r8 - 고치는 법이 공개 응답을 되돌리므로 `docs/work/improve.md` 7절대로 소유자 확인이 필요하다. 다만 결정 전제 밖에서 바뀐 것을 결정 범위로 되돌리는 것이다. - **이번 수정 / 이전부터**: 이번 수정(회귀). - **증거**: E2 — 명령 A1·A2(같은 탐침을 두 커밋에서). 순서·문서 대조는 E1. +- **합칠 때 덧붙인 것(2026-11-07, `B-01-01`)**: 리뷰어 B가 같은 결함을 같은 모양으로 찾았다(B 탐침 P1, `~/r8-review-b-logs/`). B가 더 본 모양 하나: 서비스가 `LockAcquisitionTimeoutException` 자체를 `GraphQlExceptionResolver`에 등록해 두었으면(수정 전에는 500이라 둘 이유가 있었다) 그 매핑이 쓰이지 않고 `LOCK_ACQUISITION_TIMEOUT`이 나간다. 이 모양은 실패 **자신**이 carrier라, 권장안으로 순서를 고쳐도 그대로다. 그래서 어느 안을 고르든 업그레이드 안내 B-45의 "이 예외에 자기 `@ExceptionHandler`를 둔 서비스는 그쪽 응답이 그대로 나간다"(web 이야기)에 GraphQL 등록 매핑은 무시된다는 줄을 더한다. -### RR8-01-02 · Important · 락 timeout이 4xx가 되며 어느 락인지 서버 어디에도 남지 않는데, runbook은 그 정보가 없는 metric과 없는 테이블을 보라고 한다 +### RR8-01-02 · Minor · 락 timeout이 4xx가 되며 어느 락인지 서버 어디에도 남지 않는데, runbook은 그 정보가 없는 metric과 없는 테이블을 보라고 한다 - **위치**: - 문서: `docs/runbooks/lock-acquisition-timeout.md:17`("A 4xx answer, so no server ERROR line — look at the metric"), `:25`("Check `lock.acquisition` metric for lock name and duration"), `:26`("check DB `integration_lock` table"). @@ -133,12 +134,17 @@ desktop 임시 worktree `~/workspace/r8-review-a`(`83a12f66`)와 `~/workspace/r8 - **발생 조건·영향**: - 조건: 락 경합이 늘어 409 `LOCK_ACQUISITION_TIMEOUT`이 쌓이고, 운영자가 이 runbook을 연다. - 영향: 운영자는 runbook대로 metric에서 락 이름을 찾지 못하고, 없는 테이블을 조회한다. 어느 임계 구역이 경합하는지 알아낼 길이 runbook에 없다. 수정 전에는 적어도 ERROR 로그에 key가 있었다. - - Important로 둔 이유: 운영자에게 틀린 조치를 시키는 runbook이다(`review-criteria.md` 3절). runbook이 `status: stub`이어도 `error_codes`가 이 코드를 가리키는 유일한 문서다. + - 처음에는 Important로 적었다(운영자에게 틀린 조치를 시키는 runbook). 두 리뷰를 합칠 때(2026-11-07) Minor로 정했다. 아래 「심각도 조정」. - **테스트가 못 본 이유**: runbook을 읽는 테스트(`RunbookCoverageContractTest`)는 front matter의 `error_codes`와 stub 여부만 본다. 이 runbook은 그 테스트의 stub 허용 목록(`RunbookCoverageContractTest.java:101`)에 있다. 본문 절차를 실행하는 lane이 없다. 4xx carrier가 로그를 남기지 않는 것은 의도된 동작이고, 락에 대해 그 결과를 따로 보는 테스트가 없다. - **고치는 법**: - 권장: runbook Diagnosis를 있는 정보로 다시 쓴다. ① 경합 비율은 `lock.acquisition{outcome=timeout}`(이름·시간 없음을 명시). ② multi-instance면 holder는 `INT_LOCK`의 `REGION`·`CLIENT_ID`·`CREATED_DATE`로 보고, `LOCK_KEY`가 key의 UUID라 key 이름을 직접 볼 수 없다고 적는다. ③ 그 SQL에 `runbook-sql` 표시를 달아 다른 runbook처럼 실 PostgreSQL lane이 읽어 돌린다. 예외 Javadoc·application-core README의 "서버 로그 전용"은 "로그에 남지 않는다. 클라이언트에 보내지 않는다"로 고친다. - 대안: 락 timeout에 WARN 한 줄(key의 digest, 대기 시간)을 남기는 곳을 정한다(`MeteredDistributedLock`). key에 엔티티 id가 들 수 있어 원문은 남기지 않는다(persistence-jpa `CLAUDE.md` 「Non-negotiables」). 그러면 runbook이 그 줄을 가리킬 수 있다. 로그 정책을 바꾸므로 소유자 결정이다. - RED 테스트 모양: 권장안은 문서 수정이라 코드 RED가 없다. runbook SQL을 실 PostgreSQL에서 돌리는 테스트를 더하면, 지금 runbook의 `integration_lock`로는 "relation does not exist"로 실패한다. +- **심각도 조정(2026-11-07, 두 리뷰를 합칠 때)**: 리뷰어 A는 Important, B는 Minor(`B-01-02`)로 봤다. `review-criteria.md` 3절로 Minor로 정한다. + - Important의 "운영자에게 틀린 조치를 시키는 문서"는 절차로 내놓은 문서를 말한다. 이 runbook은 front matter `status: stub`이고 본문 끝이 "author body after domain adoption"이라 적어, 절차가 아니라 채울 자리로 내놓았다. `RunbookCoverageContractTest.java:101`의 stub 허용 목록에도 있다. + - "현실적 조건"을 보면, 템플릿 코드는 `DistributedLockPort.tryAcquire`를 부르지 않는다(main 코드 grep: 포트를 쓰는 곳은 락 adapter와, bean 타입만 확인하는 `StartupSafetyValidator`뿐). 이 코드는 포트를 쓰기로 한 서비스에서만 나고, 그 서비스가 runbook 본문을 쓸 차례다. + - 피해는 진단을 못 하는 것이다. 응답·데이터·보안·공개 계약은 맞다. + - 반론: 이번 수정이 이 runbook을 고쳐(`last_updated`, Symptoms) 관리되는 문서처럼 보이게 했다. 그래서 등급은 낮추되, runbook을 `active`로 올리기 전에 Diagnosis 두 줄을 먼저 고쳐야 한다는 점은 그대로 둔다. - **이번 수정 / 이전부터**: 섞임. Diagnosis 두 줄의 잘못은 이전부터다. 이번 수정이 key가 남던 유일한 로그를 없애고 runbook에 "metric을 보라"를 더해, 틀린 안내가 유일한 진단 경로가 됐다. - **증거**: E1 — 위 `file:line`(레지스트리 정의, adapter 코드, `ServerFailureLog.of`의 분기). @@ -152,11 +158,11 @@ README 18.6절 4번이 "다음 확인 리뷰가 판정한다"고 넘긴 전송 ## Declined to judge -- `MethodArgumentTypeMismatchException`·`HttpMessageNotReadableException`처럼 Spring MVC가 감싸 web 전용 처리기로 가는 실패에 carrier가 원인으로 있는 경우(사용자 `Converter`나 Jackson creator가 carrier를 던짐): web은 원인을 보지 않고 `BAD_PARAMETER`·`VALIDATION_FAILED`로 답하고, STOMP는 `ConversionFailedException`의 원인 carrier로 로그를 정한다. 결정 「감싼 carrier를 전송이 읽는 법」이 전송 처리기 앞단(인자 변환)까지 덮는지 정해진 것이 없다. 템플릿에 carrier를 던지는 변환기가 없어(grep) 결함으로 세지 않았다. 맡긴 쪽이 결정 범위를 정할 일이다. +- `MethodArgumentTypeMismatchException`·`HttpMessageNotReadableException`처럼 Spring MVC가 감싸 web 전용 처리기로 가는 실패에 carrier가 원인으로 있는 경우(사용자 `Converter`나 Jackson creator가 carrier를 던짐): web은 원인을 보지 않고 `BAD_PARAMETER`·`VALIDATION_FAILED`로 답하고, STOMP는 `ConversionFailedException`의 원인 carrier로 로그를 정한다. 결정 「감싼 carrier를 전송이 읽는 법」이 전송 처리기 앞단(인자 변환)까지 덮는지 정해진 것이 없다. 템플릿에 carrier를 던지는 변환기가 없어(grep) 결함으로 세지 않았다. 맡긴 쪽이 결정 범위를 정할 일이다. 두 리뷰를 합칠 때(2026-11-07) README 19.4절 ④의 결정 행으로 올렸다. ## 결론 -Critical 0, Important 2, Minor 0, 회귀 1(RR8-01-01). 결함 2건: 이번 수정 1건, 섞임 1건. +Critical 0, Important 1, Minor 1, 회귀 1(RR8-01-01). 결함 2건: 이번 수정 1건, 섞임 1건. (처음 적을 때는 Important 2였다. RR8-01-02를 두 리뷰를 합칠 때 Minor로 정했다.) - RR7-01-03·04·06과 r8-f1 범위 밖 두 건은 닫혔다. RR7-01-05는 네 전송이 같은 함수를 쓰게 됐지만, GraphQL에서 그 함수의 자리가 등록 매핑보다 앞이라 결정 범위 밖의 응답을 바꿨다. diff --git a/docs/reviews/2026-11-03-rereview/round8/02-architecture-rules.md b/docs/reviews/2026-11-03-rereview/round8/02-architecture-rules.md index ebb6a4bf..5ba7b377 100644 --- a/docs/reviews/2026-11-03-rereview/round8/02-architecture-rules.md +++ b/docs/reviews/2026-11-03-rereview/round8/02-architecture-rules.md @@ -84,6 +84,7 @@ websocket adapter의 STOMP 설정(`WebSocketConfig.configureClientInboundChannel - RED 테스트 모양: 위반 fixture 둘(설정에 중첩된 익명 interceptor, `simp` 타입을 쓰지 않는 최상위 interceptor)이 `@SystemCaller`를 부르고, `83a12f66`에서 위반 0으로 실패하는 것을 본다. 허용 fixture: 같은 설정이 interceptor 없이 broker만 설정. fixture는 `spring-messaging`이 필요해 `architectureTestCompileOnly`와 lockfile을 함께 바꾼다. - **이번 수정 / 이전부터**: 섞임. 목록의 빈칸은 이전부터다(r8-f2 보고 「범위 밖」이 같은 것을 적었다). 이번 수정이 매뉴얼에 "중첩 클래스는 사각지대에 들지 않는다"를 더했다. - **증거**: E1 — 위 `file:line`. 탐침은 컴파일 classpath 때문에 쓰지 않았다(「실행한 명령과 결과」). +- **합칠 때 덧붙인 것(2026-11-07, `B-02-01`)**: 리뷰어 B가 같은 결함을 탐침으로 확인했다(B 탐침 P4, 버릴 worktree에서 `architectureTestCompileOnly 'org.springframework:spring-messaging'`과 lockfile 한 줄을 더하고 `--write-locks`로 실행, `~/r8-review-b-logs/`). 결과: `StompHeaderAccessor`를 읽는 interceptor는 잡히고 일반 `ChannelInterceptor`는 잡히지 않는다. 증거는 E2(B의 실행)로 올린다. B는 이 결함을 「이전부터」로 적었다. 이 리뷰는 매뉴얼 07 `:135`의 새 문장이 이 빈칸을 덮었다고 약속해 「섞임」으로 둔다. ## 18.6절에서 넘어온 항목 판정 diff --git a/docs/reviews/2026-11-03-rereview/round8/03-migration.md b/docs/reviews/2026-11-03-rereview/round8/03-migration.md index 598604b8..a5670314 100644 --- a/docs/reviews/2026-11-03-rereview/round8/03-migration.md +++ b/docs/reviews/2026-11-03-rereview/round8/03-migration.md @@ -99,7 +99,7 @@ A9 `-p build-logic test --rerun`: rc=0, 41초, 직전 부하 5.13, 173건 실패 | ID | 판정 | 근거 | |---|---|---| -| RR7-03-01 (ledger IT의 없는 예외 목록) | 닫힘 | `GrpcOperationLedgerMigrationLockWaitIT.java`의 `RUN_OUTSIDE_A_TRANSACTION`과 그 목록을 가이드에 묶는 테스트, 파일마다 따로 실행하는 `GrpcOperationLedgerMigrations.before` | +| RR7-03-01 (ledger IT의 없는 예외 목록) | 부분(합칠 때 고침) | `GrpcOperationLedgerMigrationLockWaitIT.java`의 `RUN_OUTSIDE_A_TRANSACTION`과 그 목록을 가이드에 묶는 테스트, 파일마다 따로 실행하는 `GrpcOperationLedgerMigrations.before`. 처음에는 닫힘으로 적었다. 목록을 지키는 테스트가 빈 목록 위에서 아무것도 단언하지 않는 것은 아래 RR8-03-04 | | RR7-03-02 (REINDEX 다섯 형태 설명) | 닫힘 | 가이드 `:80-91`·`:136-141`, 검사기 Javadoc, 학습 문서 8.2절이 "SCHEMA·DATABASE는 Flyway가 트랜잭션 밖, INDEX·TABLE CONCURRENTLY는 안"으로 같다 | | RR7-03-03 (실패 행 때문에 다음 배포가 막힘) | 부분 | `CREATE [UNIQUE] INDEX CONCURRENTLY`는 runbook 절차로 복구된다(기존 IT). `DROP INDEX CONCURRENTLY`는 같은 절차로 다시 막힌다(RR8-03-01) | | RR7-03-04 ("섞인 파일은 부분 적용되지 않는다") | 닫힘 | 설정 없음/`executeInTransaction=false` 두 경우를 IT가 고정, 문서가 두 경우를 나눠 적음 | @@ -140,13 +140,55 @@ A9 `-p build-logic test --rerun`: rc=0, 41초, 직전 부하 5.13, 173건 실패 - **이번 수정 / 이전부터**: 이번 수정. - **증거**: E1 — 위 `file:line`. +## 합칠 때 넣은 결함 (2026-11-07, 총괄 요청) + +독립 리뷰어 B에게만 있던 두 결함(`B-03-01`, `B-03-02`, 노트 `r8-review-b.md` 6절)을 총괄이 보냈다. 근거를 다시 읽고 하나는 변이 탐침으로 확인해 +이 영역의 다음 번호로 넣었다. + +| # | 명령 | 대상 | 결과 | 시간 | 직전 부하(1분) | +|---|---|---|---|---|---| +| A10 | `-p optional-platforms :grpc:grpc-operation-ledger-jpa:integrationTest --tests '*GrpcOperationLedgerMigrationLockWaitIT.everyMigrationListedAsRunningOutsideATransactionIsOneConcurrentIndexBuildThatSaysSo'` | `83a12f66` 그대로 | rc=0, 1건 통과 | 13초 | 0.13 | +| A11 | 같은 명령 | 변이: 루프 안 거부 조건 셋(트리에 없음, 동시 인덱스 문장 없음, 검사기 예외)에 모두 `&& migration.isEmpty()`를 붙여 아무것도 거부하지 못하게 함 | rc=0, 1건 통과 — 변이가 살아남음 | 6초 | 0.80 | +| A12 | 같은 명령 | 원래 코드 + 목록에 트리에 없는 파일 하나(`V999__not_in_the_tree.sql`) | rc=1, 1건 실패 `… is not a migration in the ledger tree` | 5초 | 1.13 | + +desktop 임시 worktree `~/workspace/r8-review-a-pass2`(`83a12f66`), 공유 잠금, `--no-build-cache`, FROM-CACHE 0, 로그 `~/r8-review-a-logs/pass2/`. +변이 스크립트는 공유 노트 `r8-review-a-probes/pass2/ledger_mutation.py`, 결과 `pass2/results.txt`. worktree는 지웠다. + +### RR8-03-03 · Minor · runbook SQL 리더 `OutboxRunbookSql`이 이제 마이그레이션 runbook도 읽는데 이름은 outbox 전용이다 + +- **위치**: `src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/OutboxRunbookSql.java:9-18`(Javadoc "the outbox runbooks, and the migration runbook's recovery"), 사용처 `PostgreSqlConcurrentIndexMigrationIntegrationTest.java:209`(마이그레이션 runbook), `PostgreSqlOutboxDispositionRunbookIntegrationTest.java:44-50`, `PostgreSqlOutboxOrderKeyRunbookIntegrationTest.java:50-56`. +- **무엇이 틀렸나**: 클래스는 runbook 하나에서 `runbook-sql` 블록을 읽는 공용 리더가 됐다. 이름 `OutboxRunbookSql`은 outbox runbook 전용이라고 말한다(관점 24 「이름과 내용이 다름」). 이번 수정이 Javadoc만 넓히고 이름은 두었다(공유 노트 `r8-f3-persistence.md` 「합칠 때 볼 것」 "이름은 그대로"). +- **발생 조건·영향**: 다음에 다른 runbook(예: RR8-01-02를 고칠 때의 `INT_LOCK` 조회)의 SQL을 lane으로 돌리려는 사람이 이름으로 공용 리더를 찾지 못하고 사본을 만든다. 사본은 runbook과 갈라질 수 있다(A1). 동작 영향은 없다. +- **테스트가 못 본 이유**: 이름은 검사 대상이 아니다. +- **고치는 법**: `RunbookSql`로 이름을 바꾼다. 사용처 세 클래스는 같은 source set이다. 동작 변경 없음이라 RED가 없고, 같은 source set의 IT lane 셋이 그대로 통과하는지 본다. +- **이번 수정 / 이전부터**: 이번 수정(`6ec0c4f7`). +- **증거**: E1 — 위 `file:line`과 사용처 grep. 이름 문제라 탐침으로 더 알 것이 없다. +- **출처**: 리뷰어 B `B-03-01`. + +### RR8-03-04 · Minor · ledger IT의 예외 목록 검사 테스트가 빈 목록 위에서 돌아, 검사 코드를 망가뜨려도 통과한다 + +- **위치**: `src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerMigrationLockWaitIT.java:88`(`RUN_OUTSIDE_A_TRANSACTION = Map.of()`), `:141-177`(`everyMigrationListedAsRunningOutsideATransactionIsOneConcurrentIndexBuildThatSaysSo`, 루프 `:149`, 단언 `:176`). 이 테스트를 지키는 장치로 가리키는 곳: `docs/jpa/migration-guide.md:126-128`, 같은 IT의 실패 메시지(`:125-133`). +- **무엇이 틀렸나**: + - 테스트 이름이 말하는 성질은 "목록의 파일은 트리에 있고, 동시 인덱스 문장 하나이고, `executeInTransaction=false`를 적었다"다. + - 목록이 비어 있어 루프 본문이 한 번도 돌지 않는다. 단언 `refused.isEmpty()`는 늘 참이다. + - 변이 A11: 거부 조건 셋을 모두 무력하게 바꿔도 통과한다. 대조 A12: 원래 코드는 목록에 잘못된 파일이 들어가면 잡는다. 검사 코드는 지금 맞지만, 그것을 지키는 테스트가 없다. +- **발생 조건·영향**: 누가 이 검사 코드를 고치다 망가뜨려도 빌드는 모른다. 첫 동시 인덱스 파일이 목록에 들어갈 때 처음으로 검사가 돌고, 그때 망가진 검사가 가이드를 어긴 파일(섞인 문장, `.conf` 없음)을 통과시킨다. 가이드는 이 테스트가 목록을 지킨다고 적는다. +- **테스트가 못 본 이유**: 규칙 테스트에 위반·허용 fixture가 없다(`review-criteria.md` 7절). r8-f3는 임시 V004 탐침으로 확인했고 탐침은 repo에 남지 않았다. +- **고치는 법**: + - 권장: 판정을 static 메서드로 뺀다. 입력은 목록, 트리, 파일 이름 → SQL, 파일 이름 → `executeInTransaction`이고 출력은 거부 이유 목록이다. 같은 IT에 문자열 fixture로 위반 넷(트리에 없음, 동시 인덱스 문장 없음, `.conf` 없음, 다른 문장과 섞임)과 허용 하나(동시 인덱스 문장 하나 + `executeInTransaction=false`)를 두고 그 메서드를 부른다. 실제 목록 검사도 그 메서드를 부른다. + - 대안: 판정을 testkit의 `ConcurrentIndexMigrationInspector` 쪽으로 옮겨 persistence-jpa 단위 테스트가 fixture를 갖게 한다. ledger는 이미 그 파일을 복사해 쓰므로 같은 검사가 두 빌드에서 돈다. 다만 복사 파일이 늘면 "JDK만" 규칙을 지킬 파일이 늘어난다. + - RED 테스트 모양: 위반 fixture 넷이 각각 거부되는지 단언한다. A11의 변이를 얹으면 그 테스트들이 실패해야 한다. +- **이번 수정 / 이전부터**: 이번 수정(`6ec0c4f7`). +- **증거**: E2 — 명령 A10~A12(이름 붙은 테스트를 원래·변이·대조로 실행). +- **출처**: 리뷰어 B `B-03-02`. 이 리뷰는 처음에 RR7-03-01을 닫힘으로 적었다. + ## Declined to judge 없다. ## 결론 -Critical 0, Important 1, Minor 1, 회귀 0. 결함 2건, 모두 이번 수정이 만들었다. +Critical 0, Important 1, Minor 3, 회귀 0. 결함 4건, 모두 이번 수정이 만들었다. 그중 RR8-03-03·04는 두 리뷰를 합칠 때 넣었다. -- RR7-03-01·02·04·05·06은 닫혔다. 검사기 변경과 Flyway 규칙은 주장대로 동작하고 위반·허용 fixture를 둘 다 가진다. +- RR7-03-02·04·05·06은 닫혔다. RR7-03-01은 목록과 안내는 생겼지만 목록 검사를 지키는 테스트가 없다(RR8-03-04). 검사기 변경과 Flyway 규칙은 주장대로 동작하고 위반·허용 fixture를 둘 다 가진다. - RR7-03-03은 부분이다. 새 runbook 절차는 `CREATE` 실패에는 맞지만, 절이 대상으로 넣은 `DROP INDEX CONCURRENTLY` 실패에는 같은 막힌 상태로 돌아간다. diff --git a/docs/reviews/2026-11-03-rereview/round8/04-idempotency.md b/docs/reviews/2026-11-03-rereview/round8/04-idempotency.md index 6d4480ba..8e536446 100644 --- a/docs/reviews/2026-11-03-rereview/round8/04-idempotency.md +++ b/docs/reviews/2026-11-03-rereview/round8/04-idempotency.md @@ -96,6 +96,7 @@ A8(application-core·cache-redis·persistence-jpa `test` 포함)은 [03 문서]( - RED 테스트 모양: 공유 계약에 두 케이스를 정한 답으로 더한다. `83a12f66`에서 탐침 표의 칸대로 저장소 일부가 실패한다. - **이번 수정 / 이전부터**: 섞임. Redis·PostgreSQL의 답과 Javadoc의 불일치는 이전부터다. fake가 다른 retention에 "이미 처리됨"을 주게 된 것은 이번 수정이다. r8-f4 보고 「범위 밖」 1과 README 18.6절이 같은 것을 적었다. - **증거**: E3 — 명령 A3~A6(실 Redis·실 PostgreSQL 포함). 코드 경로는 E1. +- **합칠 때 덧붙인 것(2026-11-07, `B-04-01`)**: 리뷰어 B가 같은 값을 얻었다(B 탐침 P2·P3·P5·P6). B는 「이전부터」로 적었다. 이 리뷰는 fake의 다른 retention 답이 이번 수정으로 `NOT_OWNER`에서 `ALREADY_MARKED_SAME_OPERATION`으로 바뀌어 「섞임」으로 둔다. 고치는 법은 두 리뷰의 권하는 안이 disposition 차이에서 다르다(B: `NOT_OWNER` 유지, 이 리뷰: `OPERATION_CONFLICT`). 소유자 결정 표는 README 19.4절이다. ### RR8-04-02 · Minor · Redis는 renew를 적용한 핸들이 start를 보내도 "이미 시작됨"으로 답해, 그 답을 받은 호출자가 작업을 다시 실행한다 — fake와 PostgreSQL은 `NOT_OWNER`다 @@ -118,6 +119,7 @@ A8(application-core·cache-redis·persistence-jpa `test` 포함)은 [03 문서]( - RED 테스트 모양: 탐침 셋째를 공유 계약 케이스로 옮긴다(renew 뒤 같은 핸들의 start → `NOT_OWNER`). `83a12f66`에서 Redis 명령 fake와 실 Redis가 `ALREADY_STARTED_SAME_OPERATION`으로 실패한다. - **이번 수정 / 이전부터**: 이전부터. start의 ALREADY 조건은 round6부터 `rev == handle rev + 1`이었다. r8-f4 보고 「범위 밖」 2와 README 18.6절이 같은 것을 적었다. - **증거**: E3 — 명령 A4·A5(Redis 명령 fake와 실 Redis), A3·A6(fake·실 PostgreSQL 비교). +- **합칠 때 덧붙인 것(2026-11-07, `B-04-02`)**: 리뷰어 B가 같은 값을 얻었다(B 탐침 P3·P6, 대조 P2·P5). 분류(이전부터)와 고치는 법(Redis 기록에 마지막 전이 종류를 남김)이 같다. ## 18.6절에서 넘어온 항목 판정