# 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 기준으로 어떻게 평가되나요?"
  - "개선이 필요한 부분은?"

**분기점: 중복 파일 처리**
- **같은 파일 재업로드 (동일한 파일 해시)**:
  - 백엔드에서 기존 document_id를 즉시 반환 (멱등성 보장)
  - 파일 저장/처리 과정 없이 업로드가 빠르게 완료됨
  - 프론트엔드는 정상적으로 "업로드 완료" 표시
  - 추천 질문 버튼이 나타나며 바로 평가 시작 가능
  - 사용자 입장에서는 일반 업로드와 동일한 경험

- **수정된 파일 업로드 (같은 파일명, 다른 파일 해시)**:
  - 백엔드에서 새로운 파일로 인식하여 정상적으로 업로드 및 처리
  - 텍스트 추출, 임베딩, 인덱싱 과정 진행
  - 새로운 document_id가 생성됨
  - 프론트엔드는 정상적으로 "업로드 완료" 표시 후 평가 가능

## 3. 평가 시작

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

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

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

## 4. 평가 진행 중

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

**진행 상황 표시** (실시간 업데이트):
- 스피너와 함께 단계별 메시지:
  - **로빙중** : 로빙이 텍스트를 추출하고 있어요...
  - **로빙중** : 로빙이 페이지를 분석하고 있어요...
  - **로빙중** : 로빙이 종합 평가를 하고 있어요...
- 각 단계별 메시지가 실시간으로 업데이트됨

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

## 5. 평가 결과 표시

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

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

**표시 순서** (목표 ChatGPT 형식):
1. 설명 문구: "아래 평가는 업로드된 IR Deck 전체를 페이지 단위로 읽고..."
2. **1. 투자 종합 점수 및 등급** 섹션 (## 헤더):
   - 항목별 점수 표 (마크다운 테이블):
     - 혁신성: XX/30점
     - 시장성: XX/25점
     - 팀 경쟁력: XX/15점
     - 사업 구조 안정성: XX/15점
     - 리스크 관리 및 실행력: XX/10점
     - 확장성 및 글로벌화: XX/10점
   - 총점: XX/100점
   - 투자 등급: S/A/B/C (최상위 투자 가치 보유)
3. **2. 장표별 장점과 개선점 요약** 섹션 (## 헤더):
   - 각 페이지별로 (### 헤더로 구분):
     - 페이지 번호: "[p.X] 페이지 제목"
     - **장점**: 리스트 형태 (마크다운 - )
     - **개선점**: 리스트 형태 (마크다운 - )
   - **페이지별 점수는 표시되지 않음**
4. **3. 종합 결론** 섹션 (## 헤더):
   - 요약 문단
   - 투자 종합 의견:
     - 등급, 총점
     - 권고 사항
     - 핵심 리스크
     - 핵심 강점

## 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분 타임아웃)
     - "네트워크 연결을 확인해주세요." (연결 실패)
     - "죄송합니다. 오류가 발생했습니다." (알 수 없는 오류)
   - 화면: 채팅 영역에 에러 메시지가 표시됨

4. **중복 파일 재업로드**
   - 백엔드 동작: 파일 해시(SHA256)로 중복 체크, 동일 파일 발견 시 기존 document_id 즉시 반환
   - 사용자 경험: 일반 업로드와 동일 (진행률 바, 완료 메시지 등)
   - 차이점: 실제 파일 저장/처리 과정 없이 더 빠르게 완료 (사용자는 인지하지 못함)
   - 평가 가능: 기존 document_id로 바로 평가 시작 가능

5. **수정된 파일 업로드**
   - 백엔드 동작: 파일 해시가 다르므로 새로운 파일로 인식, 정상적으로 업로드 및 처리
   - 사용자 경험: 일반 업로드와 동일
   - 평가 가능: 새로운 document_id로 평가 시작

## 사용자 목표

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