From 6a73e3fd8463804118e38815e1e838b75130bed1 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Mon, 26 Jan 2026 10:29:21 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20LangGraph=20=EC=9B=8C=ED=81=AC=ED=94=8C?= =?UTF-8?q?=EB=A1=9C=EC=9A=B0=20=EC=82=AC=EC=9A=A9=EC=9E=90=20=ED=94=BC?= =?UTF-8?q?=EB=93=9C=EB=B0=B1=20=EC=9B=90=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 - interrupt()로 사용자 확인 대기 시 즉시 피드백 제공 원칙 추가 - 처리 완료 후 메시지 업데이트로 진행 상황 표시 원칙 추가 - 기존 패턴 재사용 원칙 명시 --- book/300_architecture/311_백엔드_구조_원칙.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) 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/비즈니스 로직 금지