From 6f257b0308585c01cb719ba94455e303fa8d54bf Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 29 Nov 2025 17:08:10 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20FastAPI=20=EA=B5=AC=EC=A1=B0=20?=
 =?UTF-8?q?=EC=9B=90=EC=B9=99=EC=97=90=20=EB=A1=9C=EA=B9=85=20=EC=9B=90?=
 =?UTF-8?q?=EC=B9=99=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../300_architecture/311_FastAPI_구조_원칙.md | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/book/300_architecture/311_FastAPI_구조_원칙.md b/book/300_architecture/311_FastAPI_구조_원칙.md
index fd5726c..d5efb2c 100644
--- a/book/300_architecture/311_FastAPI_구조_원칙.md
+++ b/book/300_architecture/311_FastAPI_구조_원칙.md
@@ -208,7 +208,20 @@ from app.services import coldmail_filter             # ✅ 모듈 import
 # 긴급 수정: 2025-10-02, 사유: DB 장애 복구
 ```
 
-## 11. 모범 사례 참고
+## 11. 로깅 원칙
+
+**로그 레벨 사용 기준** (Python logging 공식 문서):
+- **DEBUG**: 개발/디버깅용 상세 정보 (중간 과정, 내부 상태)
+- **INFO**: 정상 동작 및 주요 이벤트 (시작/종료, 주요 단계)
+- **WARNING**: 잠재적 문제 (예상치 못한 상황, 성능 저하 가능성)
+- **ERROR**: 오류 발생 (기능 실패, 예외 처리)
+
+**규칙**:
+- 시작/종료는 반드시 INFO 레벨
+- 중간 과정은 DEBUG 레벨
+- 프로덕션에서는 INFO 기본, DEBUG는 필요 시에만 활성화
+
+## 12. 모범 사례 참고
 
 본 문서는 FastAPI 커뮤니티의 다음 모범 사례를 반영하였습니다: