문제: 살아 있는 문서의 언어, 기록의 상태 표시, 인라인 코드 경로, 복사한 버전·개수를 아무 검사도 보지 않는다. lychee는 마크다운 링크만 보는데 경로 대부분은 인라인 코드로 쓰여 있고, leaf CLAUDE.md는 Spring Boot 버전을 4.0.0으로 적어 둔 채 낡았다. 고른 방법: Gradle 밖 scripts/check-docs.py 하나에 검사 넷을 둔다. - language: 살아 있는 문서와 ADR 본문이 한국어인가. 판정은 보고 언어 훅 H11과 같다(코드·명령·경로·인용을 빼고 영어 낱말 3개 이상, 한글 비율 0.3 미만이면 영어). - head: 기록·ADR 맨 위 머리 블록의 칸, 종류별 상태 어휘, 날짜, 한국어 요약, 현재 정본·대체됨 경로. - reference: 인라인 코드 안 src/·docs/·scripts/·infra/·.github/ 경로와 Gradle 경로가 지금 트리·registry에 있는가. 코드 블록, 「> 이력」 인용, 제거 표, upgrade/는 건너뛴다. leaf 기준 경로는 어느 파일의 끝부분과 맞으면 있다고 본다. - number: Spring Boot x.y.z와 leaf 개수 문장. 예외 목록(scripts/check-docs-exceptions.txt)은 2026-11-07 기준선 217줄이고 줄기만 한다. 줄마다 sha256 지문이 스크립트의 FROZEN에 있어야 해서 목록에 새 줄을 더하면 실패하고, 더는 걸리지 않는 줄을 남겨 두면 실패한다. workflow docs-check.yml이 PR마다 경로 필터 없이 자기 시험과 검사를 돌린다. 코드에서 파일을 지우는 변경이 문서를 낡게 만들기 때문이다. 같은 커밋에서 지도 CLAUDE.md의 Spring Boot 버전 복사를 정본 가리키기로 고쳤다. 버린 대안: 예외 목록 하나에 「늘리지 않는다」는 약속만 두는 방식(테스트의 KNOWN_DEVIATIONS와 같은 꼴)은 brief가 요구한 「더하면 실패」를 기계로 막지 못한다. 기준선을 git 이력(merge-base)과 비교하는 방식은 얕은 checkout에서 깨진다. 검사를 link-check.yml에 더하는 방식은 그 workflow가 docs 경로에만 걸리고 repository-contract 테스트가 trigger를 고정한다. CI 재편 때 단계 workflow로 접는다. 위험·한계: 타입 이름 검사(지운 클래스 이름)는 넣지 않았다. 외부 타입과 구분하려면 git 전체 이력이 필요하다. 경로 검사는 루트 폴더로 시작하는 경로만 보므로 src/ 기준 상대 경로(adapter/outbound/...)는 보지 않는다. leaf 개수 규칙은 설계 문서의 개수 같은 정당한 숫자도 잡을 수 있다(지금 generator 출력 예 하나가 예외 목록에 있다). 구조 정리가 src/messaging 등을 옮기면 예외 줄의 경로가 바뀌므로 그 병합에서 FROZEN을 함께 고쳐야 한다. 레지스트리 yaml 설명 칸의 언어는 보지 않는다. 검증: python3 -m unittest discover -s scripts/tests 42개 통과. 변이 시험: 기준선 확인·낡은 예외 확인·언어 판정·이력 인용 건너뛰기·소스 세트 이름· 끝부분 대조·상태 어휘를 하나씩 끄면 해당 시험이 실패했다. python3 scripts/check-docs.py rc=0(language 181·reference 7·number 29가 모두 예외, head 0), check-work-docs.py rc=0.
229 lines
12 KiB
Plaintext
229 lines
12 KiB
Plaintext
# scripts/check-docs.py의 예외 목록. 2026-11-07 기준선이고 줄기만 한다.
|
|
#
|
|
# - 이 목록에 새 줄을 더하면 검사가 실패한다. 줄마다 check-docs.py의 FROZEN에 지문이 있어야 한다.
|
|
# - 번역하거나 고쳐서 더는 걸리지 않는 줄은 지운다. 남겨 두면 검사가 실패한다.
|
|
# - 형식: <검사><탭><경로>[<탭><걸린 값>]. 「#」으로 시작하는 줄과 빈 줄은 읽지 않는다.
|
|
|
|
# 언어: 아직 한국어로 옮기지 않은 살아 있는 문서와 ADR. 다음 단계(살아 있는 문서 번역, ADR 번역)에서 지운다.
|
|
language .github/dependency-vulnerability-policy.md
|
|
language .github/pull_request_template.md
|
|
language docs/adr/ADR-BUILD-001-one-convention-for-shared-test-code.md
|
|
language docs/adr/ADR-GQL-001-graphql-context-and-storage-ownership.md
|
|
language docs/adr/ADR-GRPC-001-platform-family-and-registry-shape.md
|
|
language docs/adr/ADR-GRPC-002-schema-governance-without-protoc.md
|
|
language docs/adr/ADR-GRPC-003-three-axis-execution-evidence.md
|
|
language docs/adr/ADR-GRPC-004-retry-ownership-and-durable-idempotency.md
|
|
language docs/adr/ADR-GRPC-005-server-streaming-single-writer-and-resume.md
|
|
language docs/adr/ADR-GRPC-006-stable-discovery-and-kubernetes-routing.md
|
|
language docs/adr/ADR-GRPC-ADV-001-capability-promotion-is-per-capability.md
|
|
language docs/adr/ADR-JPA-001-domain-owns-persistence-model.md
|
|
language docs/adr/ADR-JPA-002-full-transaction-retry.md
|
|
language docs/adr/ADR-JPA-003-completion-unknown.md
|
|
language docs/adr/ADR-JPA-004-flyway-schema-source-of-truth.md
|
|
language docs/adr/ADR-JPA-005-postgresql-real-contract.md
|
|
language docs/adr/ADR-JPA-006-canonical-technical-audit.md
|
|
language docs/adr/ADR-MONGO-001-platform-boundary.md
|
|
language docs/adr/ADR-MONGO-002-bson-representation.md
|
|
language docs/adr/ADR-MONGO-003-transaction-retry.md
|
|
language docs/adr/ADR-MONGO-004-index-schema-admin-plane.md
|
|
language docs/adr/ADR-MONGO-ADV-001-capability-promotion.md
|
|
language docs/adr/ADR-WEB-ADV-001-streaming-is-live-delivery.md
|
|
language docs/adr/ADR-WEB-ADV-002-virtual-threads-do-not-remove-admission.md
|
|
language docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md
|
|
language docs/adr/ADR-WS-001-platform-as-packages-and-its-boundaries.md
|
|
language docs/adr/ADR-WS-002-resume-and-cluster.md
|
|
language docs/adr/ADR-WS-003-stomp-and-broker-relay.md
|
|
language docs/compatibility/grpc-advanced-support-matrix.md
|
|
language docs/compatibility/grpc-support-matrix.md
|
|
language docs/fileserver/configuration.md
|
|
language docs/fileserver/design-deviations.md
|
|
language docs/fileserver/http-contract.md
|
|
language docs/fileserver/operations.md
|
|
language docs/fileserver/security.md
|
|
language docs/fileserver/storage-certification.md
|
|
language docs/fileserver/support-matrix.md
|
|
language docs/fileserver/upgrade-guide.md
|
|
language docs/httpclient/configuration-reference.md
|
|
language docs/httpclient/operations.md
|
|
language docs/httpclient/performance-baseline.md
|
|
language docs/httpclient/release-checklist.md
|
|
language docs/httpclient/repository-adaptation.md
|
|
language docs/httpclient/retry-and-ambiguity.md
|
|
language docs/httpclient/security.md
|
|
language docs/httpclient/streaming.md
|
|
language docs/httpclient/support-matrix.md
|
|
language docs/jpa/batch-write-guide.md
|
|
language docs/jpa/entity-mapping-guide.md
|
|
language docs/jpa/experimental-promotion-checklist.md
|
|
language docs/jpa/experimental-support-matrix.md
|
|
language docs/jpa/migration-guide.md
|
|
language docs/jpa/observability.md
|
|
language docs/jpa/postgresql-extensions.md
|
|
language docs/jpa/query-fetch-guide.md
|
|
language docs/jpa/repository-adaptation.md
|
|
language docs/jpa/runbooks.md
|
|
language docs/jpa/security.md
|
|
language docs/jpa/support-matrix.md
|
|
language docs/jpa/transaction-guide.md
|
|
language docs/mongodb/advanced/encryption.md
|
|
language docs/mongodb/advanced/multi-tenancy.md
|
|
language docs/mongodb/advanced/sharding.md
|
|
language docs/mongodb/advanced/signoff/README.md
|
|
language docs/mongodb/bson-mapping-guide.md
|
|
language docs/mongodb/consistency-transaction-guide.md
|
|
language docs/mongodb/document-modeling-guide.md
|
|
language docs/mongodb/query-aggregation-guide.md
|
|
language docs/mongodb/repository-adaptation.md
|
|
language docs/mongodb/runbooks/failover.md
|
|
language docs/mongodb/runbooks/unknown-commit.md
|
|
language docs/mongodb/schema-index-migration-guide.md
|
|
language docs/mongodb/security-observability.md
|
|
language docs/mongodb/support-matrix.md
|
|
language docs/notification/adr/NOTIF-ADR-001-durable-acceptance.md
|
|
language docs/notification/adr/NOTIF-ADR-002-event-ledger-projection.md
|
|
language docs/notification/adr/NOTIF-ADR-003-ambiguous-submission.md
|
|
language docs/notification/adr/NOTIF-ADR-004-fcm-fid-primary.md
|
|
language docs/notification/at-rest-threat-model.md
|
|
language docs/notification/callback-reconciliation.md
|
|
language docs/notification/configuration-reference.md
|
|
language docs/notification/delivery-evidence.md
|
|
language docs/notification/migration-guide.md
|
|
language docs/notification/module-mapping.md
|
|
language docs/notification/operations.md
|
|
language docs/notification/provider-runbooks.md
|
|
language docs/notification/security-privacy.md
|
|
language docs/notification/support-matrix.md
|
|
language docs/observability/log-fields.md
|
|
language docs/redis/command-policy.md
|
|
language docs/redis/operations.md
|
|
language docs/redis/support-matrix.md
|
|
language docs/redis/upgrade-guide.md
|
|
language docs/runbooks/adapter-adapter-disabled.md
|
|
language docs/runbooks/auth-audience-mismatch.md
|
|
language docs/runbooks/auth-claim-mapping-failed.md
|
|
language docs/runbooks/auth-issuer-mismatch.md
|
|
language docs/runbooks/auth-jwks-unavailable.md
|
|
language docs/runbooks/auth-kid-unknown.md
|
|
language docs/runbooks/auth-public-path-misconfiguration.md
|
|
language docs/runbooks/auth-token-expired.md
|
|
language docs/runbooks/auth-token-invalid-signature.md
|
|
language docs/runbooks/auth-token-malformed.md
|
|
language docs/runbooks/auth-token-missing.md
|
|
language docs/runbooks/authz-insufficient-permission.md
|
|
language docs/runbooks/authz-tenant-mismatch.md
|
|
language docs/runbooks/cache-stampede-lock-timeout.md
|
|
language docs/runbooks/cache-unavailable.md
|
|
language docs/runbooks/db-deadlock.md
|
|
language docs/runbooks/db-idle-in-tx-timeout.md
|
|
language docs/runbooks/db-query-canceled.md
|
|
language docs/runbooks/db-serialization-failure.md
|
|
language docs/runbooks/db-unavailable.md
|
|
language docs/runbooks/dependency-4xx-client.md
|
|
language docs/runbooks/dependency-5xx-server.md
|
|
language docs/runbooks/dependency-circuit-open.md
|
|
language docs/runbooks/dependency-connect-failed.md
|
|
language docs/runbooks/dependency-dns-failed.md
|
|
language docs/runbooks/dependency-timeout.md
|
|
language docs/runbooks/file-download-streaming-failure.md
|
|
language docs/runbooks/grpc-advanced-capabilities.md
|
|
language docs/runbooks/grpc-platform-operations.md
|
|
language docs/runbooks/idempotency-unavailable.md
|
|
language docs/runbooks/lock-acquisition-timeout.md
|
|
language docs/runbooks/management-actuator-forbidden.md
|
|
language docs/runbooks/migration-failed.md
|
|
language docs/runbooks/runtime-jvm-oom.md
|
|
language docs/runbooks/startup-profile-mismatch.md
|
|
language docs/runbooks/startup-required-adapter-disabled.md
|
|
language docs/runbooks/startup-validation-failed.md
|
|
language docs/runbooks/template.md
|
|
language docs/storage-capability-boundary.md
|
|
language docs/web/advanced-capabilities.md
|
|
language docs/web/openapi-32-compatibility.md
|
|
language docs/web/patch-contract.md
|
|
language docs/web/repository-adaptation.md
|
|
language docs/web/runbook.md
|
|
language docs/web/streaming-contract.md
|
|
language docs/web/virtual-thread-profile.md
|
|
language docs/websocket/runbook.md
|
|
language infra/httpclient/README.md
|
|
language infra/httpclient/oauth2/README.md
|
|
language infra/httpclient/proxy/README.md
|
|
language infra/httpclient/tls/README.md
|
|
language infra/jpa/postgres/README.md
|
|
language infra/keycloak/README.md
|
|
language infra/messaging/tls/README.md
|
|
language infra/redis-sdk/README.md
|
|
language infra/redis-sdk/acl/README.md
|
|
language src/adapter/inbound/messaging/CLAUDE.md
|
|
language src/adapter/inbound/web-advanced/CLAUDE.md
|
|
language src/adapter/inbound/web/CLAUDE.md
|
|
language src/adapter/inbound/websocket/CLAUDE.md
|
|
language src/adapter/outbound/cache-redis/CLAUDE.md
|
|
language src/adapter/outbound/cache-redis/README.md
|
|
language src/adapter/outbound/fileserver/CLAUDE.md
|
|
language src/adapter/outbound/fileserver/README.md
|
|
language src/adapter/outbound/httpclient/CLAUDE.md
|
|
language src/adapter/outbound/httpclient/README.md
|
|
language src/adapter/outbound/identifier/CLAUDE.md
|
|
language src/adapter/outbound/messaging-kafka/CLAUDE.md
|
|
language src/adapter/outbound/messaging/CLAUDE.md
|
|
language src/adapter/outbound/notification/CLAUDE.md
|
|
language src/adapter/outbound/objectstorage/CLAUDE.md
|
|
language src/adapter/outbound/objectstorage/README.md
|
|
language src/adapter/outbound/persistence-fileserver/CLAUDE.md
|
|
language src/adapter/outbound/persistence-jpa/CLAUDE.md
|
|
language src/adapter/outbound/persistence-mongo/CLAUDE.md
|
|
language src/adapter/outbound/persistence-notification/CLAUDE.md
|
|
language src/adapter/outbound/redis-sdk/README.md
|
|
language src/adapter/outbound/support/CLAUDE.md
|
|
language src/app-bootstrap/CLAUDE.md
|
|
language src/app-bootstrap/src/test/resources/developer-experience/broken-readme.md
|
|
language src/application-core/CLAUDE.md
|
|
language src/build-logic/README.md
|
|
language src/composition/outbox-relay/CLAUDE.md
|
|
language src/config/architecture/README.md
|
|
language src/domain-core/CLAUDE.md
|
|
language src/optional-platforms/README.md
|
|
language src/sample-portfolio/CLAUDE.md
|
|
language src/shared-contract/CLAUDE.md
|
|
|
|
# 참조: 지금 트리·registry에 없는 경로. 고치거나 「> 이력」 인용 블록으로 옮기면 지운다.
|
|
reference AGENTS.md src/build-tools/
|
|
reference docs/mongodb/consumer-leaf-guide.md :adapter:outbound:persistence-note:check
|
|
reference docs/web/http-contract.md docs/architecture/backend-api-and-server-state-contract.md
|
|
reference docs/work/operate.md :a:test
|
|
reference docs/work/operate.md :b:test
|
|
reference src/README.md .github/ci-gate-matrix.yml
|
|
reference src/README.md .github/scripts/verify-gate-matrix.sh
|
|
|
|
# 숫자: 정본(src/gradle/libs.versions.toml, registry)이 정하는 값을 복사한 곳. 정본을 가리키게 고치면 지운다.
|
|
number docs/compatibility/grpc-support-matrix.md Spring Boot 4.0.8
|
|
number docs/httpclient/repository-adaptation.md 19 leaf
|
|
number docs/httpclient/repository-adaptation.md Spring Boot 4.0.8
|
|
number docs/jpa/repository-adaptation.md 19 leaf
|
|
number docs/jpa/repository-adaptation.md Spring Boot 4.0.8
|
|
number docs/manual/01-generator.md 5 leaf
|
|
number docs/mongodb/repository-adaptation.md 19 leaf
|
|
number docs/mongodb/repository-adaptation.md Spring Boot 4.0.8
|
|
number src/adapter/inbound/graphql/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/inbound/graphql/README.md 19개 leaf
|
|
number src/adapter/inbound/graphql/README.md 24개 leaf
|
|
number src/adapter/inbound/graphql/README.md 43개 leaf
|
|
number src/adapter/inbound/grpc/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/inbound/web/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/inbound/websocket/CLAUDE.md Spring Boot 4.0.8
|
|
number src/adapter/outbound/cache-redis/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/fileserver/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/httpclient/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/identifier/CLAUDE.md Spring Boot 4.0.8
|
|
number src/adapter/outbound/messaging/CLAUDE.md Spring Boot 4.0.8
|
|
number src/adapter/outbound/notification/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/objectstorage/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/persistence-jpa/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/persistence-mongo/CLAUDE.md Spring Boot 4.0.0
|
|
number src/adapter/outbound/support/CLAUDE.md Spring Boot 4.0.0
|
|
number src/app-bootstrap/CLAUDE.md Spring Boot 4.0.0
|
|
number src/domain-core/CLAUDE.md Spring Boot 4.0.0
|
|
number src/sample-portfolio/CLAUDE.md Spring Boot 4.0.0
|
|
number src/shared-contract/CLAUDE.md Spring Boot 4.0.0
|