build!: 시험 classpath·이미지 고정·검사 스크립트를 정본대로 맞추고 거짓 통과 시험을 고친다 #27

Closed
donghyeon.kang wants to merge 0 commits from claude/r9-c-tests-build into main
Owner

무엇을, 왜

round9 리뷰 그룹 C의 시험·빌드·스크립트 묶음(B16 시험 품질, B17 빌드, B18a 검사 스크립트)을 고친다. 거짓 통과·흔들림이 있던 시험, 정본과 다른 빌드 설정, 늘 실패하거나 아무것도 못 잡던 스크립트를 정본대로 맞춘다.

  • 시험(B16): registry를 태그·입력 선언 없이 읽고 cwd에서 저장소 루트를 거슬러 찾던 graphql 시험 → document-contract 태그와 mainStage lane graphqlDocumentContractTest. 루트(ca.repository.root)와 입력 파일은 그 lane만 받는다. 「값을 싣지 않는다」 단언 넷에 예외 타입. admin @Valid 시험이 빈 목록이면 통과하던 것 → 매개변수 목록 고정. GraphQlRequestDeadlineTest의 sleep(500) → 실행 끝 신호(세대 번호로 이전 시험의 늦은 완료를 거름). 표 입력 반복문은 @ParameterizedTest, 두 동작을 한 시험에서 보던 곳은 둘로.
  • 빌드(B17): ca.spring-library가 30 leaf 모두의 시험 classpath에 spring-boot-starter-webmvc-test(Tomcat·Jackson 포함)를 넣었다 → 규약은 spring-boot-starter-test만 준다. 시험이 실제로 쓰는 것을 leaf가 직접 선언한다: MockMvc를 쓰는 web 넷·app-bootstrap은 starter, graphql은 spring-boot-resttestclient, durable-operation은 spring-web, 시험이 JSON을 읽는 objectstorage·persistence-jpa·persistence-mongo·notification-platform은 jackson-databind, redis-runtime은 jackson-annotations(compileOnly). 모든 Java source set을 한 빌드에서 컴파일해 빠진 곳이 없음을 확인했다. postgres 17·18을 digest로 고정하고 digest 없는 값을 읽을 때 거절(ContainerImageCatalogTest). 카탈로그·spotbugs의 죽은 칸, notification API surface의 상대 경로 root와 없는 root를 말없이 건너뛰던 플러그인, 늘 실패하던 verify-mongodb-platform.sh.
  • 스크립트(B18a): README 이름 바꾸기 명령이 group·spotbugs·snapshot을 놓쳐 따라 하면 qualityCheck가 실패했다 → 범위를 넓힘. check-repo-layout.py의 없는 기록 폴더 셋, 검사 스크립트 머리말의 「부르는 곳」, docstring 숫자, 자기 시험 셋(scripts/tests 자기 시험). compose smoke가 lane마다 정적 계약을 다시 돌리던 것(→ 실행마다 한 번), handoff 재생성이 1단계 재시작 수를 지우고 빈 결과면 통과하던 것(→ 단계별 기록, 0건이면 실패).

고른 방법과 버린 대안

  • 이미지마다 쓰는 lane을 선언해 Test 입력을 나누는 안은 버렸다. lane 수십 개에 키 목록을 다시 적어야 하고, 빠뜨리면 캐시가 거짓 통과한다. 머리말을 「파일 전체가 모든 Test task 입력」이라는 실제 동작으로 고쳤다.
  • webmvc-test를 규약에 두고 쓰지 않는 leaf가 빼는 안은 버렸다. 새 leaf가 기본으로 Tomcat을 끌고 온다.
  • 시험 형식(GWT·한국어 @DisplayName) 일괄 전환은 하지 않는다(리뷰 README 6절 ④, 「손댈 때 고친다」). decisions 2.1에 행으로 남겼다.

위험과 영향(파생 서비스가 따라 할 일)

docs/upgrade/2026-11-round9-build.md 1~6행. 요점: 자기 leaf 시험이 쓰는 web 시험 도구·Jackson을 직접 선언(안 하면 시험 컴파일 실패, 운영 코드 영향 없음), 카탈로그 이미지는 digest만, version catalog에서 지운 칸, API surface 추가 root가 없으면 실패. 커밋 ! 하나(B17).

