diff --git a/journey/troubleshooting/251128_ir_deck_valuation_backend_architecture.md b/journey/troubleshooting/251128_ir_deck_valuation_backend_architecture.md
index 3e04ed2..31e31cb 100644
--- a/journey/troubleshooting/251128_ir_deck_valuation_backend_architecture.md
+++ b/journey/troubleshooting/251128_ir_deck_valuation_backend_architecture.md
@@ -155,6 +155,21 @@ CREATE TABLE ir_deck_feedback (
 - 등급 분류를 위한 베이지안 분류기 구현 (향후)
 - 피드백 데이터가 충분히 쌓이면 학습 시작
 
+## 전체 플로우
+
+1. **업로드**: `POST /rb8001/api/ir-deck/upload` → `document_id` 반환
+2. **평가**: `POST /rb8001/api/ir-deck/evaluate` → 동기식으로 완료까지 대기 → `evaluation_id`, `total_score`, `grade`, `page_evaluations` 반환
+3. **조회**: `GET /rb8001/api/ir-deck/evaluation/{id}` → DB 조회 (폴링용)
+
+**참고**: `/rb8001`는 Nginx 프록시 경로 (51123 → 51124:8001)
+
+## 중요한 점
+
+- **동기식 평가**: `/evaluate` API는 평가 완료까지 대기 (페이지별 순차 실행, 타임아웃 주의)
+- **중복 방지**: `force_reevaluate=False` 시 기존 평가 반환
+- **의존 서비스**: skill-rag-file (포트 8508), 내장 LLM
+- **DB 테이블**: `ir_deck_evaluations`, `ir_deck_page_evaluations`, `ir_deck_feedback`
+
 ## 교훈
 
 - **기존 인프라 활용**: skill-rag-file의 업로드/검색 기능 재사용으로 개발 시간 단축