Docs: IR Valuation frontend setup troubleshooting

journey/troubleshooting/251201_ir_valuation_frontend_setup.md

@@ -0,0 +1,98 @@
+# IR Deck 평가 프론트엔드 초기 설정
+
+**날짜**: 2025-12-01  
+**작성자**: Claude (AI)  
+**관련 파일**: 
+- `frontend-ir-valuation/src/pages/ir-valuation.tsx`
+- `nginx-infra/server-nginx-default`
+- `https://git.ro-being.com/ivada_Ro-being/frontend-ir-valuation.git`
+
+---
+
+## 목적
+
+Sequoia Capital IR 공식 기준으로 IR Deck을 평가하는 프론트엔드 페이지 구축. ChatGPT 스타일 UI로 PDF 업로드 및 분석 결과 표시.
+
+## 구현 내용
+
+### 1. 프로젝트 생성
+
+**기술 스택**: frontend-customer와 동일
+- Vite + React + TypeScript
+- TailwindCSS
+- wouter (라우팅)
+- @tanstack/react-query
+
+**프로젝트 위치**: `/home/admin/frontend-ir-valuation`
+
+### 2. 주요 기능
+
+**파일**: `src/pages/ir-valuation.tsx`
+
+- ChatGPT 스타일 채팅 인터페이스
+- PDF 파일 업로드 (드래그 앤 드롭 또는 버튼 클릭)
+- 업로드 진행률 표시
+- 분석 중 상태 표시
+- 페이지별 평가 결과 표시 (잘된 점/부족한 점)
+- 종합 점수 및 등급 (S/A/B/C) 표시
+
+### 3. nginx 설정
+
+**파일**: `nginx-infra/server-nginx-default:91-95, 228-232`
+
+```nginx
+# IR Valuation Frontend
+location /ir-valuation {
+    alias /home/admin/frontend-ir-valuation/dist/;
+    try_files $uri /ir-valuation/index.html;
+}
+```
+
+### 4. Git 저장소
+
+**저장소**: `https://git.ro-being.com/ivada_Ro-being/frontend-ir-valuation.git`
+
+**초기 커밋**: `8235e25` - Initial commit: IR Deck valuation frontend with ChatGPT-style UI
+
+## 배포
+
+### 빌드
+```bash
+cd /home/admin/frontend-ir-valuation
+npm run build
+```
+
+### nginx 배포
+```bash
+sudo cp /home/admin/nginx-infra/server-nginx-default /etc/nginx/sites-enabled/default
+sudo systemctl reload nginx
+```
+
+### 접근 경로
+- `http://ro-being.com/ir-valuation`
+- `http://124.55.18.179/ir-valuation`
+
+## 다음 단계
+
+1. **백엔드 연동**: rb8001 API 엔드포인트 구현
+   - `/rb8001/api/ir-deck/upload` - PDF 업로드
+   - `/rb8001/api/ir-deck/chat` - 채팅 응답
+   - `/rb8001/api/ir-deck/evaluate` - 평가 결과 조회
+
+2. **실제 분석 로직**: Sequoia Capital 10가지 스토리 기준 평가
+   - 페이지별 분석
+   - 점수 계산
+   - 등급 분류 (베이지안 학습 준비)
+
+3. **베이지안 학습**: 피드백 수집 및 학습 데이터 구성
+
+## 교훈
+
+- frontend-customer 구조를 참고하여 빠르게 프로젝트 생성 가능
+- nginx 설정은 두 서버 블록(HTTP/HTTPS) 모두에 추가 필요
+- 빌드 산출물은 `/home/admin/frontend-ir-valuation/dist/`에 저장
+
+---
+
+문서 규칙: `DOCS/book/300_architecture/312_문서_작성_원칙.md` 준수
+