Commit Graph
9 Commits
Author SHA1 Message Date
DongHyeonka 6e992970ca fix!: r9 확인 리뷰가 찾은 결함 25건을 고친다
문제: r9 커밋(45d2a478)을 영역 4개로 다시 리뷰해 결함 25건을 찾았다
(Important 2, Minor 23, round6/01~04). Important 둘: r9가 @Configuration을
사용자 전송에서 통째로 빼서 설정 안의 RouterFunction·DataFetcher가
@SystemCaller를 불러도 잡히지 않는 회귀, 그리고 가이드대로 만든
CREATE INDEX CONCURRENTLY 마이그레이션이 Flyway 기본 트랜잭션 잠금과 서로
기다려 끝나지 않는 것(이전부터). 그 밖에 시작을 거절당한 같은 attempt가
기록 만료까지 503을 받는 것, gRPC 취소 판정과 raw status 설명의 로그 유출,
STOMP의 IAE ERROR 기록, 아무것도 잡지 못하던 shared-contract 패키지 규칙,
workflow 판독기의 거짓 통과 모양(-v·조건부 exit·Windows 기본 셸·요청형
trigger 등).

방법: 영역별 4묶음이 실패 테스트를 먼저 확인하고 고쳤다(재리뷰 README 17절).
- 설정과 그 중첩 클래스는 요청 처리기 타입에 의존하면 사용자 전송으로 센다.
- Flyway PostgreSQL 잠금을 세션 수준으로(transactional-lock=false), 직접
  만드는 Flyway는 FlywaySchemaPolicy 하나로. 버린 대안: CIC를 마이그레이션에서
  금지하고 운영 절차로.
- 같은 attempt로 다시 claim하면 lease가 지난 claim을 넘겨받는다. 옛 revision의
  늦은 시작이 ALREADY를 받아 이중 실행되던 것도 막았다.
- 네 전송이 IAE를 ServerFailureLog의 같은 WARN 한 줄로 남긴다.
- workflow 판독기가 세지 않는 이유를 셋으로 나누고 문서 5곳을 같은 말로.

위험·한계: Flyway 세션 잠금은 transaction-mode PgBouncer 뒤에서 깨진다
(Hikari 직접 연결 전제, 가이드에 적음). 배포 마이그레이션 도구도 같은 값을
써야 한다(업그레이드 안내). 같은 attempt를 두 호출이 동시에 쓰는 것은
저장소가 가려내지 않는다(호출자 계약으로 문서화).

검증: 묶음별 RED·GREEN은 로컬(노트북 빌드 금지 지시 전)에서, 지시 뒤에
바뀐 01 A5 fixture의 RED와 02 늦은 시작 revision 검사의 RED, 03 동시 인덱스
검사기 GREEN은 desktop에서 확인했다. 합친 트리를 desktop에서 돌려 모두 첫
실행 통과: :ci :verifyDependencyLocks --warning-mode=fail, sample check,
두 빌드 verifyStrictLaneStages --dry-run, :mainCheck, :integrationCheck,
-p optional-platforms ci integrationCheck performanceCheck, :performanceCheck,
:releaseCheck, compose 18 lane, -p build-logic check javadoc(README 17.2절).

Refs: docs/reviews/2026-11-03-rereview/README.md 17절
BREAKING CHANGE: Flyway PostgreSQL 잠금이 세션 수준이 되어 배포 도구에도
flyway.postgresql.transactional.lock=false가 필요하다. GraphQL·gRPC가 IAE를
WARN 한 줄로 남긴다. shared-contract 패키지 규칙이 실제로 검사한다.
2026-11-05 21:26:50 +09:00
DongHyeonka 45d2a478b8 fix!: 리뷰가 기록만 하고 남겨 둔 결함을 모두 고친다
문제: 확인 리뷰들이 찾은 Minor와 "남음" 항목을 고치지 않고 기록만 했다.
그중 동작에 닿는 것이 여럿이었다. verifyStrictLaneStages가 `./gradlew ci
|| true`, `| tee`, `if ./gradlew …` 같은 실패를 막지 못하는 명령을 실행으로
세는 거짓 통과, Redis 멱등 저장소가 lease가 지난 CLAIMED의 시작을 받아
주던 것(PostgreSQL은 거절), gRPC가 INTERNAL_ERROR 실패를 아무 데도 남기지
않고 STOMP가 SQL 원인까지 로그에 쓰던 것, 잠금 대기 검사기가 Flyway가
트랜잭션 밖에서 돌리는 VACUUM FULL을 몰라 통과시키던 것, 템플릿 패키지
목록과 버전 판정 정규식이 두 곳에 갈라져 있던 것.

