From 66a7190a838feee7f9b854f3030171e144de273b Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 05:05:46 +0900 Subject: [PATCH] =?UTF-8?q?docs(build):=20mainCheck=C2=B7bootstrap=20?= =?UTF-8?q?=EC=84=A4=EB=AA=85=EC=9D=84=20=EC=A7=80=EA=B8=88=20=ED=83=9C?= =?UTF-8?q?=EC=8A=A4=ED=81=AC=EC=99=80=20=EA=B8=B0=EB=B3=B8=20=EC=A1=B0?= =?UTF-8?q?=EB=A6=BD=EC=97=90=20=EB=A7=9E=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `mainCheck`는 `:adapter:inbound:graphql:graphqlStableTest`에 기댄다 (build.gradle `mainCheck` 태스크). 그런데 루트 build.gradle Lifecycle 주석과 gates.md 1절 `mainCheck` 행에는 이 lane이 없다. docs/build.md 표는 gates.md 1절을 정본으로 가리키므로 정본이 빠진 셈이다. build.gradle의 bootstrap 주석은 단계를 「migrate-and-start」로 적는다. 기본 조립은 web뿐이고 persistence-jpa 줄이 꺼져 있어 startup Flyway가 돌지 않는다. 「start」로 고치고, Flyway는 persistence-jpa 줄을 켰을 때만 돈다고 적는다. 동작 변경 없음: build.gradle은 주석만 바꿨다. 검증: scripts/verify.sh docs(노트북) rc=0. Refs: round9 확인 리뷰(r9-be 그룹 C가 넘긴 Low 둘) --- build.gradle | 8 +++++--- docs/work/reference/gates.md | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/build.gradle b/build.gradle index e892f1de..c9cfd47e 100644 --- a/build.gradle +++ b/build.gradle @@ -57,7 +57,8 @@ tasks.register('verifyDependencyLocks') { } // feature-developer-experience-contract D3 — the ordered local bootstrap lifecycle is -// scripts/bootstrap-local.sh (compile, Docker preflight, dependency wait, migrate-and-start, smoke). +// scripts/bootstrap-local.sh (compile, Docker preflight, dependency wait, start, smoke). Startup +// Flyway runs only when the persistence-jpa runtimeOnly line is on; the default composition is web. // --------------------------------------------------------------------------------------------- // Lifecycle. @@ -70,8 +71,9 @@ tasks.register('verifyDependencyLocks') { // prCheck the pull-request stage: ci + dependency locks + the Compose render, the // repository layout and the document checks (scripts outside Gradle) // mainCheck the main-branch stage: environment contract, full-boot qualification, -// public-path baseline, transport and messaging qualification lanes, each -// leaf's document-contract lanes, and the feature generator round trip +// public-path baseline, transport and messaging qualification lanes, the +// GraphQL transport-boundary lane (graphqlStableTest), each leaf's +// document-contract lanes, and the feature generator round trip // (verifyFeatureScaffold) // integrationCheck the declared strict integration lanes (several need a container runtime) // performanceCheck the declared strict performance lanes (load, shutdown, pool and resource diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 8bc7c673..2c0b5809 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -40,7 +40,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v | `python3 scripts/check-repo-layout.py` | 저장소 루트와 `src/` 최상위에 허용 목록 밖의 항목이 없는가, registry 경로가 허용 폴더 안인가. 아무도 가리키지 않는 compose·스크립트 파일은 경고 | PR(`prCheck` 안) | `verifyRepositoryLayout` | | `python3 scripts/check-work-docs.py` | 작업 지침(루트 `AGENTS.md`·`CLAUDE.md`, `docs/work/`, `src/**/AGENTS.md`, `.claude/`)의 분량 상한, 본문 이력 ID 0, playbook 뼈대, 상대 링크 | PR(`prCheck` 안) | `verifyWorkDocs` | | `python3 scripts/check-docs.py` | 살아 있는 문서의 언어, 기록·ADR 머리 블록, 문서의 인라인 코드 경로·Gradle 경로가 지금 있는가, 복사한 숫자, 상대 링크(`docs/README.md` 「문서 검사」) | PR(`prCheck` 안) | `documentCheck` | -| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `main.yml` `main`: `./gradlew :integrationCheck :mainCheck --continue` | +| `mainCheck` | `configContractCheck` + `qualificationCheck`(`testQualityCheck` 포함) + 공개 경로 스냅숏 + 전송·메시징 qualification lane + GraphQL 전송 경계 lane(`graphqlStableTest`) + 생성 명령 왕복(`verifyFeatureScaffold`) + 모든 leaf의 `mainCheck`(document-contract lane 등) | main | `main.yml` `main`: `./gradlew :integrationCheck :mainCheck --continue` | | `integrationCheck` | 선언된 strict integration lane 전체(실 컨테이너). 입력이 없는 lane은 빼고 이름을 댄다 | main·nightly | `main.yml` `main`: `./gradlew :integrationCheck :mainCheck --continue`(두 단계를 Gradle 한 번에. 한 번 컴파일하고, 직렬 lane이 도는 동안 나머지가 겹친다. integration이 앞이라 lane이 첫 몇 분부터 슬롯을 쓴다) | | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | nightly(다른 무거운 job 뒤: 파일 맨 끝 job이고 runner 하나가 job을 만든 순서대로 돈다. `needs`는 쓰지 않는다 — Gitea 1.27이 `needs`와 `if`를 함께 가진 job을 Blocked에 둔다) | `main.yml` `performance`. 5절 | | `releaseCheck` | 릴리스 provenance + 공개 경로 스냅숏. 커밋을 `GITHUB_SHA`·`GIT_SHA`·`-PgitRevision=`로 받고, 없으면 설계대로 실패한다 | 태그 | `release.yml` `release` |