Update app.py

app.py

@@ -926,6 +926,156 @@ def validate_questions(questions: List[Dict], page_contents: List[PageContent],
     
     return validated
 
+# ============================================================
+# Enhanced Explanation Generation using GROQ API
+# ============================================================
+def enhance_explanations(
+    questions: List[Dict],
+    page_contents: List[PageContent],
+    language: str
+) -> List[Dict]:
+    """
+    GROQ API를 사용하여 각 문제에 대한 상세한 논리적 설명을 생성
+    - 정답의 논리적 근거
+    - 관련 핵심 개념 및 팩트
+    - 오답별 구체적인 오류 설명
+    - 학습 포인트
+    """
+    
+    print(f"\n🧠 [설명 강화] {len(questions)}개 문제에 대한 상세 설명 생성 중...")
+    
+    # 문서 컨텍스트 준비
+    full_text = "\n\n".join([f"[Page {p.page_num}]\n{p.text}" for p in page_contents])
+    doc_context = full_text[:8000]  # 컨텍스트 제한
+    
+    enhanced_questions = []
+    
+    for i, q in enumerate(questions):
+        try:
+            print(f"  📝 문제 {i+1}/{len(questions)} 설명 강화 중...")
+            
+            # 해당 문제의 소스 페이지 컨텍스트 찾기
+            source_page = q.get('source_page', 1)
+            relevant_context = ""
+            for p in page_contents:
+                if p.page_num == source_page:
+                    relevant_context = p.text[:2000]
+                    break
+            
+            if not relevant_context:
+                relevant_context = doc_context[:2000]
+            
+            if language == "한국어":
+                prompt = f"""당신은 교육 전문가입니다. 다음 시험 문제에 대해 상세하고 논리적인 설명을 작성하세요.
+
+📚 관련 문서 내용 (페이지 {source_page}):
+{relevant_context}
+
+📋 문제:
+{q['question']}
+
+📝 선택지:
+{chr(10).join(q['options'])}
+
+✅ 정답: {q['answer']}
+
+다음 JSON 형식으로만 응답하세요:
+{{
+    "detailed_explanation": "정답이 맞는 이유에 대한 3-5문장의 상세한 논리적 설명. 문서의 구체적인 내용을 인용하여 설명.",
+    "key_facts": ["관련 핵심 팩트 1", "관련 핵심 팩트 2", "관련 핵심 팩트 3"],
+    "wrong_explanations": {{
+        "A": "A가 오답인 구체적 이유 (정답이면 빈 문자열)",
+        "B": "B가 오답인 구체적 이유 (정답이면 빈 문자열)",
+        "C": "C가 오답인 구체적 이유 (정답이면 빈 문자열)",
+        "D": "D가 오답인 구체적 이유 (정답이면 빈 문자열)",
+        "E": "E가 오답인 구체적 이유 (정답이면 빈 문자열)"
+    }},
+    "learning_point": "이 문제를 통해 학습해야 할 핵심 포인트 1-2문장",
+    "related_concepts": ["관련 개념 1", "관련 개념 2"]
+}}
+
+중요: 추측하지 말고 문서 내용을 기반으로 팩트에 근거한 설명을 작성하세요."""
+            else:
+                prompt = f"""You are an education expert. Write detailed, logical explanations for the following exam question.
+
+📚 Relevant Document Content (Page {source_page}):
+{relevant_context}
+
+📋 Question:
+{q['question']}
+
+📝 Options:
+{chr(10).join(q['options'])}
+
+✅ Correct Answer: {q['answer']}
+
+Respond ONLY in JSON format:
+{{
+    "detailed_explanation": "3-5 sentence detailed logical explanation of why the answer is correct. Quote specific content from the document.",
+    "key_facts": ["Key fact 1", "Key fact 2", "Key fact 3"],
+    "wrong_explanations": {{
+        "A": "Specific reason why A is wrong (empty string if correct)",
+        "B": "Specific reason why B is wrong (empty string if correct)",
+        "C": "Specific reason why C is wrong (empty string if correct)",
+        "D": "Specific reason why D is wrong (empty string if correct)",
+        "E": "Specific reason why E is wrong (empty string if correct)"
+    }},
+    "learning_point": "1-2 sentence key learning point from this question",
+    "related_concepts": ["Related concept 1", "Related concept 2"]
+}}
+
+IMPORTANT: Do not speculate. Base explanations on facts from the document."""
+
+            completion = client.chat.completions.create(
+                model="openai/gpt-oss-120b",
+                messages=[{"role": "user", "content": prompt}],
+                temperature=0.3,
+                max_completion_tokens=2048,
+                top_p=1,
+            )
+            
+            response = completion.choices[0].message.content
+            if response is None:
+                response = ""
+            response = response.strip()
+            
+            # JSON 파싱
+            if "```json" in response:
+                response = response.split("```json")[1].split("```")[0]
+            elif "```" in response:
+                response = response.split("```")[1].split("```")[0]
+            
+            enhanced_data = json.loads(response.strip())
+            
+            # 기존 explanation 업데이트
+            if 'explanation' not in q:
+                q['explanation'] = {}
+            
+            q['explanation']['detailed_explanation'] = enhanced_data.get('detailed_explanation', '')
+            q['explanation']['key_facts'] = enhanced_data.get('key_facts', [])
+            q['explanation']['learning_point'] = enhanced_data.get('learning_point', '')
+            q['explanation']['related_concepts'] = enhanced_data.get('related_concepts', [])
+            
+            # 오답 설명 업데이트
+            wrong_expl = enhanced_data.get('wrong_explanations', {})
+            for letter in ['A', 'B', 'C', 'D', 'E']:
+                if wrong_expl.get(letter):
+                    q['explanation'][f'wrong_{letter}'] = wrong_expl[letter]
+            
+            # 기존 correct_reason이 없거나 짧으면 업데이트
+            if not q['explanation'].get('correct_reason') or len(q['explanation'].get('correct_reason', '')) < 50:
+                q['explanation']['correct_reason'] = enhanced_data.get('detailed_explanation', q['explanation'].get('correct_reason', ''))
+            
+            enhanced_questions.append(q)
+            
+        except Exception as e:
+            print(f"  ⚠️ 문제 {i+1} 설명 강화 실패: {e}")
+            enhanced_questions.append(q)  # 원본 유지
+    
+    print(f"✅ 설명 강화 완료: {len(enhanced_questions)}개 문제")
+    return enhanced_questions
+
+
 # ============================================================
 # PDF Generation
 # ============================================================
@@ -1009,7 +1159,7 @@ def create_exam_pdf(questions: List[Dict], language: str) -> str:
     return temp_file.name
 
 def create_answer_pdf(questions: List[Dict], language: str) -> str:
-    """Create answer key PDF with explanations"""
+    """Create answer key PDF with enhanced explanations"""
     
     lang = LANG_TEXT[language]
     
@@ -1037,7 +1187,8 @@ def create_answer_pdf(questions: List[Dict], language: str) -> str:
         fontSize=11,
         spaceAfter=8,
         textColor=colors.HexColor('#1F2937'),
-        fontName=font_name
+        fontName=font_name,
+        leading=14
     )
     
     answer_style = ParagraphStyle(
@@ -1046,7 +1197,9 @@ def create_answer_pdf(questions: List[Dict], language: str) -> str:
         fontSize=11,
         leftIndent=15,
         textColor=colors.HexColor('#059669'),
-        fontName=font_name
+        fontName=font_name,
+        spaceBefore=5,
+        spaceAfter=5
     )
     
     explanation_style = ParagraphStyle(
@@ -1056,7 +1209,43 @@ def create_answer_pdf(questions: List[Dict], language: str) -> str:
         leftIndent=15,
         spaceAfter=5,
         textColor=colors.HexColor('#374151'),
-        fontName=font_name
+        fontName=font_name,
+        leading=13
+    )
+    
+    detailed_style = ParagraphStyle(
+        'DetailedExplanation',
+        parent=styles['Normal'],
+        fontSize=10,
+        leftIndent=15,
+        spaceAfter=8,
+        textColor=colors.HexColor('#1E40AF'),
+        fontName=font_name,
+        leading=14,
+        backColor=colors.HexColor('#EFF6FF'),
+        borderPadding=8
+    )
+    
+    fact_style = ParagraphStyle(
+        'KeyFact',
+        parent=styles['Normal'],
+        fontSize=9,
+        leftIndent=25,
+        spaceAfter=3,
+        textColor=colors.HexColor('#065F46'),
+        fontName=font_name,
+        bulletIndent=15
+    )
+    
+    learning_style = ParagraphStyle(
+        'LearningPoint',
+        parent=styles['Normal'],
+        fontSize=10,
+        leftIndent=15,
+        spaceAfter=5,
+        textColor=colors.HexColor('#7C3AED'),
+        fontName=font_name,
+        leading=13
     )
     
     wrong_style = ParagraphStyle(
@@ -1065,7 +1254,8 @@ def create_answer_pdf(questions: List[Dict], language: str) -> str:
         fontSize=9,
         leftIndent=25,
         textColor=colors.HexColor('#DC2626'),
-        fontName=font_name
+        fontName=font_name,
+        leading=12
     )
     
     normal_korean = ParagraphStyle(
@@ -1080,12 +1270,25 @@ def create_answer_pdf(questions: List[Dict], language: str) -> str:
         fontName=font_name
     )
     
