ivada-infra/DOCS

Fork 0

Claude-51124 81d524390b docs: IR Deck 평가 UX 시나리오 문서 추가

2025-11-29 21:34:39 +09:00

4.2 KiB

Raw Blame History

IR Deck 평가 UX 시나리오

작성일: 2025-11-30
관련 문서:

목적

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 테스트 가능
코드 수정 없이 프롬프트 개선 및 버전 관리

참고

Sequoia Capital 10가지 스토리: 문제 정의, 시장 기회, 솔루션, 제품/서비스, 비즈니스 모델, 경쟁 우위, 팀, 트랙션, 재무, 비전
평가 기준: IR Deck 평가 백엔드 아키텍처 참고

4.2 KiB Raw Blame History