방법: 영역별 4묶음이 실패 테스트를 먼저 확인하고 고쳤다(재리뷰 README
16절).
- workflow run 스크립트를 bash 문법으로 읽고, 실패를 막지 못하는 명령과
  셸이 실행하지 않는 줄의 cd는 이유를 대며 세지 않는다.
- 두 멱등 저장소가 lease가 지난 시작을 LEASE_EXPIRED로 거절하고,
  executor는 아무것도 실행하지 않았으므로 503으로 답한다.
- web·GraphQL·gRPC·STOMP가 shared-contract ServerFailureLog로 같은 실패
  로그 줄을 쓴다(persistence 실패는 분류만).
- @SystemCaller 규칙이 인터페이스로 주입한 경로도 보고, 조립 설정은 사용자
  전송으로 세지 않는다.
- 갈라진 복사본은 하나로: 템플릿 패키지 표가 정본이고 클래스를 대조하며,
  버전 판정 코드는 grpc 빌드가 Sync로 가져와 컴파일한다.
- httpclient 장애 주입 lane이 main 단계에서 두 번 돌던 것을 한 번으로.
- 게이트에서 드러난 httpclient drain 스레드 경쟁: close()가 스레드를 join하고,
  런타임이 닫기를 거부해도 drain 스레드를 먼저 멈춘다.

위험·한계: 목록에 넣지 않은 새 템플릿 패키지는 기능 패키지와 구별할 수
없다(문서화). 서브셸·eval·source 안의 cd 뒤 명령과 `|| exit 1`은 세지 않는다
(거짓 실패 쪽). Gradle 옵션 판독은 Gradle 9.0 동작을 TestKit으로 고정했다.

검증: 첫 ci가 httpclient ClientRuntimeRegistryTest 1건으로 실패(기존 코드의
drain 스레드 경쟁, README 16.1절) — 고친 뒤 ci 재실행 통과. 두 빌드
verifyStrictLaneStages, mainCheck, :integrationCheck, -p optional-platforms ci
integrationCheck performanceCheck, :performanceCheck, :releaseCheck, compose
18 lane 통과. httpclient check·testQualityCheck·failure injection·performance
lane을 수정 뒤 다시 돌려 통과.

Refs: docs/reviews/2026-11-03-rereview/README.md 16절
BREAKING CHANGE: 멱등 저장소 시작·renew 결과에 LEASE_EXPIRED가 생겼고,
lease가 지난 시작은 503 IDEMPOTENCY_UNAVAILABLE이다. verifyStrictLaneStages가
실패를 막지 못하는 workflow 명령을 세지 않는다.
2026-11-04 22:46:05 +09:00
DongHyeonka c508b1ba4b docs: 회복 필요 응답의 클라이언트 안내를 한 가지로 맞추고 확인 리뷰를 기록한다
문제: 70fb80bf 뒤 IDEMPOTENCY_RECOVERY_REQUIRED에 대한 클라이언트 안내가
문서마다 달랐다. http-contract 표는 새 키 금지, 매뉴얼 05 표는 옛 문구(재전송도
위험), runbook은 효과가 없으면 새 키라고 했다. 결정 ① 뒤에는 같은 키 재전송이
작업을 다시 돌리지 않으므로 안전하다.