+    subheading_style = ParagraphStyle(
+        'SubHeading',
+        parent=styles['Normal'],
+        fontSize=10,
+        leftIndent=15,
+        spaceBefore=8,
+        spaceAfter=5,
+        textColor=colors.HexColor('#1F2937'),
+        fontName=font_name,
+        fontWeight='bold'
+    )
+    
     story = []
     
     story.append(Paragraph(f"{lang['pdf_answer_title']}", title_style))
     story.append(Paragraph(f"{lang['pdf_date']}: {datetime.now().strftime('%Y-%m-%d')}", normal_korean))
     story.append(Spacer(1, 20))
     
+    # Quick Answer Summary
     story.append(Paragraph(f"<b>{lang['pdf_quick_summary']}</b>", heading_korean))
     
     answer_summary = []
@@ -1116,31 +1319,97 @@ def create_answer_pdf(questions: List[Dict], language: str) -> str:
     story.append(Paragraph(f"<b>{lang['pdf_detailed']}</b>", heading_korean))
     story.append(Spacer(1, 15))
     
+    # Detailed explanations for each question
     for i, q in enumerate(questions, 1):
+        # Question text
         q_text = f"<b>Q{i}.</b> {q['question']}"
         story.append(Paragraph(q_text, question_style))
         
-        story.append(Paragraph(f"{lang['pdf_correct_answer']}: {q['answer']}", answer_style))
+        # Correct answer
+        story.append(Paragraph(f"<b>{lang['pdf_correct_answer']}:</b> {q['answer']}", answer_style))
         
