docs(build): mainCheck·bootstrap 설명을 지금 태스크와 기본 조립에 맞춘다
`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 둘)
This commit is contained in:
+5
-3
@@ -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
|
||||
|
||||
@@ -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=<sha>`로 받고, 없으면 설계대로 실패한다 | 태그 | `release.yml` `release` |
|
||||
|
||||
Reference in New Issue
Block a user