방법: 세 문서를 "자동 재시도 안 함, 같은 키 재전송은 안전(서버가 판정하고
다시 돌리지 않음), 효과가 없다고 확인된 뒤에만 운영 절차에 따라 새 키"로
맞췄다. 70fb80bf 확인 리뷰(Important 0, Minor 9) 결과를 재리뷰 README 15.2절과
round5/review.md에 남기고, 업그레이드 안내의 결정 행에 커밋 해시를 적었다.

위험·한계: 문서만 바뀐다. 나머지 Minor 8건은 기록만 했다.

검증: :app-bootstrap:documentContractTest, :app-bootstrap:repositoryContractTest
통과.

Refs: docs/reviews/2026-11-03-rereview/README.md 15.2절
2026-11-04 20:36:39 +09:00
DongHyeonka 70fb80bf04 fix!: 늦게 끝난 멱등 실행을 기록하고 설정·workflow 검사를 보강한다
문제: 기본값으로 정했던 세 가지를 소유자가 다시 정했다.
- lease(기본 30s)가 지난 실행을 다음 같은 키 요청이 포기로 표시해서,
  첫 시도가 늦게 끝나면 결과가 버려지고 그 요청도 500을 받았다.
  executor가 lease를 갱신하지 않아 30s를 넘는 정상 요청도 해당됐다.
- failure-retention이 replay-ttl보다 짧아도 기동이 막히지 않아, 효과
  불명 실패의 중복 방지 기간이 주석 경고만 남긴 채 짧아졌다.
- verifyStrictLaneStages가 `cd src && ./gradlew`를 저장소 루트 빌드로
  읽어 파생 서비스 workflow에서 거짓 실패가 났다.

방법:
- lease가 지난 실행 기록을 claim이 만나면 기록을 바꾸지 않고 회복
  필요로만 답한다. 주인의 늦은 complete·markFailed는 기록되고 다음
  claim은 그 결과를 재생한다. 다시 실행하지 않는다는 결정은 그대로다.
  PostgreSQL·Redis·fake와 공유 계약을 함께 바꿨다. 이미 끝난 lease의
  renew는 두 저장소 모두 거절한다(Redis만 받던 것을 맞춤).
- IdempotencySettings가 failure-retention < replay-ttl이면 기동을
  실패시킨다. 기본값(둘 다 24h)은 그대로 뜬다.
- workflow 명령의 빌드를 working-directory → 같은 셸의 최상위
  `cd <상대 경로>` → -p 순서로 정한다. 읽을 수 없는 이동($VAR, 절대
  경로, 서브셸·조건문 안) 뒤의 명령은 이유를 대며 세지 않는다.

위험·한계: lease가 지난 실행의 EXECUTING 기록을 운영자가 지우면 늦은
완료가 사라지고 같은 키가 다시 실행된다(runbook에 적음). 회복 필요를 받은
뒤 같은 키로 다시 보내면 성공 응답이 올 수 있다(프론트 인계 문서 갱신).
CLAIMED에서 실행 시작으로 넘어갈 때 PostgreSQL은 lease를 보고 Redis는
보지 않는다. `./gradlew ci || true` 같은 명령을 여전히 실행으로 센다
(이전부터, 거짓 통과).

검증: ci, 두 빌드 verifyStrictLaneStages --dry-run, mainCheck,
:integrationCheck, -p optional-platforms ci integrationCheck
performanceCheck, :performanceCheck, :releaseCheck(-PgitRevision),
verify-compose-profile-contracts(18 lane) 첫 실행 통과. 결정 ①은 실
PostgreSQL·실 Redis 계약 lane에서 RED(늦은 complete 거절)를 먼저 확인했다.

Refs: docs/reviews/2026-11-03-rereview/README.md 15절
BREAKING CHANGE: lease가 지난 멱등 실행의 늦은 완료가 기록된다(전에는
포기). failure-retention < replay-ttl 설정은 기동 실패.
2026-11-04 20:17:27 +09:00
DongHyeonka b76285a5aa docs(upgrade): 업그레이드 안내에 마지막 커밋 해시를 적는다
문제: 업그레이드 안내의 커밋 목록과 B-40 행이 마지막 커밋을 해시 없이
제목으로만 가리켰고, 그 제목도 실제와 달랐다.