-        story.append(Paragraph(f"{lang['pdf_source']} {q.get('source_page', 'N/A')}", explanation_style))
-        
-        if q.get('source_quote'):
-            quote_text = q['source_quote'][:200] + "..." if len(q.get('source_quote', '')) > 200 else q.get('source_quote', '')
-            story.append(Paragraph(f"{lang['pdf_reference']}: \"{quote_text}\"", explanation_style))
+        # Source page
+        story.append(Paragraph(f"<b>{lang['pdf_source']}:</b> {q.get('source_page', 'N/A')}", explanation_style))
         
         explanation = q.get('explanation', {})
-        if explanation.get('correct_reason'):
-            story.append(Paragraph(f"{lang['pdf_why_correct']}: {explanation['correct_reason']}", explanation_style))
         
+        # Detailed Explanation (NEW - Enhanced)
+        detailed_expl = explanation.get('detailed_explanation', '')
+        if detailed_expl:
+            if language == "한국어":
+                story.append(Paragraph("<b>📖 상세 설명:</b>", subheading_style))
+            else:
+                story.append(Paragraph("<b>📖 Detailed Explanation:</b>", subheading_style))
+            story.append(Paragraph(detailed_expl, detailed_style))
+        elif explanation.get('correct_reason'):
+            # Fallback to correct_reason if no detailed explanation
+            if language == "한국어":
+                story.append(Paragraph("<b>📖 정답 근거:</b>", subheading_style))
+            else:
+                story.append(Paragraph("<b>📖 Why Correct:</b>", subheading_style))
+            story.append(Paragraph(explanation['correct_reason'], detailed_style))
+        
+        # Key Facts (NEW)
+        key_facts = explanation.get('key_facts', [])
+        if key_facts:
+            if language == "한국어":
+                story.append(Paragraph("<b>📌 핵심 팩트:</b>", subheading_style))
+            else:
+                story.append(Paragraph("<b>📌 Key Facts:</b>", subheading_style))
+            for fact in key_facts[:5]:  # Limit to 5 facts
+                story.append(Paragraph(f"• {fact}", fact_style))
+        
+        # Learning Point (NEW)
+        learning_point = explanation.get('learning_point', '')
+        if learning_point:
+            if language == "한국어":
+                story.append(Paragraph("<b>💡 학습 포인트:</b>", subheading_style))
+            else:
+                story.append(Paragraph("<b>💡 Learning Point:</b>", subheading_style))
+            story.append(Paragraph(learning_point, learning_style))
+        
+        # Related Concepts (NEW)
+        related_concepts = explanation.get('related_concepts', [])
+        if related_concepts:
+            concepts_text = ", ".join(related_concepts[:5])
+            if language == "한국어":
+                story.append(Paragraph(f"<b>🔗 관련 개념:</b> {concepts_text}", explanation_style))
+            else:
+                story.append(Paragraph(f"<b>🔗 Related Concepts:</b> {concepts_text}", explanation_style))
+        
+        # Source Quote
+        if q.get('source_quote'):
+            quote_text = q['source_quote'][:300] + "..." if len(q.get('source_quote', '')) > 300 else q.get('source_quote', '')
+            if language == "한국어":
+                story.append(Paragraph(f"<b>📝 문서 인용:</b> \"{quote_text}\"", explanation_style))
+            else:
+                story.append(Paragraph(f"<b>📝 Document Quote:</b> \"{quote_text}\"", explanation_style))
+        
+        # Why Wrong Options (Enhanced)
         story.append(Spacer(1, 5))
