docs(review): round7 처리 표와 소유자 답을 리뷰 README 18절에 적는다
문제: round7 수정 브랜치 다섯 개와 매뉴얼 브랜치 둘을 합쳤는데, 리뷰 README 18절에는 1차 Declined 판정에서 올린 발견 둘(RR7-02-02, RR7-03-06)이 색인 표에 없고, 18.4절 결정 4건에 소유자 답이 없고, 결함마다 어느 커밋이 고쳤는지 적은 곳이 없다. 방법: 18.1절 색인 표에 두 행을 더하고 머리 집계를 15건으로 고친다. 18.4절 표에 「소유자 답」 칸을 두고 결정 색인(docs/work/reference/decisions.md 2.3·2.5·2.7절)에 적힌 날짜와 함께 (a)를 적는다. 18.5절의 "색인 표에는 넣지 않았다" 문장을 지금 사실로 고친다. 18.7절에 결함별 상태·고친 커밋· 검증을 적는다. 검증 칸은 각 커밋 본문에서 옮겼다. 위험·한계: 18.6절 멈춤 기준과 합친 트리 게이트는 게이트를 돌린 뒤 다음 커밋에서 적는다. 검증: python3 scripts/check-review-index.py docs/reviews/2026-11-03-rereview (172건 모두 색인에 있음), check-work-docs.py --links로 이 README 상대 링크 22개 깨짐 0. 이 README를 읽는 테스트는 없다(src grep, CLAUDE.md 두 곳만 걸림).
This commit is contained in:
@@ -427,8 +427,8 @@ pathspec은 각 영역 문서 「범위」에 있다.
|
||||
|
||||
### 18.1 결과
|
||||
|
||||
Critical 0, Important 2, Minor 11, 회귀 1. 결함 13건: 이번 수정이 만든 것 4건, 섞임 2건(이전부터 있던 것을 이번 수정이 넓히거나 새로
|
||||
약속함), 이전부터 7건.
|
||||
Critical 0, Important 2, Minor 13, 회귀 1. 결함 15건: 이번 수정이 만든 것 5건, 섞임 2건(이전부터 있던 것을 이번 수정이 넓히거나 새로
|
||||
약속함), 이전부터 8건. 그중 RR7-02-02·RR7-03-06 두 건은 2026-11-07 1차 「Declined to judge」 판정(18.5절)에서 올렸다. 처리는 18.7절이다.
|
||||
|
||||
| ID | 심각도 | 내용 | 이번 수정 / 이전부터 | 출처 | 증거 |
|
||||
|---|---|---|---|---|---|
|
||||
@@ -439,11 +439,13 @@ Critical 0, Important 2, Minor 11, 회귀 1. 결함 13건: 이번 수정이 만
|
||||
| RR7-01-05 | Minor | 감싼 carrier를 web·GraphQL·STOMP는 못 보고 gRPC만 찾아 응답 코드·로그가 전송마다 다르다 | 이전부터 | round6 01 Declined | E1 |
|
||||
| RR7-01-06 | Minor | STOMP payload 변환·검증 실패를 ERROR와 예외 메시지(입력 조각)로 남긴다 | 이전부터 | round6 01 Declined | E1 |
|
||||
| RR7-02-01 | Minor | httpclient `ClientRuntimeRegistry.close()`가 interrupt 상태면 drain 스레드 종료를 확인하지 않고 정상 반환 | 이전부터 | round6 02 Declined | E1 |
|
||||
| RR7-02-02 | Minor | in-memory fake가 시작을 적용한 같은 핸들의 재시작(응답 유실)에 `NOT_OWNER` — 두 저장소·포트 Javadoc은 `ALREADY_STARTED_SAME_OPERATION` | 이전부터 | 이 리뷰 1차 02 Declined | E1 |
|
||||
| RR7-03-01 | Minor | ledger 잠금 대기 IT가 "예외로 적으라"고 안내하지만 예외를 적을 곳이 없다 | 이번 수정 | 이 리뷰 | E1 |
|
||||
| RR7-03-02 | Minor | "Flyway는 `REINDEX … CONCURRENTLY`를 트랜잭션 안에서 돌린다"가 `SCHEMA`·`DATABASE` 형태에서 틀린다 | 섞임 | 이 리뷰 | E3 |
|
||||
| RR7-03-03 | Important | 실패한 동시 인덱스 복구를 "`DROP INDEX` 하나"로 안내하지만 `success=false` 이력 행이 다음 배포를 막고 runbook은 그 행 삭제를 금지 | 이전부터 | 다른 리뷰 | E3 |
|
||||
| RR7-03-04 | Minor | "섞인 파일은 부분 적용되지 않는다"가 `.sql.conf`(`executeInTransaction=false`)를 붙이면 틀린다 | 이번 수정 | 다른 리뷰 | E3 |
|
||||
| RR7-03-05 | Minor | 잠금 대기 검사기 Javadoc은 `VACUUM FULL`을 늘 거부한다지만 `executeInTransaction=true` 설정 파일에서는 통과 | 이전부터 | round6 03 Declined | E1 |
|
||||
| RR7-03-06 | Minor | "코드로 만드는 Flyway는 모두 `FlywaySchemaPolicy.configure()`에서" 규칙을 ArchUnit이 `Flyway.configure()` 호출로만 지켜 `new FluentConfiguration()`·`new ClassicConfiguration()`이 빠진다 | 이번 수정 | 이 리뷰 1차 03 Declined | E1 |
|
||||
| RR7-05-01 | Minor | 메시지·B-36은 "매 push·PR·schedule"을 요구하지만 판독기는 `paths:` 필터 workflow도 센다 | 섞임 | 이 리뷰(round6 04 Declined와 같음) | E2 |
|
||||
|
||||
r10이 고쳤다고 한 항목의 재확인(영역 문서 「항목 재확인」):
|
||||
@@ -497,12 +499,14 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0).
|
||||
|
||||
### 18.4 결정이 필요한 것
|
||||
|
||||
| 항목 | 선택지 | 권하는 안과 이유 | 정할 사람 |
|
||||
|---|---|---|---|
|
||||
| RR7-05-01(= round6 04 Declined ①) 경로 필터 workflow를 단계 실행으로 셀지 | (a) `paths:`·`paths-ignore:` trigger만으로는 세지 않는다 (b) 세고, 메시지·B-36의 "매 변경" 약속을 고친다 | (a). 단계 검사는 "모든 변경이 이 lane을 지난다"를 보장하려는 것이고 경로 필터는 그 보장을 깬다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다 | 소유자 |
|
||||
| RR7-03-03 실패한 동시 인덱스 마이그레이션의 복구 절차 | (a) runbook에 "그 버전의 실패 이력 행만 지운다" 예외와 SQL(`DELETE FROM <history_table> WHERE version = '<v>' AND NOT success`)을 둔다 (b) 이 경우 `flyway repair`를 허용한다 (c) 동시 인덱스 마이그레이션을 금지하고 운영 절차로 돌린다 | (a). 실패 행은 적용되지 않은 버전의 기록이라 지워도 성공한 마이그레이션의 순서·checksum은 그대로다(명령 B4 넷째 경우로 재배포 성공 확인). (b)의 repair는 checksum·설명까지 다시 맞춰 가이드가 막으려는 불일치를 지운다. (c)는 r10이 이미 버린 대안이다(큰 테이블 인덱스 추가가 번거로워짐). "이력을 고치지 않는다" 정책의 예외라 소유자 확인이 필요하다 | 소유자 |
|
||||
| RR7-01-05(= round6 01 Declined ①) 감싼 carrier를 전송이 어떻게 볼지 | (a) 네 전송 모두 원인 사슬의 첫 carrier를 본다 — web·GraphQL·STOMP에서 감싼 carrier의 응답이 500 → carrier 코드로 바뀐다 (b) 네 전송 모두 맨 위만 본다 — gRPC 응답이 carrier 코드 → `INTERNAL`로 바뀐다 (c) 차이를 두고 문서화한다 | (a). use case가 뜻한 코드로 답하고, persistence 실패의 SQL 원인이 어느 전송 로그에도 남지 않는다. gRPC가 이미 그렇게 해서 바뀌는 쪽이 셋이지만, 바뀌는 응답은 지금 500 `INTERNAL_ERROR`로 뭉개지는 경우뿐이다. 응답 코드가 바뀌는 수정이라 고치기 전에 확인받는다(`docs/work/improve.md` 7절) | 소유자 |
|
||||
| round7 05 Declined ①: 태그·릴리스 trigger만 있는 workflow를 단계 실행으로 셀지 | (a) `push`에 `tags:`만 있거나(`branches`·`paths` 없이) `release` trigger만 있는 workflow는 `releaseCheck` 단계에만 센다 (b) 지금처럼 모든 단계에 센다(릴리스 흐름도 변경 흐름의 일부)고 메시지·B-36에 적는다 | (a). 결정 「경로 필터 workflow와 단계 검사」와 같은 원칙이다 — 태그 push는 매 변경에 돌지 않는다. `releaseCheck`는 정의가 "tag 전용 검사"(`src/README.md`)라 예외로 둔다. 이 repo는 `release.yml`(`push: tags: [v*]`)이 `:releaseCheck`·`-p optional-platforms releaseCheck` 말고도 `-p optional-platforms integrationCheck`를 돌리지만, 같은 단계를 `integration-main.yml`(main push·nightly)도 돌려 판정이 바뀌지 않는다 | 소유자 |
|
||||
| 항목 | 선택지 | 권하는 안과 이유 | 정할 사람 | 소유자 답 |
|
||||
|---|---|---|---|---|
|
||||
| RR7-05-01(= round6 04 Declined ①) 경로 필터 workflow를 단계 실행으로 셀지 | (a) `paths:`·`paths-ignore:` trigger만으로는 세지 않는다 (b) 세고, 메시지·B-36의 "매 변경" 약속을 고친다 | (a). 단계 검사는 "모든 변경이 이 lane을 지난다"를 보장하려는 것이고 경로 필터는 그 보장을 깬다. 이 repo의 단계 명령은 필터 없는 workflow에 있어 판정이 바뀌지 않는다 | 소유자 | (a), 2026-11-06. 결정 색인 2.7절 「경로 필터 workflow와 단계 검사」 |
|
||||
| RR7-03-03 실패한 동시 인덱스 마이그레이션의 복구 절차 | (a) runbook에 "그 버전의 실패 이력 행만 지운다" 예외와 SQL(`DELETE FROM <history_table> WHERE version = '<v>' AND NOT success`)을 둔다 (b) 이 경우 `flyway repair`를 허용한다 (c) 동시 인덱스 마이그레이션을 금지하고 운영 절차로 돌린다 | (a). 실패 행은 적용되지 않은 버전의 기록이라 지워도 성공한 마이그레이션의 순서·checksum은 그대로다(명령 B4 넷째 경우로 재배포 성공 확인). (b)의 repair는 checksum·설명까지 다시 맞춰 가이드가 막으려는 불일치를 지운다. (c)는 r10이 이미 버린 대안이다(큰 테이블 인덱스 추가가 번거로워짐). "이력을 고치지 않는다" 정책의 예외라 소유자 확인이 필요하다 | 소유자 | (a), 2026-11-06. 결정 색인 2.5절 「실패한 동시 인덱스 마이그레이션 복구」 |
|
||||
| RR7-01-05(= round6 01 Declined ①) 감싼 carrier를 전송이 어떻게 볼지 | (a) 네 전송 모두 원인 사슬의 첫 carrier를 본다 — web·GraphQL·STOMP에서 감싼 carrier의 응답이 500 → carrier 코드로 바뀐다 (b) 네 전송 모두 맨 위만 본다 — gRPC 응답이 carrier 코드 → `INTERNAL`로 바뀐다 (c) 차이를 두고 문서화한다 | (a). use case가 뜻한 코드로 답하고, persistence 실패의 SQL 원인이 어느 전송 로그에도 남지 않는다. gRPC가 이미 그렇게 해서 바뀌는 쪽이 셋이지만, 바뀌는 응답은 지금 500 `INTERNAL_ERROR`로 뭉개지는 경우뿐이다. 응답 코드가 바뀌는 수정이라 고치기 전에 확인받는다(`docs/work/improve.md` 7절) | 소유자 | (a), 2026-11-06. 결정 색인 2.3절 「감싼 carrier를 전송이 읽는 법」 |
|
||||
| round7 05 Declined ①: 태그·릴리스 trigger만 있는 workflow를 단계 실행으로 셀지 | (a) `push`에 `tags:`만 있거나(`branches`·`paths` 없이) `release` trigger만 있는 workflow는 `releaseCheck` 단계에만 센다 (b) 지금처럼 모든 단계에 센다(릴리스 흐름도 변경 흐름의 일부)고 메시지·B-36에 적는다 | (a). 결정 「경로 필터 workflow와 단계 검사」와 같은 원칙이다 — 태그 push는 매 변경에 돌지 않는다. `releaseCheck`는 정의가 "tag 전용 검사"(`src/README.md`)라 예외로 둔다. 이 repo는 `release.yml`(`push: tags: [v*]`)이 `:releaseCheck`·`-p optional-platforms releaseCheck` 말고도 `-p optional-platforms integrationCheck`를 돌리지만, 같은 단계를 `integration-main.yml`(main push·nightly)도 돌려 판정이 바뀌지 않는다 | 소유자 | (a), 2026-11-07. 결정 색인 2.7절 「태그·릴리스 workflow와 단계 검사」 |
|
||||
|
||||
네 건 모두 소유자가 권하는 안 (a)로 정했다. 적용한 커밋은 18.7절이다.
|
||||
|
||||
### 18.5 round6 「Declined to judge」 30건 판정 (2026-11-06)
|
||||
|
||||
@@ -548,7 +552,7 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0).
|
||||
색인의 2026-11-06 결정 포함). 번호는 각 영역 문서 「Declined to judge」의 순서다(각 영역의 마지막 줄 "round6 …의 Declined"는 위 표가 다뤄 세지
|
||||
않는다). 결과: (a) 3건(그중 1건은 RR7-01-01에 합침), (b) 8건, (c) 1건.
|
||||
|
||||
(a)로 새로 올린 발견 둘은 이 표에만 적었다. 총괄 지시가 18절 판정 표와 18.4절만 고치라고 해서 18.1절 색인 표에는 넣지 않았다.
|
||||
(a)로 새로 올린 발견 둘은 판정 때 이 표에만 적었다(총괄 지시가 18절 판정 표와 18.4절만 고치라고 했다). 2026-11-07 수정 브랜치를 합칠 때 18.1절 색인 표에 더했다.
|
||||
|
||||
| 발견 | 심각도 | 한 줄 내용 | 이번 수정 / 이전부터 | 증거 |
|
||||
|---|---|---|---|---|
|
||||
@@ -579,3 +583,25 @@ lane. 마지막 실행은 17.2절의 `2c692554`다(이 리뷰에는 E0).
|
||||
- round7 1차 Declined 12건(01: 3, 02: 2, 03: 2, 04: 2, 05: 3)은 아직 판정하지 않았다. 각 영역 문서에 있다.
|
||||
3. 합친 트리의 라운드 끝 게이트: r10 트리 `2c692554`에서 통과(17.2절). 이 리뷰는 다시 돌리지 않았다.
|
||||
4. README의 남은 항목 0: **아님.** 위 1·2와 18.4절 결정 3건.
|
||||
|
||||
### 18.7 round7 처리 (2026-11-07)
|
||||
|
||||
round7 결함 15건과 고치다 같이 고친 것을 수정 브랜치 다섯 개(`claude/r8-f1-transport-errors-b21ebf`, `claude/r8-f2-arch-rules-60140e`,
|
||||
`claude/r8-f3-persistence-9e8157`, `claude/r8-f4-idempotency-3a6a0f`, `claude/r8-f5-small-fixes-f40412`)가 고쳤다. 기준은 `73d39212`(리뷰 브랜치
|
||||
`2c8a359d` + 매뉴얼 수정 1차)다. 2026-11-07 매뉴얼 브랜치 둘(`447a77a3`, `81ef58ab`)과 1차 Declined 판정(`cb340001`)과 함께
|
||||
`claude/integration-r8-a4196a`에 합쳤다. 검증 칸은 각 커밋 본문에서 옮겼다. 모두 desktop에서 공유 잠금 아래 돌렸고 로그 경로는 커밋 본문에 있다.
|
||||
|
||||
| 결함 | 상태 | 고친 커밋 | 검증 |
|
||||
|---|---|---|---|
|
||||
| RR7-01-01·02 | 고침 | `a8166598` | RED: 기준 + 테스트·fixture만으로 `ArchitectureViolationFixtureTest` 87건 중 5건 실패(중첩 JAX-RS·설정 경유·`@ServerEndpoint`는 위반 0건, CORS 두 모양은 거짓 위반). GREEN: `:app-bootstrap:architectureTest --rerun` 237건 실패 0. 변이 둘(설정용 목록에 `servlet.function`, 요청 처리기 목록에 `io.vertx.ext.web`)을 `UserTransportTypeListsTest` 2건·fixture 테스트 3건이 잡음. `:ci :verifyDependencyLocks --warning-mode=fail`, `architectureCheck`, `testQualityCheck`, 두 빌드 단계 검사, sample, optional `ci`, compose 검사 rc=0 |
|
||||
| RR7-01-03~06 | 고침 | `5f6a86d7` | RED: 기준 + 테스트만으로 7개 leaf에서 17건 실패(500 `INTERNAL_ERROR`, `INTERNAL`, ERROR + 입력이 든 메시지). GREEN: shared-contract 269, application-core 413, web 334, graphql 401, grpc 74, websocket 105, app-bootstrap 225 실패 0. `:ci :verifyDependencyLocks --warning-mode=fail`, web·graphql·websocket `systemTest`·`:conditionalTransportQualification`, `documentContractTest` 66, 7개 leaf `testQualityCheck` rc=0 |
|
||||
| 같은 모양 추가 2건: `Retry-After` 누락 7개, GraphQL `@Argument` 변환 실패(r8-f1 보고 「범위 밖」 1·2, 소유자 답 2026-11-07 "권하는 안대로") | 고침 | `ef8ef170` | RED: `5f6a86d7` + 테스트만으로 11건 실패(advisor 7, 레지스트리 대조 1, GraphQL 3 — `INTERNAL_ERROR`, ERROR + `BindException` "rejected value [alice@example.com]"). GREEN: `:ci :verifyDependencyLocks --warning-mode=fail`(web test 341, graphql 404, app-bootstrap 225), `documentContractTest` 67, web·graphql `systemTest`·`:conditionalTransportQualification`, `testQualityCheck` rc=0 |
|
||||
| RR7-02-01 | 고침 | `c746f980` | RED: 기준 + 테스트만으로 `closingFromAnInterruptedThreadStillWaitsForTheDrainThread` 실패("Expecting empty but was: [httpclient-runtime-drain]"). GREEN: `ClientRuntimeRegistryTest`, httpclient `check`·`testQualityCheck`, `httpClientStableContractTest`(apache, jdk), `spring70CompatibilityTest`, `:ci` rc=0. interrupt된 채 5초 마감을 넘기는 경로는 테스트하지 않음 |
|
||||
| RR7-02-02 | 고침 | `14435106` | 아래 행과 같은 실행. RED: in-memory fake 계약 59건 중 4건 실패(적용한 핸들의 start·renew·markFailed 재전송, "expected: ALREADY_MARKED_SAME_OPERATION but was: NOT_OWNER" 등) |
|
||||
| 멱등 남은 차이 3건: 넘겨받기 전 핸들의 complete·markFailed 재전송, release한 핸들의 start(결정 「넘겨받기 전 핸들의 재전송」「해제된 핸들로 start」, 2026-11-06) | 고침 | `14435106` | `IdempotencyStoreContract` 10케이스 추가. RED: Redis command fake 2, 실 Redis 2, 실 PostgreSQL 5 실패. GREEN: application-core 422, persistence-jpa 664, cache-redis 225, redis-runtime 65, `redisContainerContractTest` 100, `jpaPlatformContractTest` 429, `postgresqlIdempotencyIntegrationTest` 10, fake를 쓰는 leaf 넷(composition idempotency 32, redis-sdk 310, web 329, sample 339), `documentContractTest` 66 실패 0 |
|
||||
| RR7-03-01~05 | 고침 | `6ec0c4f7` | RED: 기준 + 테스트(+ 기준 문서 주장을 단언하는 임시 메서드, 임시 ledger V004)로 `LockWaitMigrationInspectorTest` 80건 중 2, `postgresqlMigrationLockWaitIntegrationTest` 47건 중 4, `postgresqlConcurrentIndexMigrationIntegrationTest` 9건 중 3, ledger `integrationTest` 6건 중 4 실패. GREEN: persistence-jpa `check`(test 666)·`testQualityCheck`, 두 IT lane 42·7건, optional ledger `check integrationTest testQualityCheck`, `documentContractTest` 66, 두 빌드 단계 검사 rc=0 |
|
||||
| RR7-03-06 | 고침 | `6764246a` | RED: `6ec0c4f7` + fixture·테스트로 `architectureTest` 234건 중 4건 실패(`FluentConfiguration`·`ClassicConfiguration`·하위 클래스·생성자 참조 fixture가 통과). GREEN: `architectureTest` 233건 실패 0, `architectureCheck`, persistence-jpa·app-bootstrap `check`, `documentContractTest` 66, `testQualityCheck` rc=0 |
|
||||
| RR7-05-01 | 고침(18.4절 (a)) | `6cd5e925` | RED: 기준 + 테스트만으로 `WorkflowGradleInvocationsTest` 44건 중 1건 실패(필터 workflow 셋 모두 `uncountedReason=null`). GREEN: 같은 테스트, `-p build-logic check javadoc`, 두 빌드 `verifyStrictLaneStages --dry-run`, `:ci :verifyDependencyLocks` rc=0 |
|
||||
| 태그·릴리스 trigger 판정(18.4절 넷째) | 고침(18.4절 (a)) | `a490c20f` | RED: `ac3c6a81` + 테스트만으로 68건 중 2건 실패(`WorkflowGradleInvocationsTest`, `StrictLaneStagesFunctionalTest` UnexpectedBuildSuccess). GREEN: 두 클래스 46·22건 실패 0, `-p build-logic check javadoc`(173건), 두 빌드 단계 검사, `check-work-docs.py`·상대 링크 검사 rc=0 |
|
||||
| 깨진 상대 링크 3개(`src/README.md`, fileserver·objectstorage README, 기준 커밋부터) | 고침 | `eab82df1` | `check-work-docs.py --links`를 src·docs·`README.md`·.github에 돌려 깨진 링크 0. lychee는 돌리지 못함 |
|
||||
| `AGENTS.md` 커밋 예외 문장(매뉴얼 수정 세션이 범위 밖에서 봄) | 고침 | `ac3c6a81` | 본문을 읽는 테스트가 없다(git grep) |
|
||||
|
||||
Reference in New Issue
Block a user