# Conflicts: # src/adapter/inbound/graphql/AGENTS.md
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
# 업그레이드 안내 — 2026-11 시험 classpath·이미지 카탈로그·빌드 정리
|
||||
|
||||
- 범위: `ca.spring-library` 규약의 시험 의존, 컨테이너 이미지 카탈로그, version catalog, API surface 플러그인,
|
||||
graphql의 registry 대조 시험 위치. 운영 코드와 HTTP 응답은 그대로다. 빌드와 시험만 바뀐다.
|
||||
- 근거: 2026-11-12 전체 리뷰(`docs/reviews/2026-11-12-round9-review/`)의 빌드·시험 발견
|
||||
|
||||
## 1. 누가 읽나
|
||||
|
||||
이 템플릿을 `upstream` remote로 두고 merge해 받는 파생 서비스가 읽는다. 자기 leaf를 더한 서비스가 특히 본다.
|
||||
|
||||
## 2. 할 일
|
||||
|
||||
| # | 할 일 | 안 하면 | 해당 서비스 |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | 자기 leaf 시험이 쓰는 web 시험 도구를 그 leaf `build.gradle`에 직접 선언한다. MockMvc(`@WebMvcTest`, `@AutoConfigureMockMvc`)는 `testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'`, `TestRestTemplate`만이면 `spring-boot-resttestclient`, `WebApplicationContextRunner`는 `spring-web`, 시험이 `tools.jackson.databind`로 JSON을 읽으면 `tools.jackson.core:jackson-databind`다. 그다음 `./gradlew resolveAndLockAll --write-locks`로 lockfile을 다시 만든다 | 시험 컴파일이 실패한다(`cannot find symbol`, `class file for ... not found`). 운영 코드는 영향이 없다 | `ca.spring-library`를 쓰는 자기 leaf가 있는 서비스 |
|
||||
| 2 | `gradle/container-images.properties`에 더한 이미지를 `이름@sha256:<digest>`로 고정한다 | 설정 단계에서 `GradleException`으로 빌드가 멈춘다 | 카탈로그에 이미지를 더한 서비스 |
|
||||
| 3 | 시험이 `ca.test.image.postgres-16-4`를 읽었다면 `ca.test.image.postgres-16`으로 바꾼다. 그 칸은 지웠다 | 속성이 비어 Testcontainers가 이미지를 못 찾는다 | 그 칸을 쓰던 서비스 |
|
||||
| 4 | version catalog에서 지운 칸을 쓰던 빌드 스크립트는 자기 칸을 둔다. 지운 라이브러리 칸: `errorprone-core`, `findsecbugs-plugin`, `jackson3-core`, `jmh-core`, `jmh-generator-annprocess`, `junit-platform-launcher`, `protobuf-java-legacy`, `spock-core-groovy4`, `spock-core-groovy5`. 지운 플러그인 칸: `spring-dependency-management`, `spotless`, `spotbugs`, `errorprone`(규약 플러그인이 쓰는 버전은 그대로다) | 빌드 스크립트 컴파일이 실패한다 | 그 alias를 쓰던 서비스 |
|
||||
| 5 | `apiSurface`의 추가 source root가 실제로 있는 폴더를 가리키는지 본다. 상대 경로 대신 `project(':x').file('src/main/java').path`를 쓴다 | 설정 단계에서 실패한다. 전에는 말없이 건너뛰어 줄어든 표면을 승인할 수 있었다 | API surface에 추가 root를 둔 leaf |
|
||||
| 6 | graphql의 `GraphQlDeploymentModeRegistryParityTest`는 `test`가 아니라 main 단계 lane `:adapter:inbound:graphql:graphqlDocumentContractTest`에서 돈다. 손으로 돌릴 때 그 lane을 부른다 | `test`만 돌리면 registry 대조를 보지 않는다 | graphql을 실은 서비스 |
|
||||
|
||||
## 3. 확인
|
||||
|
||||
- `./gradlew resolveAndLockAll --write-locks` 뒤 `git diff --stat -- '*gradle.lockfile'`로 시험 classpath에서 빠진 항목을 본다.
|
||||
- `./gradlew <자기 leaf>:check`가 시험 컴파일부터 통과하는지 본다.
|
||||
@@ -58,6 +58,7 @@
|
||||
| 개선 매뉴얼을 먼저(지난 것) | 다음 개선 작업 전에 repo마다 개선 매뉴얼을 만든다 → 2026-11-06 「매뉴얼 체계」로 바뀜 | 소유자 | 2026-11-05 | 2026-11-05 총괄 세션 brief |
|
||||
| 스킬 | 리뷰·수정에 알맞은 스킬을 쓴다 | 소유자 | 2026-11-05 | `1103` 2절 |
|
||||
| `@DisplayName` 언어 | 한국어(기본값 영어를 거부) | 소유자 | 2026-09-25 | 결정 5, `.claude/rules/java-tests.md` 규칙 2 |
|
||||
| 시험 형식 일괄 전환 | 영어 `@DisplayName`과 `// when` 없는 시험을 한꺼번에 바꾸지 않는다. 규칙(`.claude/rules/java-tests.md`)은 그대로이고, 고치는 시험에 적용한다. 한꺼번에 바꾸면 수천 줄의 diff가 결함 수정을 가린다 | 기본값(소유자가 뒤집을 수 있다) | 2026-11-12 | 2026-11-12 전체 리뷰 기록 README 6절 ④ |
|
||||
| 학습 문서(지난 것) | 삭제된 코드를 설명하는 학습 문서(지금 `docs/history/study/*.ko.md`, `docs/history/packages/*-superpowers-package/`)는 현재 코드에 맞게 갱신 → 2026-11-07 갱신하지 않고 기록으로 보관(머리 블록만 단다)으로 바뀜 | 소유자 | 2026-09-25 | 결정 6, design-docs `repo-structure/README.md` 3.2절 |
|
||||
| 문서 체계 | 문서를 수명으로 나눈다. 살아 있는 문서는 제자리에 두고 한국어로 옮긴다. 기록은 `docs/history/`, 설계서는 `docs/design/`, 결정 기록은 `docs/adr/`에 둔다. 폴더 이름은 짝 프론트와 같이 쓴다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절, 적용은 `docs/README.md` |
|
||||
| 한국어의 범위 | 살아 있는 문서는 본문까지 한국어로 쓴다. 기록 문서는 맨 위에 한국어 머리 블록(상태·작성일·요약·현재 정본)을 달고 본문은 원문 그대로 둔다. 상태는 한국어 고정 어휘다 | 소유자 | 2026-11-07 | design-docs `repo-structure/README.md` 3.2절 |
|
||||
|
||||
Reference in New Issue
Block a user