diff --git a/book/300_architecture/311_백엔드_구조_원칙.md b/book/300_architecture/311_백엔드_구조_원칙.md index b2cce10..c9f64d3 100644 --- a/book/300_architecture/311_백엔드_구조_원칙.md +++ b/book/300_architecture/311_백엔드_구조_원칙.md @@ -1,7 +1,7 @@ # FastAPI 프로젝트 구조 원칙 **작성일**: 2025-09-17 -**수정일**: 2026-01-21 (파일 크기 제한 300줄 → 500줄 완화) +**수정일**: 2026-01-26 (LangGraph 워크플로우 사용자 피드백 원칙 추가) ## 1. 계층 분리 원칙 @@ -124,6 +124,11 @@ utils - **워크플로우 중복 실행 방지**: LangGraph 워크플로우가 활성화되면 개별 Phase 단계는 건너뛰기 - 워크플로우 내부에서 이미 처리하는 단계(질문 확장, 의도 분류 등)를 외부에서 중복 실행하지 않음 - 예: `INTENT_USE_LANGGRAPH=true`이면 `message_service`의 Phase 1(질문 확장) 건너뛰기 +- **사용자 피드백이 필요한 워크플로우**: 즉시 피드백 제공 필수 + - `interrupt()`로 사용자 확인 대기 시, 버튼 클릭 즉시 "로빙 중…" 메시지 전송 + - 처리 완료 후 메시지 업데이트로 진행 상황 표시 + - 기존 패턴 재사용: IR 분석 버튼의 "로빙 중…" 패턴과 동일한 방식 적용 + - **교훈**: 긴 처리 시간이 필요한 작업은 반드시 즉시 피드백 제공 (사용자 불안감 방지) ### 계층별 원칙 - **router**: 서비스 호출만, DB/비즈니스 로직 금지