방법: 해시 2678955c로 바꿨다.

위험·한계: 문서만 바뀐다.

검증: 해당 없음(문서).
2026-11-04 08:11:27 +09:00
DongHyeonka 2678955c64 build(quality)!: 테스트 코드 정적 분석을 게이트에 넣고 발견을 고친다
문제: qualityCheck는 spotbugsMain만 돈다. main 밖 source set(test,
testFixtures, integrationTest, systemTest 등)의 SpotBugs 태스크 111개는
어느 게이트에도 없었고, 돌려 보니 53개가 실패했다(발견 300건). 그중
동시성 테스트 7건은 CountDownLatch.await의 시간 초과를 무시하고 다음
단계로 가서 순서를 확인하지 않은 채 통과했다. 2개는 분석 classpath에
없는 클래스 때문에 분석이 불완전했다.

방법:
- leaf마다 testQualityCheck를 두고 main 빌드는 mainCheck, optional 빌드는
  ci에 넣었다. PR 게이트에 넣지 않은 것은 테스트 코드가 배포되지 않고
  전체 실행이 ci만큼 걸려서다.
- 테스트용 제외 목록 config/spotbugs/exclude-test.xml. 패턴 전체 제외는
  이유가 모든 테스트 클래스에 성립하는 것만(보안 범주, 내부 상태 노출,
  생성자 예외, 반환값 null 역참조, 아키텍처 위반 fixture). 나머지 30건은
  클래스·메서드로 좁히고 이유를 달았다.
- 24건은 코드로 고쳤다: await 결과 단언, 공유 변수 원자성, 닫지 않은
  Statement, SQLException을 삼키던 upsert 테스트, 만료 없는 키에서 NPE가
  나던 Redis fake. 쓰는 곳이 없던 web-fileserver 테스트 helper 2개는
  지웠다.
- 모든 SpotBugs 태스크가 그 source set의 runtime classpath로 분석하고
  분석이 불완전하면 실패한다. SpotBugs 플러그인이 나중에 생긴 source
  set의 태스크를 등록하면서 classpath를 덮어써서 설정을 평가 뒤에
  등록한다. 그 자리에 의존성을 더하는 우회는 버렸다.

위험·한계: 파생 서비스는 자기 테스트 코드의 SpotBugs 발견이 mainCheck를
막는다(업그레이드 안내 B-40). mainCheck가 그만큼 길어진다(main 빌드 테스트
태스크 100개).

검증: ci, 두 빌드 verifyStrictLaneStages --dry-run, mainCheck(testQualityCheck
100개 포함, 3분 10초 → 8분 33초), :integrationCheck, -p optional-platforms
ci(testQualityCheck 포함) integrationCheck performanceCheck,
:performanceCheck, :releaseCheck(-PgitRevision), verify-compose-profile-
contracts(18 lane) 첫 실행 통과. 고친 컨테이너 테스트는 클래스별로 따로
실행해 통과.

Refs: docs/reviews/2026-11-03-rereview/README.md 14절
BREAKING CHANGE: mainCheck(optional 빌드는 ci)가 테스트 source set의
SpotBugs·FindSecBugs 발견에 실패한다. 고치거나 config/spotbugs/
exclude-test.xml에 이유를 단 좁은 Match를 더한다.
2026-11-04 08:11:15 +09:00
DongHyeonka f40c03c6d3 fix: 3차 확인 리뷰의 Minor 19건을 고친다
문제: 3차 수정의 확인 리뷰가 새 Important 없이 Minor 19건을 남겼다.
동작에 닿는 것이 셋이다. JDK read-idle watchdog이 공용 ForkJoinPool에서
돌아 그 풀이 바쁘면 300ms timeout이 6초 가까이 늦었다. 붙여 쓴
-x<task>를 verifyStrictLaneStages가 읽지 않아 lane을 뺀 workflow가
통과했다. 사용자 전송이 중간 클래스를 거쳐 @SystemCaller bean을 부르면
ArchUnit 규칙을 지났다. 잠금 대기 검사기는 FK·trigger·REINDEX와
lock_timeout = 0을 못 봤고, 쿼터 보정 SQL은 코드와 다른 모양의 행을
넣었다.

