docs: 단계표·capability 상태·설정 설명을 지금 빌드와 workflow에 맞춘다

문제: 살아 있는 문서가 지운 workflow·태스크·job과 옛 동작을 가리켰다.
- 단계 구성이 네 곳에 따로 적혔고 둘이 틀렸다. TESTING_STRATEGY의 repository
  목록은 releaseCheck를 「ci + ...」라 했고, docs/build.md의 mainCheck·
  qualificationCheck 행은 testQualityCheck·verifyFeatureScaffold·graphqlStableTest를
  빠뜨렸다.
- capability-status가 지운 redis-sdk-topology.yml·notification-platform.yml·
  verifyNotificationEvidence, app-bootstrap의 OutboxConfig(지금
  :composition:outbox-relay), 없는 lane 이름을 증거로 들었다. 제거된 코드 표의
  재배치 전 경로는 설명 없이 지금 트리에 없었다.
- docs/build.md·bootstrap-local.sh가 기본 조립이 Flyway를 돈다고 했다(기본은
  web뿐). 알림 키 개수를 복사해 틀렸다.
- roadmap messaging-r2가 지운 VerifyMessagingEvidenceTask·
  MessagingQualificationPlugin을 예시로 들었다.
- cache-redis README·build.gradle, httpclient build.gradle이 #13이 합친
  integration job을 가리켰다.
- renovate.json·취약점 정책이 「두 봇」과 GitHub vulnerability alert를 전제했다.
  이 Gitea repo에 Renovate 실행기는 없다.
- graphql AGENTS·README가 「모듈별 yml 금지·없음」이라 했지만 leaf는
  config/graphql.yml을 직접 읽는다. 지운 execution profile을 적었다.

고친 것: 단계 구성은 gates.md 1절과 루트 build.gradle을 정본으로 가리키고, 남긴
표 행은 지금 태스크대로 고쳤다. capability-status 행 넷을 지금 job·태스크·모듈로
고치고, 제거된 코드 표의 경로가 지운 때의 배치라는 머리말과 지운
ComposeMergeCharacterizationTest 행을 더했다. 기본 조립·Flyway 설명, 알림 키(개수
대신 registry), roadmap(`> 이력`), 세 integration 설명(`main` job이
:integrationCheck :mainCheck를 함께 돈다), renovate·정책(실행기 없음, enforced는
trivy), graphql 설정 파일 설명을 고쳤다.

검증: check-docs.py·check-work-docs.py rc=0, 이 문서들을 읽는 시험은
CapabilityStatusDocumentTest(app-bootstrap document-contract)다.

