DOCS/journey/scenarios/ir_deck_evaluation_scenario.md

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을 개선하기 위해:

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