From 893e613981476771b6dde35a0a0ca921065c7e24 Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@gmail.com>
Date: Wed, 15 Oct 2025 12:39:19 +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=20LangGraph=20=EC=9B=8C=ED=81=AC?=
 =?UTF-8?q?=ED=94=8C=EB=A1=9C=EC=9A=B0=20=EA=B7=9C=EC=B9=99=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 복잡한 다단계 처리는 LangGraph 적극 활용
- 체크포인트 필수 (PostgresSaver)
- stateless 금지 (프레임워크 가치 없음)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 300_architecture/311_FastAPI_구조_원칙.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/300_architecture/311_FastAPI_구조_원칙.md b/300_architecture/311_FastAPI_구조_원칙.md
index 15ce208..c920f06 100644
--- a/300_architecture/311_FastAPI_구조_원칙.md
+++ b/300_architecture/311_FastAPI_구조_원칙.md
@@ -93,6 +93,11 @@ utils
 
 ## 5. 코드 작성 원칙
 
+### LangGraph 워크플로우
+- **복잡한 다단계 처리**: LangGraph 적극 활용
+- **체크포인트 필수**: PostgresSaver로 부분 재시도 가능하게 구현
+- **stateless 금지**: 체크포인트 없는 LangGraph는 일반 함수와 동일, 프레임워크 가치 없음
+
 ### router 계층
 ```python
 # ✅ 올바름