검증

desktop, --no-build-cache.

  • RED: 기준 + build-logic 새 시험만 → 기준의 containerImages가 private이라 시험 컴파일 실패(c2-red). 기준 코드는 digest 없는 값을 거절하는 분기가 없어, 컴파일이 되더라도 거절 시험이 실패한다. scripts/tests는 옛 HISTORY_PREFIXES면 실패.
  • resolveAndLockAll + build-logic test + spotlessCheck rc=0(c2-locks, build-logic 146건).
  • 모든 Java source set을 한 빌드에서 컴파일(init script로 모든 JavaCompile, --continue) + 고친 leaf 열의 시험 1712건 실패 0(c2-fix2). 이 전수 컴파일이 리뷰가 본 셋 밖의 회귀 둘(notification-platform, redis-runtime)을 더 찾았다.
  • desktop scripts/verify.sh pr --no-cache: 최종 head 7635105a(트리 0af37b60) 6734건 실패 0, 건너뜀 28, rc=0, FROM-CACHE 0.
  • 노트북: check-docs.py·check-work-docs.py·check-repo-layout.py rc=0, python3 -m unittest discover -s scripts/tests 통과.
  • 새 눈 리뷰: reviewer(be-build-ci + be-testing) High 2·Low 4·넘김 2, arch-reviewer(HARD-STOP 0) Low 2 → 모두 고침. 리뷰 수정은 원래 커밋 셋에 합쳤다(브랜치를 처음 push하기 전이라 다시 쓴 이력이 없다).

발견 ID 표

