# 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) 참고