diff --git a/journey/troubleshooting/251201_ir_valuation_page_evaluations_not_displayed.md b/journey/troubleshooting/251201_ir_valuation_page_evaluations_not_displayed.md new file mode 100644 index 0000000..8e1b80b --- /dev/null +++ b/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`: 빈 배열일 때 안내 메시지 표시 +- 데이터 구조 검증 로직 추가 + +## 교훈 + +- 평가 결과 표시 전 백엔드 응답 구조 검증 필수 +- 빈 배열/누락 데이터에 대한 폴백 처리 필요 +- 사용자에게 명확한 안내 메시지 제공 +