From 81d524390b5d6e8497ad2bd0f696d7bf06e39c98 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 29 Nov 2025 21:34:39 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20IR=20Deck=20=ED=8F=89=EA=B0=80=20UX=20?=
 =?UTF-8?q?=EC=8B=9C=EB=82=98=EB=A6=AC=EC=98=A4=20=EB=AC=B8=EC=84=9C=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 journey/IR/ir_deck_evaluation_ux_scenario.md | 112 +++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 journey/IR/ir_deck_evaluation_ux_scenario.md

diff --git a/journey/IR/ir_deck_evaluation_ux_scenario.md b/journey/IR/ir_deck_evaluation_ux_scenario.md
new file mode 100644
index 0000000..5a13336
--- /dev/null
+++ b/journey/IR/ir_deck_evaluation_ux_scenario.md
@@ -0,0 +1,112 @@
+# IR Deck 평가 UX 시나리오
+
+**작성일**: 2025-11-30  
+**관련 문서**: 
+- [IR Deck 평가 백엔드 아키텍처](../troubleshooting/251128_ir_deck_valuation_backend_architecture.md)
+- [IR Deck 평가 프론트엔드 설정](../troubleshooting/251128_ir_valuation_frontend_setup.md)
+
+---
+
+## 목적
+
+IR Deck 평가 기능의 사용자 경험(UX) 시나리오 정의. 사용자가 IR Deck을 업로드하고 평가 결과를 확인하며 개선점을 파악하는 전체 플로우를 명확히 함.
+
+## 사용자 목표
+
+**주요 목표**: IR Deck을 업로드하여 투자자 관점에서 평가받고, 페이지별 개선점을 파악하여 Deck을 교정하기 위한 기본 자료로 활용.
+
+## 전체 플로우
+
+### 1. 파일 업로드
+- 사용자가 PDF 파일을 드래그 앤 드롭 또는 파일 선택으로 업로드
+- 업로드 진행률 표시 (0-100%)
+- 업로드 완료 시 `document_id` 반환, 파일명 표시
+
+### 2. 평가 시작
+- 업로드 완료 후 자동으로 평가 시작 (또는 "평가 시작" 버튼 클릭)
+- 평가 진행 상태 표시 ("분석 중...")
+- 평가 완료까지 폴링 (3초 간격)
+
+### 3. 평가 결과 표시
+
+#### 3.1 전체 평가 결과
+- **종합 점수**: 0-100점
+- **등급**: S (90+), A (80-89), B (70-79), C (0-69)
+- **전체 강점**: 3-5개 핵심 강점 리스트
+- **전체 약점**: 3-5개 핵심 약점 리스트
+- **투자 리스크**: 2-3개 주요 리스크 (선택)
+
+#### 3.2 페이지별 분석 결과
+- 각 페이지별로 표시:
+  - **페이지 번호**
+  - **잘된 점**: 해당 페이지에서 잘 표현된 내용 (Sequoia 10가지 스토리 기준)
+  - **못한 점**: 해당 페이지에서 부족하거나 개선이 필요한 내용
+- **점수는 표시하지 않음** (페이지별 점수 제거)
+
+### 4. 질문/답변
+- 평가 결과 확인 후 IR Deck에 대해 질문 가능
+- 예시 질문:
+  - "이 기업 분석해줘"
+  - "시장 기회는 어떤가?"
+  - "경쟁 우위는 무엇인가?"
+- 평가 결과 컨텍스트를 포함하여 답변 생성
+
+### 5. 피드백 제공
+- 평가 결과에 대한 사용자 피드백 수집
+- 좋아요/싫어요 버튼
+- 등급 피드백 (예상 등급 vs 실제 등급)
+- 피드백 텍스트 (선택)
+
+## 화면 구성
+
+### 메인 화면 (ChatGPT 스타일)
+- 좌측: 채팅 히스토리 사이드바
+- 중앙: 메시지 영역 (파일 업로드, 평가 결과, 질문/답변)
+- 우측: 평가 결과 패널 (접기/펼치기 가능)
+
+### 평가 결과 패널
+- 상단: 종합 점수, 등급, 전체 강점/약점
+- 하단: 페이지별 분석 (스크롤 가능)
+- 각 페이지 카드:
+  - 페이지 번호
+  - 잘된 점 리스트 (녹색 체크마크)
+  - 못한 점 리스트 (빨간색 X)
+
+## 데이터 흐름
+
+```
+사용자 → [파일 업로드] → POST /api/ir-deck/upload → document_id
+     → [평가 시작] → POST /api/ir-deck/evaluate → evaluation_id
+     → [폴링] → GET /api/ir-deck/evaluation/{id} → 평가 결과
+     → [질문] → POST /api/ir-deck/chat → 답변
+     → [피드백] → POST /api/ir-deck/feedback → 저장
+```
+
+## 중요 사항
+
+### 페이지별 분석 목적
+- **IR Deck 교정을 위한 기본 자료 제공**
+- 각 페이지에서 무엇을 잘했고 무엇을 개선해야 하는지 명확히 제시
+- Sequoia Capital 10가지 스토리 기준 + 페이지 내용 기반 분석
+
+### 평가 방식
+- **전체 평가**: 전체 문서를 종합적으로 평가하여 총점/등급 산출 (ChatGPT 방식)
+- **페이지별 분석**: 각 페이지의 잘된 점/못한 점을 별도로 분석 (전체 평가와 독립적)
+
+### 프롬프트 관리
+- 프롬프트는 DB에 저장하여 A/B 테스트 가능
+- 코드 수정 없이 프롬프트 개선 및 버전 관리
+
+## 관련 파일
+
+- `frontend-ir-valuation/src/pages/ir-valuation.tsx`: 프론트엔드 메인 컴포넌트
+- `rb8001/app/router/ir_deck.py`: API 엔드포인트
+- `rb8001/app/services/ir_deck_analyzer.py`: 평가 로직
+
+---
+
+## 참고
+
+- Sequoia Capital 10가지 스토리: 문제 정의, 시장 기회, 솔루션, 제품/서비스, 비즈니스 모델, 경쟁 우위, 팀, 트랙션, 재무, 비전
+- 평가 기준: [IR Deck 평가 백엔드 아키텍처](../troubleshooting/251128_ir_deck_valuation_backend_architecture.md) 참고
+