Add scenarios folder and IR Deck evaluation user scenario

README.md

@@ -71,6 +71,7 @@
 - [아키텍처 문서](./300_architecture/)
 - [연구 자료](./research/README.md)
 - [IR 자료](./IR/)
+- [사용자 시나리오](./journey/scenarios/) - 사용자 경험 중심의 기능 시나리오
 - [Journey: 개발 여정 인덱스](./journey/README.md)
 
 ### 번호 체계

journey/README.md

@@ -1,13 +1,14 @@
 # Journey: 개발 여정 인덱스
 
 이 폴더는 로빙 프로젝트의 **개발 여정**을 모아서 보는 인덱스입니다.  
-원본 문서는 그대로 `troubleshooting/`, `ideas/`, `plans/`, `research/`에 두고, 여기서는 “어떤 여정에서 어떤 문서를 참고해야 하는지”만 정리합니다.
+원본 문서는 그대로 `troubleshooting/`, `ideas/`, `plans/`, `research/`에 두고, 여기서는 "어떤 여정에서 어떤 문서를 참고해야 하는지"만 정리합니다.
 
 ## 구성
 
 - `troubleshooting_journey.md` – 사건/장애 중심의 여정
 - `ideas_and_plans_journey.md` – 아이디어·계획·실행 기록
 - `research_journey.md` – 논문·실험 기반 개선 여정
+- `scenarios/` – 사용자 경험 중심의 기능 시나리오 (UX)
 
 각 파일에서 관련 문서를 링크로만 참조합니다.
 

journey/scenarios/ir_deck_evaluation_scenario.md

@@ -0,0 +1,181 @@
+# 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을 개선하기 위해:
+- 종합 점수/등급으로 전반적 품질 파악
+- 페이지별 잘된 점/아쉬운 점으로 구체적 개선 방향 파악
+- 추가 질문으로 특정 부분 심화 분석