-        story.append(Paragraph(f"<i>{lang['pdf_why_wrong']}</i>", explanation_style))
+        if language == "한국어":
+            story.append(Paragraph(f"<b><i>❌ 오답 분석:</i></b>", subheading_style))
+        else:
+            story.append(Paragraph(f"<b><i>❌ Why Other Options Are Wrong:</i></b>", subheading_style))
+        
+        has_wrong_explanations = False
+        for letter in ['A', 'B', 'C', 'D', 'E']:
+            wrong_key = f'wrong_{letter}'
+            if explanation.get(wrong_key) and explanation[wrong_key].strip():
+                has_wrong_explanations = True
+                story.append(Paragraph(f"<b>{letter}:</b> {explanation[wrong_key]}", wrong_style))
+        
+        if not has_wrong_explanations:
+            if language == "한국어":
+                story.append(Paragraph("(오답 설명 없음)", wrong_style))
+            else:
+                story.append(Paragraph("(No wrong answer explanations available)", wrong_style))
         
-        for key in ['wrong_A', 'wrong_B', 'wrong_C', 'wrong_D', 'wrong_E']:
-            if explanation.get(key) and explanation[key].strip():
-                letter = key.split('_')[1]
-                story.append(Paragraph(f"X {letter}: {explanation[key]}", wrong_style))
+        story.append(Spacer(1, 25))
         
-        story.append(Spacer(1, 20))
+        # Add page break every 3 questions to avoid cramped layout
+        if i % 3 == 0 and i < len(questions):
+            story.append(PageBreak())
     
     doc.build(story)
     return temp_file.name
