docs: 특정 UX 개선 사례를 원칙에서 제거 (너무 구체적)

This commit is contained in:
Claude-51124 2026-01-26 10:30:20 +09:00
parent 6a73e3fd84
commit a027c50ecb

View File

@ -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/비즈니스 로직 금지