방법: 영역별 4묶음이 맡은 Minor만 test-driven-development 절차로
고쳤다(재리뷰 README 12절).
- watchdog은 전용 데몬 스레드 하나에서 돌고 스트림을 닫으면 작업을
  취소한다. read당 비용은 그대로다(21–24ns).
- 사용자 전송 → @SystemCaller는 직접·간접 의존 모두 거부한다. 리뷰가
  권한 직접 의존 검사는 중간 클래스 하나로 다시 열려서 버렸다.
- 검사기를 보강하면서 새로 걸린 이미 배포된 마이그레이션 5개는 내용을
  바꾸지 않고 동결 목록에 더했다(main과 blob이 같다).
- 비밀 목록 bean은 규칙보다 먼저 만들어 실제 클래스로 검사한다.

위험·한계: 회복 필요 예외 메시지 끝에 scope digest가 붙고 기동 실패
문구가 바뀌어, 문구 전체에 맞추던 로그 매처는 고쳐야 한다. 코드가 든
Redis 계정 참조의 fixture- 검사는 문서로만 막았다(코드로 막으려면 새
의존 edge가 필요하다). failure-retention ≥ replay-ttl 기동 검사는 넣지
않았다. -mx 같은 짧은 플래그 묶음과 graphql 전송 fixture는 남았다.
spotbugsTestFixtures(게이트 밖)의 정규식 경고가 15건으로 늘었다.

검증: ci, 두 빌드의 verifyStrictLaneStages --dry-run, mainCheck,
:integrationCheck, -p optional-platforms ci integrationCheck
performanceCheck, :performanceCheck, :releaseCheck(-PgitRevision),
verify-compose-profile-contracts(18 lane) 첫 실행 통과. watchdog은
공용 풀을 채운 상태에서 300ms 설정이 300ms에 끝나는 것을 쟀다.

Refs: docs/reviews/2026-11-03-rereview/README.md 11·12절, round3/
2026-11-04 03:00:21 +09:00
DongHyeonka 1885bf8da7 fix!: 2차 재리뷰가 찾은 결함 29건을 고친다
문제: 재리뷰 수정 커밋(bbe944bd)만 다시 본 2차 재리뷰가 Important 7건,
Minor 22건을 찾았다. 결과 불명 503 뒤 같은 키를 다시 보내면 Redis
store가 lease 지난 실행을 넘겨받아 작업을 다시 돌렸다. replay TTL이
lease보다 짧으면 lease 도중 key가 사라져 같은 키가 두 번 실행됐다.
@SystemInvoked 규칙이 매뉴얼 09장의 이벤트 소비 경로까지 막았다. V22가
outbox_event에 가장 강한 잠금을 lock_timeout 없이 걸었다. prod의
fixture- 거부가 HOSTNAME 같은 비밀 아닌 값까지 막았다. 데모 허용 목록의
test·demo 프로필로 sample이 뜨지 않았다. 기동 rule bean의 @Value 필드가
조용히 null이 됐다.

방법: 영역별 4묶음이 test-driven-development 절차로 실패 테스트를
먼저 쓰고 고쳤다. 결정은 재리뷰 README 9.1절이다.
- 두 멱등성 store가 같은 계약을 따른다. lease가 지난 실행 기록은 다시
  돌리지 않고 포기로 표시해 500 RECOVERY_REQUIRED로 답한다. 기록 수명은
  lease + replay TTL이고, replay-ttl < processing-lease면 기동이 실패한다.
