# IR Deck 평가 - 사용자 시나리오

**작성일**: 2025-12-02  
**목적**: 사용자 입장에서 IR Deck 평가 기능을 처음 사용하는 경험을 시나리오로 기록

---

## 1. 처음 접속

웹 브라우저에서 IR Deck 평가 페이지에 접속했다. 로그인은 필요 없었다.

화면 구성:
- 좌측: 사이드바 (접기/펼치기 가능, "새 채팅" 버튼)
- 중앙: 빈 채팅 화면
  - 상단: "IR Deck 평가 시작하기" 큰 제목
  - 중앙: 설명 문구 "PDF 파일을 업로드하면 Sequoia Capital의 10가지 스토리 기준으로 평가합니다"
  - 버튼: "PDF 업로드" 버튼 (업로드 아이콘 포함)
  - 하단: 4개의 예시 질문 카드 2x2 그리드 배치
    - "이 IR Deck의 강점은 무엇인가요?"
    - "어떤 부분을 개선하면 좋을까요?"
    - "Sequoia Capital 기준으로 몇 점인가요?"
    - "페이지별 평가를 자세히 알려주세요."

## 2. 파일 업로드

"PDF 업로드" 버튼을 클릭했다. 파일 선택 다이얼로그가 열렸다. IR Deck PDF 파일을 선택했다.

**업로드 진행 상황**:
- 파일 정보가 입력창 위에 카드 형태로 나타남
- 파일명, 크기가 표시됨
- 진행률 바가 0%에서 시작해 자동으로 증가함 (약 90%까지)
- 업로드 완료 시 100%가 되고 "업로드 완료" 메시지 표시

**업로드 완료 후**:
- 파일 카드가 입력창 위에 계속 표시됨 (X 버튼으로 제거 가능)
- 파일 카드 아래에 4개의 추천 질문 버튼이 나타남:
  - "이 IR Deck 평가해줘"
  - "이 기업의 강점과 약점은?"
  - "Sequoia Capital 기준으로 어떻게 평가되나요?"
  - "개선이 필요한 부분은?"

## 3. 평가 시작

**방법 1: 추천 질문 클릭**
- 추천 질문 버튼 중 하나를 클릭
- 자동으로 평가가 시작됨

**방법 2: 직접 질문 입력**
- 입력창에 직접 질문 입력
- 전송 버튼 클릭

**분기점**: 
- 파일 없이 질문만 입력하면 → "파일이 없습니다. IR Deck을 업로드한 후 질문해주세요." 메시지 표시

## 4. 평가 진행 중

화면 변화:
- 입력창 위의 파일 카드와 추천 질문 버튼이 사라짐
- 사용자 메시지가 채팅 영역에 표시됨

**진행 상황 표시** (실시간 업데이트):
- 원형 진행률 표시기와 함께 단계별 메시지:
  - [원형 진행률 30%] **로빙중** : 로빙이 텍스트를 추출하고 있어요...
  - [원형 진행률 60%] **로빙중** : 로빙이 페이지를 분석하고 있어요...
  - [원형 진행률 90%] **로빙중** : 로빙이 종합 평가를 하고 있어요...
- 원형 진행률이 0%에서 100%로 증가하면서 각 단계별 메시지가 실시간으로 업데이트됨

**분기점**:
- 평가 성공 → 결과 표시
- 평가 실패 → 에러 메시지 표시
  - "평가 처리 중 오류가 발생했습니다." (서버 오류)
  - "평가 시작 실패: 500 Internal Server Error" (서버 에러)
  - "분석 시간이 초과되었습니다." (3분 타임아웃)
  - "네트워크 연결을 확인해주세요." (연결 실패)
  - "죄송합니다. 오류가 발생했습니다." (알 수 없는 오류)

## 5. 평가 결과 표시

평가 완료 후 채팅 영역에 결과가 마크다운 형태로 표시됨.

