fix(env)!: env 계약을 배포 설정 동작에 맞추고 verifyEnvKeys가 그 차이를 잡게 한다 #20
Closed
donghyeon.kang
wants to merge 0 commits from
claude/r9-env-keys into main
pull from: claude/r9-env-keys
merge into: :main
:main
:claude/r9-review-record-2
:docs/improve-review-budget
:claude/r9-objstore-exceptions
:claude/w2-be-flaky-ledger
:claude/r9-a-follow-ups
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#20
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 리뷰의 env 계약 발견 열(RR9-03-03·03-04·03-08·03-10, RR9-02-11, RR9-01-22, RR9-04-29~32)을 한 원인으로 묶어 고친다.
docs/registries/env-keys.yaml·.env.example·배포 설정(profile 밖application.yml,config/*.yml, 모듈config/module-defaults/*.yml)이 서로 갈렸는데,verifyEnvKeys가 그 차이를 보지 못했다..env.example을 그대로 복사하면 기동이 실패하는 값 둘:APP_DATASOURCE_CONNECTION_TIMEOUT=5s(Hikari는 long ms),APP_SECURITY_CORS_MAX_AGE=600s(long 초).FORWARD_HEADERS_STRATEGY=native는 프록시 없는 배포에서 호출자가 보낸 forwarded 헤더를 믿게 한다.고른 방법과 버린 대안
verifyEnvKeys가 다섯을 더 본다: ① registry 행은 접두어와 상관없이 읽는다 ② 배포 설정 placeholder는 접두어와 상관없이 행이 있어야 한다 ③deprecated_orphaned행은 배포 설정이 읽지 않고 예시에 없다 ④ 예시 값은 registrydefault(행에example이 있으면 그 값)와 같다 ⑤ profile 밖 placeholder 기본값은 registrydefault와 같다.example칸을 두었다(SMTP 587처럼 기본값이 아닌 권장값).SECURITY_PUBLIC_PATHS·PRESENTATION_API_BASE_PATH를 APP_로 바꾸고 옛 이름을 fallback으로 두기. 공개 경로 기본값이 4중 placeholder가 되고 공개 경로 스냅숏 파서까지 바뀐다. 리뷰 README 6절 결정대로 이름은 그대로 등록했다.위험과 영향
verifyEnvKeys(mainCheck안)가 새로 실패한다. 할 일은docs/upgrade/2026-11-round9-env-keys.md..env는 그대로 남는다. 업그레이드 안내 1~4가 고칠 값을 적는다.검증
desktop,
--no-build-cache, 로그~/r9-be-logs/b2-*.log.a7e38c10+ 시험만으로EnvContractVerifierTest22건 중 7건 실패(새 검사 6건 + 메시지를 바꾼 기존 1건).48952198):-p build-logic test,:app-bootstrap:verifyEnvKeys(314 env keys, 6 required placeholders, 370 rows),:app-bootstrap:test --tests '*Registry*' '*Env*' '*SqlLogging*',:app-bootstrap:repositoryContractTest— 231건 실패 0, skip 1, rc=0. 그 전 트리에서 registry·예시를 읽는 leaf 시험(httpclient env manifest, notification mode, redis-runtime, fileserver·notification platform, graphql registry parity, web CORS) 682건 실패 0.check-docs.pyrc=0.check-work-docs.py는 main의operate.md151줄 때문에만 rc=1(PR #15가 고침).리뷰어가 볼 곳
EnvContractVerifier의shippedDefaults(profile 밖 배포 설정에서 placeholder 기본값을 모으는 곳)와normalizedValue(빈 줄 = 빈 문자열).deprecated_orphaned를 지운 cache-redis 행 셋(upgrade 안내 3절).관련
docs/reviews/2026-11-12-round9-review/.#28로 병합됐다(main
3d31896a). 이 PR의 headd4ba8574가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runnerpr / done이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).Pull request closed