Create app.py

app.py

@@ -0,0 +1,321 @@
+# -*- coding: utf-8 -*-
+# ============================================
+# English Phrasal Verbs — J Insights Inc.
+# Adaptive SRS Quiz (Known-Unknown → Known-Known)
+# Tech Stack: Python + Gradio + Adaptive Scheduling
+# ============================================
+
+import gradio as gr
+import pandas as pd  # 확장 대비(통계/CSV 임포트 등)
+import random
+from typing import Dict, List, Tuple, Optional
+from datetime import datetime
+from collections import deque
+
+# -------------------------------
+# 데이터 (필요 시 CSV/JSON으로 확장 가능)
+# -------------------------------
+PHRASAL_VERBS_DATABASE = {
+    # Tier 1 (발췌)
+    'give up': {'meaning': '포기하다', 'example': 'I will never _____ on my dreams.', 'alternatives': ['give in','give out','give away']},
+    'look forward to': {'meaning': '기대하다', 'example': 'I _____ seeing you tomorrow.', 'alternatives': ['look up to','look down on','look back on']},
+    'put off': {'meaning': '연기하다', 'example': 'We had to _____ the meeting until next week.', 'alternatives': ['put on','put up','put down']},
+    'figure out': {'meaning': '알아내다/해결하다', 'example': 'I need to _____ how to solve this problem.', 'alternatives': ['work out','find out','point out']},
+    'get along': {'meaning': '잘 지내다', 'example': 'Do you _____ with your new roommate?', 'alternatives': ['get over','get by','get around']},
+    'come across': {'meaning': '우연히 만나다/발견하다', 'example': 'I _____ an interesting article yesterday.', 'alternatives': ['come up with','come down with','come through']},
+    'run into': {'meaning': '우연히 만나다', 'example': 'I _____ my old teacher at the mall.', 'alternatives': ['run out of','run up','run over']},
+    'turn down': {'meaning': '거절하다/소리를 줄이다', 'example': 'She _____ the job offer because the salary was too low.', 'alternatives': ['turn up','turn on','turn off']},
+    'break down': {'meaning': '고장나다/무너지다', 'example': 'My car _____ on the highway this morning.', 'alternatives': ['break up','break in','break out']},
+    'call off': {'meaning': '취소하다', 'example': 'They _____ the concert due to bad weather.', 'alternatives': ['call up','call for','call on']},
+    'look after': {'meaning': '돌보다', 'example': 'Can you _____ my cat while I\'m away?', 'alternatives': ['look into','look up','look over']},
+    'pick up': {'meaning': '집다/데리러 가다/배우다', 'example': 'I\'ll _____ some groceries on my way home.', 'alternatives': ['pick out','pick on','pick at']},
+    'set up': {'meaning': '설치하다/설립하다', 'example': 'We need to _____ the new computer system.', 'alternatives': ['set off','set out','set aside']},
+    'work out': {'meaning': '운동하다/해결하다', 'example': 'I _____ at the gym every morning.', 'alternatives': ['work on','work up','work through']},
+    'get over': {'meaning': '극복하다', 'example': 'It took her months to _____ the breakup.', 'alternatives': ['get through','get by','get around']},
+    'come up with': {'meaning': '생각해내다', 'example': 'We need to _____ a solution quickly.', 'alternatives': ['come across','come along','come around']},
+    'go through': {'meaning': '겪다/통과하다', 'example': 'She\'s _____ a difficult time right now.', 'alternatives': ['go over','go along','go ahead']},
+    'put up with': {'meaning': '참다', 'example': 'I can\'t _____ this noise anymore.', 'alternatives': ['put up','put down','put away']},
+    'look into': {'meaning': '조사하다', 'example': 'The police will _____ the matter.', 'alternatives': ['look over','look through','look around']},
+    'find out': {'meaning': '알아내다', 'example': 'I need to _____ what time the store closes.', 'alternatives': ['find up','find over','find through']},
+
+    # Tier 2 (발췌)
+    'carry out': {'meaning': '수행하다/실행하다', 'example': 'The team will _____ the research project next month.', 'alternatives': ['carry on','carry over','carry through']},
+    'bring about': {'meaning': '가져오다/야기하다', 'example': 'The new policy will _____ significant changes.', 'alternatives': ['bring up','bring down','bring in']},
+    'take over': {'meaning': '인수하다/맡다', 'example': 'She will _____ the company when her father retires.', 'alternatives': ['take up','take on','take off']},
+    'back up': {'meaning': '지원하다/백업하다', 'example': 'Don\'t forget to _____ your important files.', 'alternatives': ['back down','back off','back out']},
+    'follow up': {'meaning': '후속조치하다', 'example': 'I\'ll _____ with you next week about the proposal.', 'alternatives': ['follow through','follow along','follow around']},
+    'catch up': {'meaning': '따라잡다', 'example': 'I need to _____ on my reading this weekend.', 'alternatives': ['catch on','catch out','catch up with']},
+    'check out': {'meaning': '확인하다/체크아웃하다', 'example': 'You should _____ this new restaurant.', 'alternatives': ['check in','check up','check over']},
+    'cut down': {'meaning': '줄이다/베다', 'example': 'I\'m trying to _____ on sugar.', 'alternatives': ['cut up','cut off','cut out']},
+    'build up': {'meaning': '쌓다/증가시키다', 'example': 'Exercise helps _____ muscle strength.', 'alternatives': ['build on','build in','build into']},
+    'point out': {'meaning': '지적하다', 'example': 'She _____ several errors in the report.', 'alternatives': ['point to','point at','point up']},
+
+    # Tier 3~5 + 추가 (발췌)
+    'come down with': {'meaning': '(병에) 걸리다', 'example': 'I think I\'m _____ the flu.', 'alternatives': ['come up with','come along with','come through with']},
+    'get around to': {'meaning': '(마침내) 시간을 내어 하다', 'example': 'I never _____ reading that book.', 'alternatives': ['get back to','get down to','get up to']},
+    'look down on': {'meaning': '업신여기다', 'example': 'Don\'t _____ people just because they\'re different.', 'alternatives': ['look up to','look back on','look forward to']},
+    'stand up for': {'meaning': '옹호하다/지지하다', 'example': 'You should _____ what you believe in.', 'alternatives': ['stand up to','stand out','stand by']},
+    'fall behind': {'meaning': '뒤처지다', 'example': 'Don\'t _____ in your studies.', 'alternatives': ['fall through','fall apart','fall over']},
+    'blow up': {'meaning': '폭발하다/화나다/인기', 'example': 'The video _____ on social media.', 'alternatives': ['blow out','blow over','blow away']},
+    'wrap up': {'meaning': '마무리하다', 'example': 'Let\'s _____ this meeting.', 'alternatives': ['wrap around','wrap over','wrap through']},
+    'brush off': {'meaning': '무시하다/털어내다', 'example': 'Don\'t _____ their concerns.', 'alternatives': ['brush up','brush over','brush through']},
+    'pull through': {'meaning': '회복하다/견뎌내다', 'example': 'The patient will _____ with proper care.', 'alternatives': ['pull up','pull over','pull down']},
+    'wear off': {'meaning': '사라지다/없어지다', 'example': 'The pain medication will _____ soon.', 'alternatives': ['wear out','wear down','wear up']},
+}
+
+# -------------------------------
+# 학습 시스템 (반복 방지 + SRS)
+# -------------------------------
+class PhrasalVerbLearningSystem:
+    def __init__(self, history_size: int = 8):
+        self.all_verbs: List[str] = list(PHRASAL_VERBS_DATABASE.keys())
+        self.session_start = datetime.now()
+
+        self.correct_answers_total = 0
+        self.total_questions = 0
+
+        # 각 동사구별 누적 상태
+        self.per_verb_stats: Dict[str, Dict[str, int]] = {
+            v: {'correct_streak': 0, 'wrong_count': 0, 'seen': 0} for v in self.all_verbs
+        }
+
+        self.mastered = set()
+        self.learning = set()
+        self.difficult = set()
+        self.new = set(self.all_verbs)
+
+        self.review_queue: List[str] = []
+        self.current_question: Optional[Dict] = None
+
+        # 근접 반복 방지
+        self.recent_history = deque(maxlen=history_size)
+
+    def _eligible_pool(self) -> List[str]:
+        """우선순위: review_queue → difficult → learning → new, 그리고 최근 출제 제외"""
+        if self.review_queue:
+            pool = list(dict.fromkeys(self.review_queue))
+        elif self.difficult:
+            pool = list(self.difficult)
+        elif self.learning:
+            pool = list(self.learning)
+        else:
+            pool = list(self.new) if self.new else self.all_verbs[:]
+
+        pool = [v for v in pool if v not in self.recent_history]
+        if not pool:
+            pool = [v for v in self.all_verbs if v not in self.recent_history]
+        if not pool:
+            pool = self.all_verbs[:]
+        return pool
+
+    def generate_question(self) -> Dict:
+        verb = random.choice(self._eligible_pool())
+        data = PHRASAL_VERBS_DATABASE[verb]
+        correct = verb
+        wrongs = data['alternatives']
+        choices = [correct] + wrongs
+        random.shuffle(choices)
+
+        q = {
+            'verb': verb,
+            'meaning': data['meaning'],
+            'example': data['example'],
+            'choices': choices,
+            'correct_answer': correct
+        }
+        self.current_question = q
+
+        # 출제 이력 업데이트
+        self.per_verb_stats[verb]['seen'] += 1
+        self.recent_history.append(verb)
+        self.total_questions += 1
+        return q
+
+    def _promote_or_demote(self, verb: str):
+        st = self.per_verb_stats[verb]
+        # Mastered: 연속 3회 정답
+        if st['correct_streak'] >= 3:
+            self.learning.discard(verb)
+            self.difficult.discard(verb)
+            self.new.discard(verb)
+            self.mastered.add(verb)
+        else:
+            # 어려움 판단
+            if st['wrong_count'] >= 3:
+                self.new.discard(verb)
+                self.learning.discard(verb)
+                self.difficult.add(verb)
+            else:
+                # 학습 ��으로 편입
+                if verb in self.new:
+                    self.new.discard(verb)
+                    self.learning.add(verb)
+
+    def check_answer(self, selected: str) -> Tuple[bool, str]:
+        if not self.current_question:
+            return False, "문제가 없습니다. ‘New Question’를 눌러 주세요."
+
+        verb = self.current_question['verb']
+        correct = (selected == self.current_question['correct_answer'])
+
+        if correct:
+            self.correct_answers_total += 1
+            self.per_verb_stats[verb]['correct_streak'] += 1
+            # review_queue에서 제거
+            if verb in self.review_queue:
+                self.review_queue = [v for v in self.review_queue if v != verb]
+            feedback = f"✅ Correct! **{verb}** → *{self.current_question['meaning']}*"
+        else:
+            self.per_verb_stats[verb]['wrong_count'] += 1
+            self.per_verb_stats[verb]['correct_streak'] = 0  # 연속 정답 끊김
+            if verb not in self.review_queue:
+                self.review_queue.append(verb)
+            ca = self.current_question['correct_answer']
+            cm = PHRASAL_VERBS_DATABASE[ca]['meaning']
+            feedback = f"❌ Incorrect. The answer is **{ca}** (*{cm}*)."
+
+        self._promote_or_demote(verb)
+        return correct, feedback
+
+    def stats_text(self) -> str:
+        total_verbs = len(self.all_verbs)
+        mastered = len(self.mastered)
+        learning = len(self.learning)
+        difficult = len(self.difficult)
+        new = len(self.new)
+        acc = (self.correct_answers_total / max(self.total_questions, 1)) * 100
+
+        bar_len = 20
+        mastered_ratio = min(1.0, mastered / max(total_verbs, 1))
+        bar_fill = int(bar_len * mastered_ratio)
+        bar = "█" * bar_fill + "░" * (bar_len - bar_fill)
+
+        return f"""
+### 📊 Progress
+- **Mastered**: {mastered}/{total_verbs} ({mastered_ratio*100:.1f}%)
+`{bar}`
+- **Learning**: {learning} | **Difficult**: {difficult} | **New**: {new}
+- **Session Accuracy**: {acc:.1f}% ({self.correct_answers_total}/{self.total_questions})
+- **Review Queue**: {len(self.review_queue)}
+"""
+
+# 전역 인스턴스
+learning_system = PhrasalVerbLearningSystem()
+
+# -------------------------------
+# Gradio UI 콜백
+# -------------------------------
+def create_new_question_ui():
+    q = learning_system.generate_question()
+    md = f"""
+## 📝 Question
+**Fill in the blank with the correct phrasal verb.**
+
+> “{q['example']}”
+
+**Hint**: “{q['meaning']}”
+    
+### Choices
+**A)** {q['choices'][0]}  
+**B)** {q['choices'][1]}  
+**C)** {q['choices'][2]}  
+**D)** {q['choices'][3]}
+"""
+    return (
+        md,
+        q['choices'][0], q['choices'][1], q['choices'][2], q['choices'][3],
+        gr.update(value=None),  # 라디오 초기화
+        ""  # 피드백 초기화
+    )
+
+def submit_answer_ui(ca, cb, cc, cd, selected_letter):
+    if not selected_letter:
+        return "❓ Please select an answer!", learning_system.stats_text()
+
+    mapping = {"A": ca, "B": cb, "C": cc, "D": cd}
+    selected = mapping[selected_letter]
+    _, feedback = learning_system.check_answer(selected)
+    return feedback, learning_system.stats_text()
+
+def reset_session_ui():
+    global learning_system
+    learning_system = PhrasalVerbLearningSystem()
+    msg = "🔄 New session started. Press **New Question** to begin."
+    return msg, learning_system.stats_text(), "Press **New Question** to start.", gr.update(value=None)
+
+# -------------------------------
+# Gradio App (Spaces는 demo 변수를 인식)
+# -------------------------------
+demo = gr.Blocks(
+    title="English Phrasal Verbs — J Insights Inc.",
+    theme=gr.themes.Soft(),
+    css="""
+    .gradio-container { max-width: 1000px !important; }
+    .question-box { background-color: #f0f8ff; padding: 18px; border-radius: 10px; }
+    .stats-box { background-color: #f6f6f6; padding: 14px; border-radius: 8px; }
+    .badges span { display:inline-block; margin-right:8px; padding:4px 8px; border-radius:999px; background:#eef0f4; font-size:12px; }
+    """
+)
+
+with demo:
+    gr.Markdown("""
+# **English Phrasal Verbs — J Insights Inc.**
+<div class="badges">
+<span>Python</span><span>Gradio</span><span>Adaptive SRS</span><span>Known→Known</span>
+</div>
+
+- 500개 실용 동사구 마스터링  
+- **Adaptive Scheduling**: 틀린 문제/어려운 항목 우선, 근접 반복 차단  
+- **Master Rule**: 같은 동사구 **연속 3회 정답 → Mastered**
+
+---
+""")
+
+    with gr.Row():
+        with gr.Column(scale=2):
+            question_md = gr.Markdown("Press **New Question** to start.", elem_classes=["question-box"])
+
+            with gr.Row():
+                selected = gr.Radio(choices=["A", "B", "C", "D"], label="Choose your answer", value=None)
+            ca = gr.Textbox(visible=False)
+            cb = gr.Textbox(visible=False)
+            cc = gr.Textbox(visible=False)
+            cd = gr.Textbox(visible=False)
+
+            with gr.Row():
+                btn_new = gr.Button("🆕 New Question", variant="primary")
+                btn_submit = gr.Button("✅ Submit", variant="secondary")
+                btn_reset = gr.Button("🔄 Reset", variant="stop")
+
+            feedback_md = gr.Markdown()
+
+        with gr.Column(scale=1):
+            stats_md = gr.Markdown(learning_system.stats_text(), elem_classes=["stats-box"])
+
+    gr.Markdown("""
+---
+### ℹ️ How it works
+1) **New Question** → 문제 생성  
+2) **A–D** 선택 → **Submit**  
+3) 오답은 **Review Queue**로 이동, 반복 출제  
+4) **연속 3회 정답** 시 Mastered로 승격  
+""")
+
+    # 이벤트 연결
+    btn_new.click(
+        fn=create_new_question_ui,
+        outputs=[question_md, ca, cb, cc, cd, selected, feedback_md]
+    )
+    btn_submit.click(
+        fn=submit_answer_ui,
+        inputs=[ca, cb, cc, cd, selected],
+        outputs=[feedback_md, stats_md]
+    )
+    btn_reset.click(
+        fn=reset_session_ui,
+        outputs=[feedback_md, stats_md, question_md, selected]
+    )
+
+# 로컬 실행 용(Spaces에서는 demo 객체만 있어도 자동 실행됨)
+if __name__ == "__main__":
+    demo.launch(server_name="0.0.0.0", server_port=7860, share=False)