From f4731c4790b0b351ec49c207b94a5f1766458c4f Mon Sep 17 00:00:00 2001 From: happybell80 Date: Mon, 1 Dec 2025 12:40:26 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20IR=20Deck=20=ED=8F=89=EA=B0=80=20?= =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=EB=B3=84=20=EB=82=B4=EC=9A=A9=20?= =?UTF-8?q?=ED=91=9C=EC=8B=9C=20=EC=95=88=EB=90=A8=20=EB=AC=B8=EC=A0=9C=20?= =?UTF-8?q?=EA=B8=B0=EB=A1=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...aluation_page_evaluations_not_displayed.md | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 journey/troubleshooting/251201_ir_valuation_page_evaluations_not_displayed.md 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`: 빈 배열일 때 안내 메시지 표시 +- 데이터 구조 검증 로직 추가 + +## 교훈 + +- 평가 결과 표시 전 백엔드 응답 구조 검증 필수 +- 빈 배열/누락 데이터에 대한 폴백 처리 필요 +- 사용자에게 명확한 안내 메시지 제공 +