From a027c50ecbb944aec332ffd75f86fc5dd0ad7699 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Mon, 26 Jan 2026 10:30:20 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=ED=8A=B9=EC=A0=95=20UX=20=EA=B0=9C?= =?UTF-8?q?=EC=84=A0=20=EC=82=AC=EB=A1=80=EB=A5=BC=20=EC=9B=90=EC=B9=99?= =?UTF-8?q?=EC=97=90=EC=84=9C=20=EC=A0=9C=EA=B1=B0=20(=EB=84=88=EB=AC=B4?= =?UTF-8?q?=20=EA=B5=AC=EC=B2=B4=EC=A0=81)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- book/300_architecture/311_백엔드_구조_원칙.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/book/300_architecture/311_백엔드_구조_원칙.md b/book/300_architecture/311_백엔드_구조_원칙.md index c9f64d3..b2cce10 100644 --- a/book/300_architecture/311_백엔드_구조_원칙.md +++ b/book/300_architecture/311_백엔드_구조_원칙.md @@ -1,7 +1,7 @@ # FastAPI 프로젝트 구조 원칙 **작성일**: 2025-09-17 -**수정일**: 2026-01-26 (LangGraph 워크플로우 사용자 피드백 원칙 추가) +**수정일**: 2026-01-21 (파일 크기 제한 300줄 → 500줄 완화) ## 1. 계층 분리 원칙 @@ -124,11 +124,6 @@ utils - **워크플로우 중복 실행 방지**: LangGraph 워크플로우가 활성화되면 개별 Phase 단계는 건너뛰기 - 워크플로우 내부에서 이미 처리하는 단계(질문 확장, 의도 분류 등)를 외부에서 중복 실행하지 않음 - 예: `INTENT_USE_LANGGRAPH=true`이면 `message_service`의 Phase 1(질문 확장) 건너뛰기 -- **사용자 피드백이 필요한 워크플로우**: 즉시 피드백 제공 필수 - - `interrupt()`로 사용자 확인 대기 시, 버튼 클릭 즉시 "로빙 중…" 메시지 전송 - - 처리 완료 후 메시지 업데이트로 진행 상황 표시 - - 기존 패턴 재사용: IR 분석 버튼의 "로빙 중…" 패턴과 동일한 방식 적용 - - **교훈**: 긴 처리 시간이 필요한 작업은 반드시 즉시 피드백 제공 (사용자 불안감 방지) ### 계층별 원칙 - **router**: 서비스 호출만, DB/비즈니스 로직 금지