From 2e72f8fad90ab3365fa8047543733ed3e82661eb Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Mon, 1 Dec 2025 20:50:56 +0900 Subject: [PATCH] Add IR Deck page splitting improvement documentation --- .../scenarios/ir_deck_evaluation_scenario.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/journey/scenarios/ir_deck_evaluation_scenario.md b/journey/scenarios/ir_deck_evaluation_scenario.md index 96722ce..28095bd 100644 --- a/journey/scenarios/ir_deck_evaluation_scenario.md +++ b/journey/scenarios/ir_deck_evaluation_scenario.md @@ -39,6 +39,20 @@ - "Sequoia Capital 기준으로 어떻게 평가되나요?" - "개선이 필요한 부분은?" +**분기점: 중복 파일 처리** +- **같은 파일 재업로드 (동일한 파일 해시)**: + - 백엔드에서 기존 document_id를 즉시 반환 (멱등성 보장) + - 파일 저장/처리 과정 없이 업로드가 빠르게 완료됨 + - 프론트엔드는 정상적으로 "업로드 완료" 표시 + - 추천 질문 버튼이 나타나며 바로 평가 시작 가능 + - 사용자 입장에서는 일반 업로드와 동일한 경험 + +- **수정된 파일 업로드 (같은 파일명, 다른 파일 해시)**: + - 백엔드에서 새로운 파일로 인식하여 정상적으로 업로드 및 처리 + - 텍스트 추출, 임베딩, 인덱싱 과정 진행 + - 새로운 document_id가 생성됨 + - 프론트엔드는 정상적으로 "업로드 완료" 표시 후 평가 가능 + ## 3. 평가 시작 **방법 1: 추천 질문 클릭** @@ -173,6 +187,17 @@ - "죄송합니다. 오류가 발생했습니다." (알 수 없는 오류) - 화면: 채팅 영역에 에러 메시지가 표시됨 +4. **중복 파일 재업로드** + - 백엔드 동작: 파일 해시(SHA256)로 중복 체크, 동일 파일 발견 시 기존 document_id 즉시 반환 + - 사용자 경험: 일반 업로드와 동일 (진행률 바, 완료 메시지 등) + - 차이점: 실제 파일 저장/처리 과정 없이 더 빠르게 완료 (사용자는 인지하지 못함) + - 평가 가능: 기존 document_id로 바로 평가 시작 가능 + +5. **수정된 파일 업로드** + - 백엔드 동작: 파일 해시가 다르므로 새로운 파일로 인식, 정상적으로 업로드 및 처리 + - 사용자 경험: 일반 업로드와 동일 + - 평가 가능: 새로운 document_id로 평가 시작 + ## 사용자 목표 IR Deck을 개선하기 위해: