From 5395d694ef3a791d1aee6a5505f85fc2b9758c3a Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Sat, 29 Nov 2025 14:15:29 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20IR=20Deck=20API=20=EC=A0=84=EC=B2=B4=20?= =?UTF-8?q?=ED=94=8C=EB=A1=9C=EC=9A=B0=20=EB=B0=8F=20=EC=A4=91=EC=9A=94?= =?UTF-8?q?=ED=95=9C=20=EC=A0=90=20=EC=84=B9=EC=85=98=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...1128_ir_deck_valuation_backend_architecture.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) 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의 업로드/검색 기능 재사용으로 개발 시간 단축