ID 판정 커밋
RR9-03-17 고침 1185b36a, cbfa7762
RR9-03-18 고침 1185b36a
RR9-03-19 고침 1185b36a
RR9-03-20 고침(graphql 부분. fileserver 포화 시험은 #25) 1185b36a
RR9-03-22 해당 없음(결정 ④: 일괄 전환 안 함, decisions 2.1 행) 1185b36a
RR9-04-06 고침 cbfa7762
RR9-04-11 고침 cbfa7762
RR9-04-12 고침 cbfa7762
RR9-04-13 고침 cbfa7762
RR9-04-14 고침(머리말을 실제 캐시 동작으로, 입력 분리는 버림) cbfa7762
RR9-04-15 고침 cbfa7762
RR9-04-16 고침 cbfa7762
RR9-04-43 고침(고치며 찾음: release registry의 읽지 않는 tag) cbfa7762
RR9-04-04 고침 d904d680
RR9-04-17 고침(verify-compose-profile-contracts.sh 머리말은 #24) d904d680
RR9-04-18 고침 d904d680
RR9-04-26 고침 d904d680
RR9-04-27 고침(inspect 실패도 실패로) d904d680

관련

  • 리뷰 기록: PR #17 docs/reviews/2026-11-12-round9-review/.
  • 같은 그룹의 #25(계약·오류 코드), PR 3(문서).

새 눈 리뷰가 이 PR에서 찾은 것(위 표 밖)도 모두 고쳤다: 시험 classpath 회귀(High 2, 컴파일 전수로 둘 더 찾음), smoke inspect 실패 통과, PR 단계에서 돌던 release 문서 검사, graphql·websocket 주석, 고친 시험의 GWT, persistence-jpa release registry의 읽지 않는 이미지 tag, leaf AGENTS 허용·시험 목록.

## 무엇을, 왜 round9 리뷰 그룹 C의 시험·빌드·스크립트 묶음(B16 시험 품질, B17 빌드, B18a 검사 스크립트)을 고친다. 거짓 통과·흔들림이 있던 시험, 정본과 다른 빌드 설정, 늘 실패하거나 아무것도 못 잡던 스크립트를 정본대로 맞춘다. - **시험(B16)**: registry를 태그·입력 선언 없이 읽고 cwd에서 저장소 루트를 거슬러 찾던 graphql 시험 → `document-contract` 태그와 mainStage lane `graphqlDocumentContractTest`. 루트(`ca.repository.root`)와 입력 파일은 그 lane만 받는다. 「값을 싣지 않는다」 단언 넷에 예외 타입. admin `@Valid` 시험이 빈 목록이면 통과하던 것 → 매개변수 목록 고정. `GraphQlRequestDeadlineTest`의 `sleep(500)` → 실행 끝 신호(세대 번호로 이전 시험의 늦은 완료를 거름). 표 입력 반복문은 `@ParameterizedTest`, 두 동작을 한 시험에서 보던 곳은 둘로. - **빌드(B17)**: `ca.spring-library`가 30 leaf 모두의 시험 classpath에 `spring-boot-starter-webmvc-test`(Tomcat·Jackson 포함)를 넣었다 → 규약은 `spring-boot-starter-test`만 준다. 시험이 실제로 쓰는 것을 leaf가 직접 선언한다: MockMvc를 쓰는 web 넷·app-bootstrap은 starter, graphql은 `spring-boot-resttestclient`, durable-operation은 `spring-web`, 시험이 JSON을 읽는 objectstorage·persistence-jpa·persistence-mongo·notification-platform은 `jackson-databind`, redis-runtime은 `jackson-annotations`(compileOnly). 모든 Java source set을 한 빌드에서 컴파일해 빠진 곳이 없음을 확인했다. postgres 17·18을 digest로 고정하고 digest 없는 값을 읽을 때 거절(`ContainerImageCatalogTest`). 카탈로그·spotbugs의 죽은 칸, notification API surface의 상대 경로 root와 없는 root를 말없이 건너뛰던 플러그인, 늘 실패하던 `verify-mongodb-platform.sh`. - **스크립트(B18a)**: README 이름 바꾸기 명령이 group·spotbugs·snapshot을 놓쳐 따라 하면 `qualityCheck`가 실패했다 → 범위를 넓힘. `check-repo-layout.py`의 없는 기록 폴더 셋, 검사 스크립트 머리말의 「부르는 곳」, docstring 숫자, 자기 시험 셋(`scripts/tests` 자기 시험). compose smoke가 lane마다 정적 계약을 다시 돌리던 것(→ 실행마다 한 번), handoff 재생성이 1단계 재시작 수를 지우고 빈 결과면 통과하던 것(→ 단계별 기록, 0건이면 실패). ## 고른 방법과 버린 대안 - 이미지마다 쓰는 lane을 선언해 Test 입력을 나누는 안은 버렸다. lane 수십 개에 키 목록을 다시 적어야 하고, 빠뜨리면 캐시가 거짓 통과한다. 머리말을 「파일 전체가 모든 Test task 입력」이라는 실제 동작으로 고쳤다. - webmvc-test를 규약에 두고 쓰지 않는 leaf가 빼는 안은 버렸다. 새 leaf가 기본으로 Tomcat을 끌고 온다. - 시험 형식(GWT·한국어 `@DisplayName`) 일괄 전환은 하지 않는다(리뷰 README 6절 ④, 「손댈 때 고친다」). decisions 2.1에 행으로 남겼다. ## 위험과 영향(파생 서비스가 따라 할 일) `docs/upgrade/2026-11-round9-build.md` 1~6행. 요점: 자기 leaf 시험이 쓰는 web 시험 도구·Jackson을 직접 선언(안 하면 시험 컴파일 실패, 운영 코드 영향 없음), 카탈로그 이미지는 digest만, version catalog에서 지운 칸, API surface 추가 root가 없으면 실패. 커밋 `!` 하나(B17). ## 검증 desktop, `--no-build-cache`. - RED: 기준 + build-logic 새 시험만 → 기준의 `containerImages`가 private이라 시험 컴파일 실패(`c2-red`). 기준 코드는 digest 없는 값을 거절하는 분기가 없어, 컴파일이 되더라도 거절 시험이 실패한다. `scripts/tests`는 옛 `HISTORY_PREFIXES`면 실패. - `resolveAndLockAll` + build-logic `test` + `spotlessCheck` rc=0(`c2-locks`, build-logic 146건). - 모든 Java source set을 한 빌드에서 컴파일(init script로 모든 `JavaCompile`, `--continue`) + 고친 leaf 열의 시험 1712건 실패 0(`c2-fix2`). 이 전수 컴파일이 리뷰가 본 셋 밖의 회귀 둘(notification-platform, redis-runtime)을 더 찾았다. - desktop `scripts/verify.sh pr --no-cache`: 최종 head `7635105a`(트리 `0af37b60`) 6734건 실패 0, 건너뜀 28, rc=0, `FROM-CACHE` 0. - 노트북: `check-docs.py`·`check-work-docs.py`·`check-repo-layout.py` rc=0, `python3 -m unittest discover -s scripts/tests` 통과. - 새 눈 리뷰: reviewer(be-build-ci + be-testing) High 2·Low 4·넘김 2, arch-reviewer(HARD-STOP 0) Low 2 → 모두 고침. 리뷰 수정은 원래 커밋 셋에 합쳤다(브랜치를 처음 push하기 전이라 다시 쓴 이력이 없다). ## 발견 ID 표 | ID | 판정 | 커밋 | | --- | --- | --- | | RR9-03-17 | 고침 | 1185b36a, cbfa7762 | | RR9-03-18 | 고침 | 1185b36a | | RR9-03-19 | 고침 | 1185b36a | | RR9-03-20 | 고침(graphql 부분. fileserver 포화 시험은 #25) | 1185b36a | | RR9-03-22 | 해당 없음(결정 ④: 일괄 전환 안 함, decisions 2.1 행) | 1185b36a | | RR9-04-06 | 고침 | cbfa7762 | | RR9-04-11 | 고침 | cbfa7762 | | RR9-04-12 | 고침 | cbfa7762 | | RR9-04-13 | 고침 | cbfa7762 | | RR9-04-14 | 고침(머리말을 실제 캐시 동작으로, 입력 분리는 버림) | cbfa7762 | | RR9-04-15 | 고침 | cbfa7762 | | RR9-04-16 | 고침 | cbfa7762 | | RR9-04-43 | 고침(고치며 찾음: release registry의 읽지 않는 tag) | cbfa7762 | | RR9-04-04 | 고침 | d904d680 | | RR9-04-17 | 고침(`verify-compose-profile-contracts.sh` 머리말은 #24) | d904d680 | | RR9-04-18 | 고침 | d904d680 | | RR9-04-26 | 고침 | d904d680 | | RR9-04-27 | 고침(inspect 실패도 실패로) | d904d680 | ## 관련 - 리뷰 기록: PR #17 `docs/reviews/2026-11-12-round9-review/`. - 같은 그룹의 #25(계약·오류 코드), PR 3(문서). 새 눈 리뷰가 이 PR에서 찾은 것(위 표 밖)도 모두 고쳤다: 시험 classpath 회귀(High 2, 컴파일 전수로 둘 더 찾음), smoke inspect 실패 통과, PR 단계에서 돌던 release 문서 검사, graphql·websocket 주석, 고친 시험의 GWT, persistence-jpa release registry의 읽지 않는 이미지 tag, leaf AGENTS 허용·시험 목록.
donghyeon.kang added 4 commits 2026-11-12 21:50:56 +00:00
문제:
- GraphQlDeploymentModeRegistryParityTest가 태그 없이 test에서
  docs/registries/env-keys.yaml을 읽었다. 입력을 선언하지 않아 test 캐시가
  registry 변경을 놓쳤고, modules.json을 거슬러 올라가 저장소 루트 가드를
  우회했다(build-logic/AGENTS.md 「저장소 파일을 읽는 테스트」).
- 「값을 싣지 않는다」 단언 넷(WebSecurityContextBridgeTest, scalar 둘)이 예외
  타입을 보지 않아, 메시지 null인 NPE로 바꿔도 통과했다.
- FileserverAdminControllerRequestBodyValidationTest는 @RequestBody가 하나도 없는
  controller에도 통과했다.
- GraphQlRequestDeadlineTest가 sleep(500) 뒤에 하위 필드 부재를 단언했다. 부하에
  따라 기다림이 짧으면 거짓 통과다.
- 두 동작을 한 시험에서 보던 셋(표 입력 반복문, when 둘).

고친 것:
- registry 대조 시험에 document-contract 태그를 달고 graphql leaf에
  mainStage lane graphqlDocumentContractTest를 둔다(lane은 다음 커밋의
  build.gradle에 있다. 그 파일의 다른 변경과 같이 간다).
- 부재 단언에 예외 타입(CoercingParseValueException,
  UntrustedTenantInputException)을 먼저 둔다.
- admin 시험은 @RequestBody 매개변수 목록을 고정한 뒤 @Valid를 본다.
- deadline 시험은 slowNode 실행이 끝났다는 신호(Instrumentation
  beginExecution 완료, 세대 번호로 이전 시험의 늦은 완료를 거른다)를 기다린 뒤
  부재를 본다.
- 표 입력(scalar 넷의 부재 단언 포함)은 @ParameterizedTest로, 두 동작은 시험 둘로
  나눴다. 고친 시험은 GWT와 catchThrowable로 when을 하나로 둔다.
- decisions 2.1에 「시험 형식 일괄 전환 안 함」(리뷰 README 6절 ④) 행을 더했다.

Refs: RR9-03-17, RR9-03-18, RR9-03-19, RR9-03-20, RR9-03-22
문제:
- ca.spring-library가 모든 spring leaf(30)의 testImplementation에
  spring-boot-starter-webmvc-test를 넣어, MockMvc를 쓰지 않는 23 leaf가 Tomcat을
  시험 classpath에 resolve하고 lock했다.
- container-images.properties 머리말은 「digest로 고정」이라는데 postgres-17·18이
  tag만이었다. 머리말은 「쓰는 lane만 다시 돈다」고 했지만 파일 전체가 모든 Test
  task의 입력이라 이미지 하나만 바꿔도 모든 lane이 다시 돈다. postgres-16-4는
  아무도 읽지 않았다.
- libs.versions.toml에 아무도 읽지 않는 칸이 있었다(라이브러리 9, 버전 4,
  루트에 적용하지 않는 플러그인 4).
- config/spotbugs/exclude.xml에 없는 클래스의 항목이 있었다(exclude-test.xml에
  이미 있다).
- notification의 API surface가 상대 경로로 application-notification 소스를
  가리켰고, ApiSurface 플러그인은 없는 추가 root를 말없이 건너뛰어 승인 update가
  줄어든 표면을 기록할 수 있었다.
- verify-mongodb-platform.sh가 고르는 클래스가 없는 :app-bootstrap:test
  --tests '*CleanArchitectureTest'를 불러 늘 실패했고, 이미지 기록이 카탈로그와
  다른 tag였다.

고친 것:
- 규약은 spring-boot-starter-test만 준다. 시험이 실제로 쓰는 것을 leaf가 직접
  선언한다. MockMvc를 쓰는 web·web-advanced·web-fileserver·web-notification·
  app-bootstrap은 webmvc-test starter, graphql은 TestRestTemplate의
  spring-boot-resttestclient, durable-operation은 WebApplicationContextRunner의
  spring-web, 시험이 JSON을 읽는 objectstorage·persistence-jpa·persistence-mongo·
  notification-platform은 jackson-databind, redis-runtime은 jackson-annotations
  (compileOnly, 본 코드와 같은 이유)다. 모든 Java source set을 한 빌드에서 컴파일해
  빠진 곳이 없음을 확인하고 lockfile을 다시 만들었다(Tomcat·webmvc 시험 자동설정이
  빠짐). graphql·persistence-mongo AGENTS의 허용·시험 목록을 같이 고쳤다.
- postgres 17·18을 desktop runner에서 받은 digest로 고정했다(17.11, 18.6). 목록을
  읽을 때 digest 없는 값을 GradleException으로 거절한다(ContainerImageCatalogTest).
  머리말을 실제 캐시 동작으로 고쳤고 postgres-16-4를 지웠다. persistence-jpa
  release registry의 PostgreSQL tag는 아무도 읽지 않아 지우고, 이미지는 카탈로그가
  정한다고 적었다.
- 카탈로그의 미사용 칸을 지우고 머리말을 지금 쓰임에 맞췄다.
- 죽은 spotbugs 항목을 지웠다.
- notification은 project(':application-notification')로 root를 잡고, 없는 추가
  root는 설정 단계에서 실패한다(ApiSurfaceConventionTest).
- mongo 스크립트는 :app-bootstrap:architectureTest를 부르고, 이미지 기록은
  카탈로그 mongo-8 값을 읽는다.
- graphql build.gradle에 앞 커밋의 document-contract lane을 함께 둔다. 저장소 루트
  (ca.repository.root)와 읽는 registry 파일은 그 lane만 받고, 시험은 그 속성으로만
  루트를 읽는다(cwd에서 거슬러 찾지 않는다).
버린 대안: 이미지마다 쓰는 lane을 선언해 입력을 나누기 — lane 수십 개에 키
목록을 다시 적어야 하고 빠뜨리면 캐시가 거짓 통과한다.

검증: 아래 PR 본문(desktop resolveAndLockAll·build-logic test·모든 source set 컴파일·
leaf check).

BREAKING CHANGE: ca.spring-library가 시험 classpath에 spring-boot-starter-webmvc-test를
넣지 않는다. MockMvc·TestRestTemplate·Jackson을 그 starter로 받던 파생 leaf는 의존을
직접 선언해야 시험이 컴파일된다. 카탈로그의 digest 없는 이미지와 없는 API surface 추가
root는 설정 단계에서 실패한다. version catalog의 미사용 칸을 지웠다. 할 일은
docs/upgrade/2026-11-round9-build.md다.

Refs: RR9-04-06, RR9-04-11, RR9-04-12, RR9-04-13, RR9-04-14, RR9-04-15, RR9-04-16
문제:
- README 「새 서비스로 시작하기」의 이름 바꾸기 명령(`git grep -l ... -- src
  scripts`)이 루트 build.gradle·build-logic의 group, config/spotbugs 목록, registry·
  API surface 스냅숏을 놓쳐, 따라 하면 qualityCheck와 surface 검사가 실패했다.
- check-repo-layout.py의 HISTORY_PREFIXES가 없는 폴더 셋(superpowers, evidence,
  study)을 담고 docs/history·docs/design을 빠뜨렸다. 검사 스크립트 머리말에 누가
  부르는지 없었고, check-repo-layout·check-review-index·verify-httpclient-docs에
  자기 시험이 없었다. check-docs.py docstring은 「검사 여섯」(여덟),
  check-work-docs.py는 lychee를 PR workflow라 했다(main).
- run-compose-runtime-smoke.sh가 lane마다 정적 계약 전체를 다시 돌려 nightly마다
  compose config를 수백 번 렌더링했다. handoff lane의 --force-recreate가 1단계
  재시작 수를 지웠고, ps가 빈 결과면 restarts.txt가 비어 재시작 검사가 통과했다.

고친 것:
- 이름 바꾸기 명령을 그 범위로 넓히고 build-logic 자기 패키지는 그대로 둬도
  된다고 적었다.
- HISTORY_PREFIXES를 지금 기록 폴더 넷으로, 머리말에 부르는 곳, docstring 숫자·
  workflow를 고쳤다. 자기 시험 셋을 더했다(scripts/tests 통과, 옛 목록이면
  HISTORY_PREFIXES 시험이 실패한다).
- smoke는 정적 계약을 실행마다 한 번(두 모드 공통) 돌린다. 재시작 수는
  record_restarts가 단계(phase1, final)를 붙여 쌓고, 살핀 컨테이너가 없거나
  inspect·기록이 실패하면 실패한다(호출이 `|| return 1`이라 함수 안 set -e가
  꺼진다).
- verify-httpclient-docs 자기 시험은 실제 트리 대조(release workflow의 검사)를 하지
  않고 누락 탐지만 본다. scripts/tests는 PR 단계에서 돈다.

Refs: RR9-04-04, RR9-04-17, RR9-04-18, RR9-04-26, RR9-04-27
Author
Owner

#28로 병합됐다(main 3d31896a). 이 PR의 head 7635105a가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runner pr / done이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).

#28로 병합됐다(main `3d31896a`). 이 PR의 head `7635105a`가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runner `pr / done`이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:28:34 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#27