Refs: RR9-04-09, RR9-04-10, RR9-04-20, RR9-04-21, RR9-04-22, RR9-04-25, RR9-04-28, RR9-03-30
This commit is contained in:
DongHyeonka
2026-11-13 05:03:52 +09:00
parent fe0f8141ec
commit bae2965f06
12 changed files with 59 additions and 50 deletions
+3 -1
View File
@@ -113,7 +113,9 @@ required-class 검사가 이 테스트가 조용히 사라지는 것을 막는
모듈을 자동 커버 — per-module 규칙 추가 불필요).
- 프로덕션 feature 쿼리/뮤테이션을 스켈레톤에 두는 것 — health 표면만 (web 의
`HealthcheckController` 와 동일 원칙). feature 스키마/컨트롤러/매퍼는 그 기능을 가진 서비스가 소유한다.
- 모듈별 `yml` — 설정은 프레임워크 `spring.graphql.*` 로 composition-root `application.yml` 에 산다.
- `config/graphql.yml` 밖의 설정 파일 — 이 leaf의 설정 기본값은 그 파일 하나다. 의존성에 support가 없어 공용
`ModuleDefaultsEnvironmentPostProcessor` 대신 `GraphQlActivationEnvironmentPostProcessor`가 읽는다(manual 10 기준 7 뒤 예외).
전송 설정 `spring.graphql.*`은 composition-root `application.yml`에 둔다.
## 오류 대응 (`Category → ErrorType`)
+5 -4
View File
@@ -123,7 +123,8 @@ gRPC 와 달리 spring-graphql / graphql-java 는 Spring Boot BOM 이 관리한
## 설정 — 프레임워크 `spring.graphql.*` + 플랫폼 `app.graphql.*`
전송 계층 설정(path, graphiql, introspection, schema location)은 프레임워크 `spring.graphql.*`
가 소유한다. composition-root `application.yml` 에서 설정하며 모듈별 `yml` 은 없다.
가 소유한다. composition-root `application.yml` 에서 설정한다. 이 leaf의 `app.graphql.*` 기본값과 env 연결은
모듈의 `config/graphql.yml` 하나에 있고, `GraphQlActivationEnvironmentPostProcessor`가 가장 낮은 우선순위로 읽는다.
플랫폼 정책은 `spring.graphql.*` 로 표현할 수 없다 — cost/page 한계, preparsed
캐시 경계, 관측 label 로 허용할 operation 이름은 전부 이 leaf 의 결정이다. 그래서
@@ -148,9 +149,9 @@ app:
observed-operation-names: [] # 비우면 모든 operation 이름이 `other` 로 접힌다
```
이 모듈의 `config/graphql.yml`이 위 wired 설정을 `APP_GRAPHQL_*`로 노출한다. `APP_GRAPHQL_ENABLED`와
`APP_GRAPHQL_DEPLOYMENT_MODE` 외에도 execution profile, console, page/complexity, preparsed-cache
한계와 관측 operation allowlist가 같은 property tree로 들어간다.
이 모듈의 `config/graphql.yml`이 위 설정을 `APP_GRAPHQL_*`로 노출한다. `APP_GRAPHQL_ENABLED`와
`APP_GRAPHQL_DEPLOYMENT_MODE` 외에도 console(`APP_GRAPHQL_GRAPHIQL_ENABLED`, `APP_GRAPHQL_INTROSPECTION_ENABLED`),
page/complexity, preparsed-cache 한계, N+1 경고 임계와 관측 operation allowlist가 같은 property tree로 들어간다.
production mode는 env만으로 완성되지 않는다. 애플리케이션 좌표를 스켈레톤이 알 수 없으므로
**명시적인 `GraphQlAuthorizationPolicy` bean이 반드시 필요**하며, 이것은 의도된 fail-closed
+2 -3
View File
@@ -329,9 +329,8 @@ rate-limit 어댑터가 있다고 SDK 명령 정책이 강제된다고 짐작하
`redisContainerContractTest`는 cache-region, lease, 멱등성 store 포트 계약(메모리 fake가 통과하는 것. 멱등성 계약의
시간 있는 경우는 여기서 서버 자신의 시계로 돌고, `test`에서는 명령 fake의 시계로 돈다 — 후자는 program 자체가 아니라
fixture가 가진 program 사본을 증명한다)과 살아 있는 semantic 포트 시험을, standalone topology의 ACL 파일 아래에서 스스로
띄운 Redis에 대고 돌린다. `integrationCheck`(`main.yml`의 `integration` job)에 있고 거기에만 있다:
`mainCheck`에도 적었을 때는 main push마다 두 번 돌았다. image는 `gradle/container-images.properties`의
`redis`다.
띄운 Redis에 대고 돌린다. `integrationCheck`에 있고 거기에만 있다. `main.yml`의 `main` job이
`./gradlew :integrationCheck :mainCheck`로 둘을 함께 돌린다. image는 `gradle/container-images.properties`의 `redis`다.
살아 있는 Redis·topology 검증은 빠른 단위 시험과 따로다. 특정 Redis topology나 ACL 배치에 대한 릴리스 주장에는 그에
맞는 살아 있는 검증 lane이 필요하다. 메모리 gateway는 결정적인 계약 시험을 위한 것이지, 외부 Redis 배포가 같은
@@ -71,12 +71,10 @@ redisTopologyLane {
// the same defect (05-02, 05-03). The image is gradle/container-images.properties' `redis`,
// and the ACL file is the one the development stack and the redis-sdk topologies share
// (compose/redis/acl), so the accounts and their rights are the standalone
// topology's. Integration category, so integrationCheck runs it — main.yml's `integration` job, on
// every push to main and nightly. It is deliberately not in this leaf's mainCheck as well: `main` and
// `integration` are two jobs of the same workflow run, so a
// lane in both started a second Redis container and ran every live contract twice per push without
// covering anything the first run did not (found while fixing review 2026-11-03). Sentinel, cluster
// and TLS remain the topology lane's.
// topology's. Integration category, so integrationCheck runs it — main.yml's `main` job runs
// `./gradlew :integrationCheck :mainCheck` on every push to main and nightly. It is not in this leaf's
// mainCheck as well: one stage is where a lane is owned, and verifyStrictLaneStages names that stage.
// Sentinel, cluster and TLS remain the topology lane's.
def redisAclDirectory = rootProject.projectDir.toPath().resolve('compose/redis/acl').toFile()
strictTestLanes {
lane('redisContainerContractTest') {
+4 -6
View File
@@ -230,12 +230,10 @@ strictTestLanes {
// the deadline and evidence contracts against real TCP faults — a slow drip, a cut stream, a refused
// connect — and review 2026-11-01 05-06/05-16 put it in the main stage because it was reachable only
// through integrationCheck, which then ran on no main-branch build. That premise no longer holds:
// main.yml's `integration` job runs integrationCheck (an integration lane, so this one) on every push
// to main and nightly, in the same workflow run as the `main` job. In both
// stages, every main push started a second Toxiproxy and httpbin and ran every fault twice without
// covering anything the first run did not (review 2026-11-03 README §8, closed in round 9; the
// cache-redis container lane left mainCheck for the same reason). verifyStrictLaneStages still fails
// if no executed stage reaches it. It stays out of `check` for the reason above.
// main.yml's `main` job runs `./gradlew :integrationCheck :mainCheck` (an integration lane, so this
// one) on every push to main and nightly. One stage owns the lane, so it is in integrationCheck only
// (the cache-redis container lane likewise). verifyStrictLaneStages still fails if no executed stage
// reaches it. It stays out of `check` for the reason above.
tasks.named('mainCheck') {
dependsOn 'spring70CompatibilityTest'
}