diff --git a/book/300_architecture/311_FastAPI_구조_원칙.md b/book/300_architecture/311_FastAPI_구조_원칙.md index 5f4e2c5..f6cda6c 100644 --- a/book/300_architecture/311_FastAPI_구조_원칙.md +++ b/book/300_architecture/311_FastAPI_구조_원칙.md @@ -114,6 +114,9 @@ utils - 중단 시 복구 가능하도록 체크포인트 저장 - **실험/경량 플로우**: stateless LangGraph 허용 - 단순한 워크플로우는 stateless로 시작, 필요 시 체크포인트 추가 +- **워크플로우 중복 실행 방지**: LangGraph 워크플로우가 활성화되면 개별 Phase 단계는 건너뛰기 + - 워크플로우 내부에서 이미 처리하는 단계(질문 확장, 의도 분류 등)를 외부에서 중복 실행하지 않음 + - 예: `INTENT_USE_LANGGRAPH=true`이면 `message_service`의 Phase 1(질문 확장) 건너뛰기 ### 계층별 원칙 - **router**: 서비스 호출만, DB/비즈니스 로직 금지