From d2635bfeabb61c526665c0011ffee03c8e996375 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Mon, 1 Dec 2025 17:26:18 +0900 Subject: [PATCH] Add scenarios folder and IR Deck evaluation user scenario --- README.md | 1 + journey/README.md | 3 +- .../scenarios/ir_deck_evaluation_scenario.md | 181 ++++++++++++++++++ 3 files changed, 184 insertions(+), 1 deletion(-) create mode 100644 journey/scenarios/ir_deck_evaluation_scenario.md diff --git a/README.md b/README.md index f08b15b..4156e2e 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,7 @@ - [아키텍처 문서](./300_architecture/) - [연구 자료](./research/README.md) - [IR 자료](./IR/) +- [사용자 시나리오](./journey/scenarios/) - 사용자 경험 중심의 기능 시나리오 - [Journey: 개발 여정 인덱스](./journey/README.md) ### 번호 체계 diff --git a/journey/README.md b/journey/README.md index fc83a9a..016e378 100644 --- a/journey/README.md +++ b/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) 각 파일에서 관련 문서를 링크로만 참조합니다. diff --git a/journey/scenarios/ir_deck_evaluation_scenario.md b/journey/scenarios/ir_deck_evaluation_scenario.md new file mode 100644 index 0000000..96722ce --- /dev/null +++ b/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을 개선하기 위해: +- 종합 점수/등급으로 전반적 품질 파악 +- 페이지별 잘된 점/아쉬운 점으로 구체적 개선 방향 파악 +- 추가 질문으로 특정 부분 심화 분석