**UI 디자인**:
- ChatGPT 스타일: 버블 형태가 아닌 자유 흐름 텍스트로 전체 너비 활용
- 마크다운 렌더링: 헤더(##, ###), 리스트, 굵게, 이탤릭 등 자동 포맷팅
- 여백과 줄 간격으로 가독성 확보
- 자연스러운 텍스트 흐름 유지

**표시 순서**:
1. 설명 문구: "아래 평가는 업로드된 IR Deck 전체를 페이지 단위로 읽고..."
2. 종합 평가 섹션 (## 헤더):
   - 종합 점수: 85점 (큰 숫자로 강조)
   - 등급: A (색상 배지 인라인 표시)
3. 페이지별 분석 섹션 (### 헤더로 각 페이지 구분):
   - 페이지 번호: "3p" (헤더 형태)
   - 잘된 점: 리스트 형태 (마크다운 - )
   - 아쉬운 점: 리스트 형태 (마크다운 - )
   - **점수는 표시되지 않음**

## 6. 추가 질문

평가 결과를 확인한 후, 더 궁금한 점이 있으면 추가 질문을 할 수 있다.

**질문 방법**:
- 입력창에 질문 입력 후 전송 버튼 클릭
- 예시 질문:
  - "시장 기회는 어떤가?"
  - "경쟁 우위는 무엇인가?"
  - "3페이지에서 언급한 시장 규모 데이터를 더 자세히 설명해줘"
  - "재무 모델의 타당성은?"
  - "이 기업의 투자 가치는?"

**답변 생성 방식**:
- 평가 결과 컨텍스트 포함 (종합 점수, 등급, 페이지별 평가 요약)
- IR Deck 문서의 관련 부분을 RAG로 검색하여 포함
- 평가 결과와 문서 내용을 바탕으로 종합적인 답변 생성

**답변 표시**:
- ChatGPT 스타일로 마크다운 형태로 표시
- 버블 형태가 아닌 자유 흐름 텍스트
- 필요시 리스트, 헤더, 강조 표시 등 자동 포맷팅

**사용자 목표**: 
- 평가 결과에서 궁금한 부분에 대한 추가 설명
- 특정 페이지나 주제에 대한 심화 분석
- IR Deck의 특정 부분에 대한 전문가 의견

## 7. 피드백 제공

평가 결과나 추가 질문에 대한 답변을 확인한 후, 피드백을 제공할 수 있다.

**피드백 버튼 위치**:
- Assistant 메시지(평가 결과, 답변)에 마우스를 올리면 표시됨
- 메시지 우측 하단에 버튼들이 나타남:
  - 복사 버튼 (메시지 내용 복사)
  - 좋아요 버튼 (ThumbsUp 아이콘)
  - 싫어요 버튼 (ThumbsDown 아이콘)
  - 타임스탬프 (메시지 시간)

**피드백 방법**:
- 좋아요: 평가 결과나 답변이 도움이 되었을 때 클릭
- 싫어요: 평가 결과나 답변이 부정확하거나 도움이 되지 않았을 때 클릭
- 클릭 시 즉시 피드백이 저장됨 (추가 입력 불필요)

**피드백 목적**:
- 로빙의 평가 정확도 개선 (베이지안 학습)
- 예측 등급과 사용자 피드백 비교를 통한 모델 개선
- 향후 더 정확한 평가를 위한 학습 데이터 수집

**피드백 제공 시점**:
- 평가 결과 확인 후 즉시
- 추가 질문에 대한 답변 확인 후
- 여러 번 피드백 가능 (각 메시지별로 독립적)

---

## 행동 분기점 정리

1. **파일 없이 질문 입력** 
   - 에러 메시지: "파일이 없습니다. IR Deck을 업로드한 후 질문해주세요."

2. **파일 업로드 실패**
   - 에러 메시지: 
     - "PDF 파일만 업로드 가능합니다." (PDF가 아닌 파일 선택 시)
     - "파일 업로드 중 오류가 발생했습니다." (서버 오류)
     - "파일 업로드에 실패했습니다." (일반 업로드 실패)
   - 화면: 파일 카드에 빨간 X 아이콘과 "업로드 실패" 메시지 표시

3. **평가 중 에러 발생**
   - 에러 메시지:
     - "평가 처리 중 오류가 발생했습니다." (서버 오류)
     - "평가 시작 실패: 500 Internal Server Error" (서버 에러)
     - "분석 시간이 초과되었습니다." (3분 타임아웃)
     - "네트워크 연결을 확인해주세요." (연결 실패)
     - "죄송합니다. 오류가 발생했습니다." (알 수 없는 오류)
   - 화면: 채팅 영역에 에러 메시지가 표시됨

## 사용자 목표

IR Deck을 개선하기 위해:
- 종합 점수/등급으로 전반적 품질 파악
- 페이지별 잘된 점/아쉬운 점으로 구체적 개선 방향 파악
- 추가 질문으로 특정 부분 심화 분석