@@ -1195,14 +1464,18 @@ def process_exam(
         if not validated:
             return lang["error_no_questions"], "", None, None, "", []
         
-        progress(0.85, desc=lang["phase_pdf"])
-        exam_pdf = create_exam_pdf(validated, language)
-        answer_pdf = create_answer_pdf(validated, language)
+        # NEW: Enhance explanations using GROQ API
+        progress(0.8, desc="🧠 Enhancing explanations..." if language == "English" else "🧠 설명 강화 중...")
+        enhanced = enhance_explanations(validated, page_contents, language)
+        
+        progress(0.9, desc=lang["phase_pdf"])
+        exam_pdf = create_exam_pdf(enhanced, language)
+        answer_pdf = create_answer_pdf(enhanced, language)
         
         progress(0.95, desc=lang["phase_final"])
         
         answer_distribution = {}
-        for q in validated:
+        for q in enhanced:
             label = q.get('correct_label', 'A')
             answer_distribution[label] = answer_distribution.get(label, 0) + 1
         
@@ -1213,11 +1486,12 @@ def process_exam(
 📁 File Type: {file_type_display}
 {'=' * 50}
 {lang['stats_title']}
-   • {lang['total_questions']}: {len(validated)}
+   • {lang['total_questions']}: {len(enhanced)}
    • {lang['choices_per_q']}: {num_choices}
    • {lang['difficulty']}: {difficulty}
    • {lang['doc_pages']}: {len(page_contents)}
    • Total Characters: {total_chars:,}
+   • 🧠 Enhanced Explanations: ✅
 {'=' * 50}
 {lang['answer_dist']}
    {dist_text}
@@ -1229,11 +1503,11 @@ def process_exam(
 
 🎯 Now go to "Take Exam" tab to start your interactive exam!"""
         
-        display_text = format_questions_display(validated, language)
+        display_text = format_questions_display(enhanced, language)
         
         progress(1.0, desc=lang["phase_complete"])
         
-        return info_log, display_text, exam_pdf, answer_pdf, "", validated
+        return info_log, display_text, exam_pdf, answer_pdf, "", enhanced
         
     except Exception as e:
         import traceback
@@ -1241,7 +1515,7 @@ def process_exam(
         return f"❌ Error: {str(e)}", "", None, None, "", []
 
 def format_questions_display(questions: List[Dict], language: str) -> str:
-    """Format questions for text display"""
+    """Format questions for text display with enhanced explanations"""
     
     lang = LANG_TEXT[language]
     
@@ -1261,7 +1535,22 @@ def format_questions_display(questions: List[Dict], language: str) -> str:
             else:
                 lines.append(f"   ○ {opt}")
         
-        lines.append(f"\n   💡 {q.get('explanation', {}).get('correct_reason', 'N/A')[:150]}...")
+        explanation = q.get('explanation', {})
+        
+        # Detailed explanation
+        detailed = explanation.get('detailed_explanation', explanation.get('correct_reason', 'N/A'))
+        lines.append(f"\n   📖 {detailed[:200]}{'...' if len(detailed) > 200 else ''}")
+        
+        # Key facts
+        key_facts = explanation.get('key_facts', [])
+        if key_facts:
+            lines.append(f"   📌 핵심 팩트: {', '.join(key_facts[:3])}" if language == "한국어" else f"   📌 Key Facts: {', '.join(key_facts[:3])}")
+        
+        # Learning point
+        learning_point = explanation.get('learning_point', '')
+        if learning_point:
+            lines.append(f"   💡 {learning_point[:150]}{'...' if len(learning_point) > 150 else ''}")
+        
         lines.append("-" * 60)
     
     return "\n".join(lines)
@@ -1939,19 +2228,77 @@ with gr.Blocks(fill_height=True, css=css, title="PDF/HWP TO EXAM | SOMA") as dem
         user_answers[current_idx] = selected_answer
         
         is_correct = selected_answer == q['answer']
+        explanation = q.get('explanation', {})
+        
+        # Get enhanced explanation content
+        detailed_expl = explanation.get('detailed_explanation', explanation.get('correct_reason', 'N/A'))
+        key_facts = explanation.get('key_facts', [])
+        learning_point = explanation.get('learning_point', '')
+        related_concepts = explanation.get('related_concepts', [])
         
         if is_correct:
             feedback_text = f"""## {lang['correct_feedback']}
 
-**{lang['explanation_label']}:** {q.get('explanation', {}).get('correct_reason', 'N/A')}"""
+**{lang['explanation_label']}:** {detailed_expl}"""
+            
+            # Add key facts if available
+            if key_facts:
+                if language == "한국어":
+                    feedback_text += "\n\n**📌 핵심 팩트:**"
+                else:
+                    feedback_text += "\n\n**📌 Key Facts:**"
+                for fact in key_facts[:3]:
+                    feedback_text += f"\n• {fact}"
+            
+            # Add learning point if available
+            if learning_point:
+                if language == "한국어":
+                    feedback_text += f"\n\n**💡 학습 포인트:** {learning_point}"
+                else:
+                    feedback_text += f"\n\n**💡 Learning Point:** {learning_point}"
         else:
+            # Get wrong answer explanation
+            selected_letter = selected_answer[0] if selected_answer else 'A'
+            wrong_reason = explanation.get(f'wrong_{selected_letter}', '')
+            
             feedback_text = f"""## {lang['incorrect_feedback']}
 
 **{lang['your_answer']}:** {selected_answer}
 
 **{lang['correct_answer_is']}:** {q['answer']}
 
-**{lang['explanation_label']}:** {q.get('explanation', {}).get('correct_reason', 'N/A')}"""
+**{lang['explanation_label']}:** {detailed_expl}"""
+            
+            # Add why the selected answer was wrong
+            if wrong_reason:
+                if language == "한국어":
+                    feedback_text += f"\n\n**❌ 선택한 답이 틀린 이유:** {wrong_reason}"
+                else:
+                    feedback_text += f"\n\n**❌ Why your answer was wrong:** {wrong_reason}"
+            
+            # Add key facts if available
+            if key_facts:
+                if language == "한국어":
+                    feedback_text += "\n\n**📌 핵심 팩트:**"
+                else:
+                    feedback_text += "\n\n**📌 Key Facts:**"
+                for fact in key_facts[:3]:
+                    feedback_text += f"\n• {fact}"
+            
+            # Add learning point if available
+            if learning_point:
+                if language == "한국어":
+                    feedback_text += f"\n\n**💡 학습 포인트:** {learning_point}"
+                else:
+                    feedback_text += f"\n\n**💡 Learning Point:** {learning_point}"
+        
+        # Add related concepts
+        if related_concepts:
+            concepts_text = ", ".join(related_concepts[:5])
+            if language == "한국어":
+                feedback_text += f"\n\n**🔗 관련 개념:** {concepts_text}"
+            else:
+                feedback_text += f"\n\n**🔗 Related Concepts:** {concepts_text}"
         
         return user_answers, gr.update(value=feedback_text, visible=True)
     
@@ -2018,6 +2365,7 @@ with gr.Blocks(fill_height=True, css=css, title="PDF/HWP TO EXAM | SOMA") as dem
         for i, q in enumerate(questions):
             user_answer = user_answers.get(i, None)
             is_correct = user_answer == q['answer']
+            explanation = q.get('explanation', {})
             
             if user_answer is None:
                 skipped_count += 1
@@ -2029,15 +2377,45 @@ with gr.Blocks(fill_height=True, css=css, title="PDF/HWP TO EXAM | SOMA") as dem
                 incorrect_count += 1
                 status = f"❌ {lang['incorrect_feedback']}"
             
-            review_lines.append(f"""
+            # Get enhanced explanation content
+            detailed_expl = explanation.get('detailed_explanation', explanation.get('correct_reason', 'N/A'))
+            key_facts = explanation.get('key_facts', [])
+            learning_point = explanation.get('learning_point', '')
+            
+            review_entry = f"""
 ---
-**{lang['question_review'].format(num=i+1)}:** {q['question'][:100]}{'...' if len(q['question']) > 100 else ''}
+**{lang['question_review'].format(num=i+1)}:** {q['question'][:150]}{'...' if len(q['question']) > 150 else ''}
 
 - **{lang['your_answer']}:** {user_answer or lang['not_answered']}
 - **{lang['correct_answer_is']}:** {q['answer']}
 - **Status:** {status}
-- **{lang['explanation_label']}:** {q.get('explanation', {}).get('correct_reason', 'N/A')[:200]}{'...' if len(q.get('explanation', {}).get('correct_reason', '')) > 200 else ''}
-""")
+- **{lang['explanation_label']}:** {detailed_expl[:300]}{'...' if len(detailed_expl) > 300 else ''}"""
+            
+            # Add why user's answer was wrong (if incorrect)
+            if user_answer and not is_correct:
+                selected_letter = user_answer[0] if user_answer else 'A'
+                wrong_reason = explanation.get(f'wrong_{selected_letter}', '')
+                if wrong_reason:
+                    if language == "한국어":
+                        review_entry += f"\n- **오답 이유:** {wrong_reason[:200]}{'...' if len(wrong_reason) > 200 else ''}"
+                    else:
+                        review_entry += f"\n- **Why Wrong:** {wrong_reason[:200]}{'...' if len(wrong_reason) > 200 else ''}"
+            
+            # Add key facts
+            if key_facts:
+                if language == "한국어":
+                    review_entry += f"\n- **핵심 팩트:** {', '.join(key_facts[:2])}"
+                else:
+                    review_entry += f"\n- **Key Facts:** {', '.join(key_facts[:2])}"
+            
+            # Add learning point
+            if learning_point:
+                if language == "한국어":
+                    review_entry += f"\n- **💡 학습 포인트:** {learning_point[:150]}{'...' if len(learning_point) > 150 else ''}"
+                else:
+                    review_entry += f"\n- **💡 Learning Point:** {learning_point[:150]}{'...' if len(learning_point) > 150 else ''}"
+            
+            review_lines.append(review_entry)
         
         percentage = (correct_count / total) * 100 if total > 0 else 0
         grade = calculate_grade(percentage)