docs: IR Deck 평가 페이지별 내용 표시 안됨 문제 기록

journey/troubleshooting/251201_ir_valuation_page_evaluations_not_displayed.md

@@ -0,0 +1,47 @@
+# IR Deck 평가 페이지별 내용 표시 안됨
+
+**날짜**: 2025-12-01  
+**작성자**: Auto  
+**관련 파일**:
+- `frontend-ir-valuation/src/pages/ir-valuation.tsx`
+- `rb8001/app/services/ir_deck_analyzer.py`
+
+---
+
+## 문제 상황
+
+평가 결과에서 종합 점수와 등급은 표시되지만, 페이지별 평가 내용(강점/약점)이 표시되지 않음.
+
+**증상**:
+- "1. 페이지별 잘된 점 / 아쉬운 점" 섹션 제목만 표시
+- "아래는 핵심 페이지 중심으로 평가했습니다." 설명만 표시
+- 실제 페이지별 평가 내용(페이지 번호, 강점, 약점, 점수) 없음
+
+## 원인 분석
+
+### 가능한 원인
+1. **백엔드 데이터 문제**: `page_evaluations` 배열이 비어 있거나 누락
+2. **프론트엔드 렌더링 문제**: `formatEvaluationResult()` 함수가 빈 배열 처리 미흡
+3. **데이터 구조 불일치**: 백엔드 응답과 프론트엔드 기대 형식 불일치
+
+### 확인 필요
+- 백엔드 응답에 `page_evaluations` 배열 포함 여부
+- `ir-valuation.tsx:275-294`의 `formatEvaluationResult()` 함수 로직
+- 빈 배열일 때 폴백 메시지 표시 여부
+
+## 해결 방안
+
+### 1. 백엔드 응답 확인
+- `/rb8001/api/ir-deck/evaluation/{evaluation_id}` 응답 구조 확인
+- `page_evaluations` 배열이 실제로 포함되어 있는지 검증
+
+### 2. 프론트엔드 처리 개선
+- `ir-valuation.tsx:275-294`: 빈 배열일 때 안내 메시지 표시
+- 데이터 구조 검증 로직 추가
+
+## 교훈
+
+- 평가 결과 표시 전 백엔드 응답 구조 검증 필수
+- 빈 배열/누락 데이터에 대한 폴백 처리 필요
+- 사용자에게 명확한 안내 메시지 제공
+