- 사용자 transport만 @SystemInvoked use case에 닿지 못한다. 메시지
  handler·scheduler는 새 표시 @SystemCaller(reason)를 달고 use case를
  생성자에서 new로 만든다. 매뉴얼 경로를 테스트로 고정했다.
- 아직 어디에도 적용되지 않은 마이그레이션(V20·V22·알림 V11~V13·sample
  V8_1·grpc V002·V003)에 lock_timeout 5s를 넣고, 텍스트 검사기와 실 PG
  lane을 더했다. 이미 배포된 24개는 동결 목록으로 둔다.
- fixture- 검사는 비밀로 분류된 값만 본다. sample은 local·test·demo에서
  object storage를 끈다. 기동 rule bean에 주입 멤버가 있으면 모든
  프로필에서 기동이 실패한다. 리뷰어가 제안한 "static @Bean 선언 강제"는
  문제없는 등록을 막고 @Value 필드는 통과시켜서 버렸다.
- 이 수정 전에 move된 파일의 쿼터 차이를 찾는 쿼리와 재계산 SQL을
  docs/fileserver/operations.md에 적었다.

위험·한계: lease 뒤 늦게 끝난 첫 시도의 결과는 기록되지 않는다(그 요청도
500). @SystemCaller가 없는 메시지 handler, 주입 멤버가 있는 기동 rule,
working-directory 없이 ./gradlew를 부르는 workflow 명령은 파생 서비스에서
새로 실패하거나 세지지 않는다(업그레이드 안내 B-14~16·B-36·B-39).
spotbugsTestFixtures는 게이트 밖이고 기준 커밋에서도 실패하며, 새 검사기의
정규식 경고 8건이 더해졌다. 실제 CI runner 실행은 확인하지 못했다(Gitea
repo의 Actions가 꺼져 있다).

검증: ci, 두 빌드의 verifyStrictLaneStages --dry-run, mainCheck,
:integrationCheck, -p optional-platforms ci integrationCheck
performanceCheck, :performanceCheck, :releaseCheck(-PgitRevision),
verify-compose-profile-contracts(18 lane) 첫 실행 통과. 쿼터 재계산
SQL은 실 PostgreSQL 16에서 차이 2행 → 0행을 확인했다.

Refs: docs/reviews/2026-11-03-rereview/README.md 9·9.1·10절
BREAKING CHANGE: replay-ttl < processing-lease 설정은 기동 실패, ledger
release가 claim token을 받는다, HttpBodyReadException(IOException 하위)이
본문 실패를 싣는다, 기동 rule·비밀 목록 bean의 주입 멤버 금지,
verifyStrictLaneStages가 workflow 명령의 working-directory로 빌드를 정한다.
2026-11-04 01:47:50 +09:00
DongHyeonka ecc74b7df7 docs(review): 2차 재리뷰 결과와 파생 서비스 업그레이드 안내를 더한다
문제: 1차 재리뷰 수정(bbe944bd)도 앞 라운드처럼 새 결함을 만들었는지
아무도 다시 읽지 않았다. 이 브랜치는 파생 서비스가 깨지는 변경이
많은데 따라올 안내가 없었다.

방법: 수정 커밋만 대상으로 리뷰어 4명이 1차와 같은 템플릿·스킬 방식으로
봤다(round2/). Critical·회귀 0, Important 7(이번 라운드가 새로 만든 것
4), Minor 22. 3차 수정에 쓸 결정을 README 9.1절에 적었다. 파생 서비스용
docs/upgrade/2026-11-maturity-review.md에 깨지는 변경 38건, 마이그레이션
영향, 따라오는 순서를 diff 근거와 함께 정리했다.

위험·한계: 이 커밋은 기록만 담는다. Important 7건은 다음 수정에서
고친다. 업그레이드 안내는 tech-log-backend에 실제로 적용해 보지 않았다.

검증: 문서만. 리뷰어별 실행 명령은 각 문서 "범위" 절.

Refs: docs/reviews/2026-11-03-rereview/README.md 9절
2026-11-04 00:21:51 +09:00