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:
@@ -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`)
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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') {
|
||||
|
||||
@@ -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'
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user