Name: Env Config Management
Author: SolidCitadel

환경변수 및 Spring 프로파일 관리

필수: <a href="../../../app/backend/CLAUDE.md" class="font-medium text-foreground decoration-accent/60 underline underline-offset-4 transition-colors duration-150 hover:text-accent">app/backend/CLAUDE.md - 환경변수 철학, 프로파일 구조
필수: <a href="../../../docs/design/system-architecture.md" class="font-medium text-foreground decoration-accent/60 underline underline-offset-4 transition-colors duration-150 hover:text-accent">docs/design/system-architecture.md - 서비스 포트, API 엔드포인트
SQS: <a href="../../../docs/design/sqs-architecture.md" class="font-medium text-foreground decoration-accent/60 underline underline-offset-4 transition-colors duration-150 hover:text-accent">docs/design/sqs-architecture.md - SQS 큐 이름, 엔드포인트

참조 문서

파일	역할	커밋

`.env`	docker-compose 인프라 설정 (MySQL, LocalStack)	✅	❌	docker-compose up
`.env.common`	컨테이너 공통 앱 설정 (Service URLs, SQS 큐)	✅	❌	docker-compose.{acceptance\|demo}.yml
`.env.local`	Spring 직접 실행용 모든 설정	❌ (gitignore)	✅	Gradle bootRun/test (IDE)
`.env.acceptance`	.env.common 오버라이드 (테스트 DB, 더미 키)	✅	❌	docker-compose.acceptance.yml
`.env.demo`	.env.common 오버라이드 (데모 환경)	✅	❌	docker-compose.demo.yml

파일	환경	커밋	하드코딩	환경변수 로드
`application.yml`	공통	✅	❌ (플레이스홀더만)	-
`application-local.yml`	로컬 개발 (IDE)	✅	❌ (플레이스홀더만)	Gradle이 .env.local 로드
`application-acceptance.yml`	인수 테스트	✅	❌ (플레이스홀더만)	.env.common + .env.acceptance
`application-prod.yml`	운영/데모	✅	❌ (플레이스홀더만)	.env.common + .env.demo