--- paths: - "src/**/*Settings.java" - "src/**/settings/**" - "src/**/autoconfigure/**" - "src/**/application*.yml" - "src/**/application*.yaml" - "src/**/config/module-defaults/**" - ".env.example" - ".env.local.example" - "Dockerfile" - "compose.yaml" - "compose/**" - "src/**/compose/**" - "src/bootstrap/app/compose-lanes/**" --- # 설정과 런타임 규칙 ## 설정 - 비밀 값(토큰, 비밀번호, 개인 키)을 코드, 테스트 fixture, 문서 예시에 하드코딩하지 않는다. 예시 값이면 `example`·`dummy`·`changeme`처럼 예시임이 보이게 쓴다. - 새 설정 그룹은 typed settings class로 만든다. 흩어진 `@Value`보다 configuration properties와 settings class를 쓴다. - 새 settings class를 만들면 바인딩·값 검증 테스트를 더한다. - capability 모듈의 설정 prefix는 하나다. 바인딩은 `StrictSettingsBinder`, 값 검증은 설정 record의 compact constructor다(`docs/manual/10-capabilities.md` 기준 4, Redis 예외 포함). - `.env.local`은 로컬 덮어쓰기다. 실제 `.env` 파일은 읽지도 고치지도 않는다(권한 설정이 막는다). 키 계약은 `.env.example`과 `docs/registries/env-keys.yaml`이다. - `application.yml`은 환경마다 안전한 기본값과 분명한 자리표시자만 담는다. ## Docker·Compose - `Dockerfile`을 바꾸면 build context와 runtime env 요구사항을 함께 확인한다. - container 안에서 필요한 profile, port, env 키를 문서나 예시 설정에 반영한다. - local 전용 경로와 운영 경로를 섞지 않는다. 개발 환경 compose는 루트 `compose.yaml` 하나다(「개발 환경」과 lane overlay의 차이는 `docs/work/reference/terms.md`). 테스트 환경(compose, 스크립트)은 그 lane을 가진 leaf 안에 둔다. 배포 매니페스트·프록시 설정·IaC는 이 repo에 두지 않는다(`docs/ci-cd/boundary.md`). - Docker는 노트북에서 돌리지 않는다. desktop에서 돌린다(`docs/work/operate.md` 4.1절).