ivada-infra/DOCS
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity

docs: LangGraph 워크플로우 사용자 피드백 원칙 추가

Browse Source 
- interrupt()로 사용자 확인 대기 시 즉시 피드백 제공 원칙 추가
- 처리 완료 후 메시지 업데이트로 진행 상황 표시 원칙 추가
- 기존 패턴 재사용 원칙 명시
This commit is contained in:
Claude-51124 2026-01-26 10:29:21 +09:00
parent 47e4987c6d
commit 6a73e3fd84
1 changed files with 6 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
book/300_architecture/311_백엔드_구조_원칙.md
View File

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