From 9baf3d7f34e0741c425a22b6b7704c1bae6d7551 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Fri, 2 Jan 2026 12:43:16 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=ED=99=98=EA=B2=BD=EB=B3=80=EC=88=98=20?= =?UTF-8?q?=EA=B4=80=EB=A6=AC=20=EC=9B=90=EC=B9=99=EC=97=90=20=EB=A7=88?= =?UTF-8?q?=EC=9D=B4=EA=B7=B8=EB=A0=88=EC=9D=B4=EC=85=98=20=EC=A3=BC?= =?UTF-8?q?=EC=9D=98=EC=82=AC=ED=95=AD=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - DB 마이그레이션 시 .env 정리 필수 - 환경변수 사용 여부 코드 확인 필요 - 동적 설정은 DB 사용 권장 --- book/300_architecture/311_FastAPI_구조_원칙.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/book/300_architecture/311_FastAPI_구조_원칙.md b/book/300_architecture/311_FastAPI_구조_원칙.md index 8cb5478..76369ee 100644 --- a/book/300_architecture/311_FastAPI_구조_원칙.md +++ b/book/300_architecture/311_FastAPI_구조_원칙.md @@ -258,6 +258,11 @@ utils - ❌ `docker-compose.yml`의 `environment:` 섹션에 하드코딩된 값 - ❌ 코드에 API 키, 토큰, 비밀번호 등 민감 정보를 기본값/백업 값으로 직접 하드코딩 +**마이그레이션 시 주의사항**: +- **DB 마이그레이션 시 .env 정리 필수**: 환경변수 기반 설정을 DB로 옮긴 후, `.env`에서 관련 변수 주석 처리 또는 삭제 필요 (마이그레이션 스크립트 실행 후 누락 방지) +- **환경변수 사용 여부는 코드에서 확인**: `config.py`에 정의되어 있어도 실제 사용 여부는 `grep` 등으로 코드 검색하여 확인 필요 (불필요한 변수 유지 방지) +- **동적 관리가 필요한 설정은 DB 사용**: 스케줄러처럼 런타임 변경이 필요한 설정은 DB로 관리하는 것이 적절함 (환경변수 재시작 필요 문제 해결) + ## 13. LLM 우선 접근 원칙 **핵심 원칙**: LLM을 기본으로 사용하고, 하드코딩된 규칙(heuristic)은 최소화