Create app.py

app.py

@@ -0,0 +1,308 @@
+import json
+import time
+from typing import Dict, Any
+import gradio as gr
+
+# --- Markdown Conversion Helpers (NEW) ---
+# (這部分是新增的，用於將 JSON 轉換為 Markdown)
+
+def json_to_admin_markdown(data: Dict[str, Any]) -> str:
+    """將「會議記錄」JSON 轉換為 Markdown 格式的字串"""
+    try:
+        md = f"# {data.get('文件類型 (Document Type)', '會議記錄')}\n\n"
+        
+        info = data.get("meeting_info", {})
+        md += f"## {info.get('topic', '會議主題')}\n"
+        md += f"* **日期 (Date):** {info.get('date', 'N/A')}\n"
+        md += f"* **地點 (Location):** {info.get('location', 'N/A')}\n\n"
+
+        md += "### 出席人員 (Attendees)\n"
+        for attendee in data.get("attendees", ["N/A"]):
+            md += f"* {attendee}\n"
+        md += "\n"
+
+        md += "### 會議重點 (Key Points)\n"
+        for i, point in enumerate(data.get("key_points", ["N/A"]), 1):
+            md += f"{i}.  {point}\n"
+        md += "\n"
+
+        md += "### 決議事項 (Resolutions)\n"
+        resolutions = data.get("resolutions", [])
+        if resolutions:
+            md += "| 項目 (Item) | 負責人 (Responsible) | 期限 (Deadline) |\n"
+            md += "|:---|:---|:---|\n"
+            for item in resolutions:
+                md += f"| {item.get('item', '')} | {item.get('responsible', '')} | {item.get('deadline', '')} |\n"
+        else:
+            md += "無\n"
+        md += "\n"
+        
+        md += "---\n"
+        md += f"_{data.get('audit_note', '')}_\n"
+        
+        return md
+        
+    except Exception as e:
+        return f"ERROR generating Markdown preview: {e}"
+
+
+def json_to_lesson_plan_markdown(data: Dict[str, Any]) -> str:
+    """將「教案」JSON 轉換為 Markdown 格式的字串"""
+    try:
+        md = f"# {data.get('lesson_plan_title', '教案標題')}\n\n"
+        md += f"* **適用年級 (Grade Level):** {data.get('grade_level', 'N/A')}\n\n"
+
+        md += "### 課綱對齊 (Curriculum Alignment)\n"
+        for item in data.get("curriculum_alignment", ["N/A"]):
+            md += f"* {item}\n"
+        md += "\n"
+
+        md += "### 學習目標 (Learning Objectives)\n"
+        for i, item in enumerate(data.get("learning_objectives", ["N/A"]), 1):
+            md += f"{i}.  {item}\n"
+        md += "\n"
+
+        md += "### 活動流程 (Activities)\n"
+        activities = data.get("activities", [])
+        if activities:
+            md += "| 時間(min) | 階段 (Stage) | 教學法 (Method) | 描述 (Description) |\n"
+            md += "|:---|:---|:---|:---|\n"
+            for item in activities:
+                md += f"| {item.get('time_min', '')} | {item.get('stage', '')} | {item.get('method', '')} | {item.get('description', '')} |\n"
+        md += "\n"
+
+        md += "### 評量規準 (Rubric)\n"
+        rubric = data.get("rubric", {})
+        md += f"**{rubric.get('title', '評量規準')}**\n\n"
+        
+        criteria = rubric.get("criteria", [])
+        if criteria:
+            md += "| 指標 (Criteria) | A (精熟) | D (待加強) |\n"
+            md += "|:---|:---|:---|\n"
+            for item in criteria:
+                md += f"| {item.get('name', '')} | {item.get('A', '')} | {item.get('D', '')} |\n"
+        md += "\n"
+
+        md += "### 差異化建議 (Differentiation Advice)\n"
+        md += f"{data.get('differentiation_advice', 'N/A')}\n"
+        
+        return md
+
+    except Exception as e:
+        return f"ERROR generating Markdown preview: {e}"
+
+# --- Simulation Setup for LLM API ---
+# (此部分保持不變)
+LLM_MODEL = "gemini-2.5-flash-preview-09-2025"
+API_KEY = "" # API Key Placeholder
+
+def simulate_gemini_api_call(payload: Dict[str, Any], fields: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    Simulates a structured response from the Gemini API based on the task type.
+    """
+    time.sleep(1.0)
+    user_query = payload['contents'][0]['parts'][0]['text']
+    system_instruction = payload.get('systemInstruction', {}).get('parts', [{}])[0].get('text', 'No system instruction')
+    
+    if "台灣中學學務處行政書記" in system_instruction:
+        mock_text_result = json.dumps({
+            "文件類型 (Document Type)": "學務處會議記錄 (Academic Affairs Meeting Minutes)",
+            "meeting_info": {
+                "date": fields.get('date', '2025-01-10'),
+                "location": fields.get('location', '學務處會議室'),
+                "topic": fields.get('topic', '模擬會議主題')
+            },
+            "attendees": ["校長", "學務主任", "衛生組長", "生輔組長"],
+            "key_points": [
+                "期末獎懲核定程序已完成，共核定 30 件。",
+                "新生訓練場地佈置進度達 80%，物資清單已交付總務處採購。",
+                f"重點輸入: {fields.get('key_input', 'N/A')}"
+            ],
+            "resolutions": [
+                {"item": "發布正式期末獎懲公告。", "responsible": "教務處", "deadline": "2025-01-15"},
+                {"item": "新生訓練場地佈置於活動前一天完成驗收。", "responsible": "總務處", "deadline": "2025-08-20"}
+            ],
+            "audit_note": "文件根據校內行政公文標準格式生成。"
+        }, ensure_ascii=False, indent=2)
+        
+    elif "台灣國高中資深教師與課程設計師" in system_instruction:
+        mock_text_result = json.dumps({
+            "文件類型 (Document Type)": "單元教案與評量規準 (Lesson Plan & Rubric)",
+            "lesson_plan_title": f"【{fields.get('subject', 'N/A')}】探索 {fields.get('topic', 'N/A')} ({fields.get('hours', 0)} 課時)",
+            "grade_level": fields.get('grade', 'N/A'),
+            "curriculum_alignment": ["A2 邏輯推理與批判思辨", "B3 獨立思考與探究精神"],
+            "learning_objectives": ["學生能解釋核心概念 X。", "學生能應用方法 Y 進行分析。", "學生能製作報告Z進行表達。"],
+            "activities": [
+                {"time_min": 15, "stage": "引導", "method": "提問式教學", "description": "使用新聞案例引導核心概念。"},
+                {"time_min": 30, "stage": "活動一", "method": "合作學習", "description": "分組完成專題研究和實作練習。"},
+            ],
+            "rubric": {
+                "title": "單元評量規準 (4 級 X 4 指標)",
+                "criteria": [
+                    {"name": "概念理解", "A": "清晰精確地解釋所有核心概念。", "D": "只能回答簡單問題。"},
+                    {"name": "協作能力", "A": "積極領導團隊完成任務。", "D": "未參與討論。"}
+                ]
+            },
+            "differentiation_advice": f"根據班級特性 ({fields.get('class_needs', 'N/A')})，建議提供圖像化教材並進行分組輔導。"
+        }, ensure_ascii=False, indent=2)
+        
+    else:
+        mock_text_result = json.dumps({"error": "Unknown or missing task instruction."})
+
+    return {
+        "candidates": [{
+            "content": {
+                "parts": [{ "text": mock_text_result }]
+            },
+            "groundingMetadata": {}
+        }]
+    }
+
+# --- Module A: Admin Copilot Generator (Gradio Wrapper) ---
+# (修改：現在返回 Markdown 字串)
+
+def admin_copilot_generator(template_id: str, topic: str, date: str, location: str, key_input: str) -> str:
+    """
+    Handles the Admin Copilot UI inputs, calls simulation, and converts to Markdown.
+    Returns: (markdown_string)
+    """
+    fields = {
+        "topic": topic,
+        "date": date,
+        "location": location,
+        "key_input": key_input
+    }
+
+    system_prompt = (
+        "角色：台灣中學學務處行政書記\n"
+        "輸出：JSON（會議資訊、出席、重點、決議、待辦、負責人、期限）\n"
+        "格式規範：用詞正式、避免口語、保留專有名詞\n"
+        "限制：所有決議必須有負責人和明確期限。"
+    )
+    
+    user_query = f"請生成一份會議記錄。主題: {topic}; 輸入重點（或逐字稿）：{key_input}"
+    
+    payload = {
+        "contents": [{ "parts": [{ "text": user_query }] }],
+        "systemInstruction": { "parts": [{ "text": system_prompt }] },
+        "generationConfig": { "responseMimeType": "application/json" }
+    }
+
+    api_response = simulate_gemini_api_call(payload, fields)
+    
+    try:
+        json_string = api_response['candidates'][0]['content']['parts'][0]['text']
+        
+        # 新增：解析 JSON 並轉換為 Markdown
+        data = json.loads(json_string)
+        markdown_output = json_to_admin_markdown(data)
+        return markdown_output
+            
+    except (KeyError, json.JSONDecodeError) as e:
+        return f"ERROR: Failed to parse LLM structured output. {e}"
+
+# --- Module B: Teaching AI Designer (Gradio Wrapper) ---
+# (修改：現在返回 Markdown 字串)
+
+def lesson_plan_designer(grade: str, subject: str, topic: str, hours: float, method: str, equipment: str, class_needs: str) -> str:
+    """
+    Handles the Teaching Designer UI inputs, calls simulation, and converts to Markdown.
+    Returns: (markdown_string)
+    """
+    fields = {
+        "grade": grade,
+        "subject": subject,
+        "topic": topic,
+        "hours": int(hours),
+        "method": method,
+        "equipment": equipment,
+        "class_needs": class_needs
+    }
+    
+    system_prompt = (
+        "角色：台灣國高中資深教師與課程設計師\n"
+        "輸出：JSON（教案標題、目標、課綱對齊、活動步驟、評量規準、差異化建議）\n"
+        "限制：活動分鏡以 15 分鐘粒度；至少 2 項形成性評量。\n"
+        "對齊：請將輸出中的 'curriculum_alignment' 欄位，對齊台灣課綱的關鍵能力/素養。"
+    )
+    
+    user_query = (
+        f"請根據以下資訊設計一個單元教案、評量規準和差異化建議：\n"
+        f"年級/學科/單元主題: {grade}/{subject}/{topic}\n"
+        f"課時數: {int(hours)} 節\n"
+        f"教學法偏好: {method}\n"
+        f"可用設備: {equipment}\n"
+        f"班級特性: {class_needs}"
+    )
+
+    payload = {
+        "contents": [{ "parts": [{ "text": user_query }] }],
+        "systemInstruction": { "parts": [{ "text": system_prompt }] },
+        "generationConfig": { "responseMimeType": "application/json" }
+    }
+
+    api_response = simulate_gemini_api_call(payload, fields)
+    
+    try:
+        json_string = api_response['candidates'][0]['content']['parts'][0]['text']
+        
+        # 新增：解析 JSON 並轉換為 Markdown
+        data = json.loads(json_string)
+        markdown_output = json_to_lesson_plan_markdown(data)
+        return markdown_output
+
+    except (KeyError, json.JSONDecodeError) as e:
+        return f"ERROR: Failed to parse LLM structured output. {e}"
+
+# --- Gradio Interface Definition ---
+# (修改：更新 Outputs)
+
+# Module A Interface (Admin Copilot)
+admin_copilot_interface = gr.Interface(
+    fn=admin_copilot_generator,
+    inputs=[
+        gr.Textbox(label="模板 ID (Template ID - Fixed for MVP)", value="meeting_minutes_standard", interactive=False),
+        gr.Textbox(label="會議主題 (Meeting Topic)", value="學務處期末獎懲與新生訓練籌備會議"),
+        gr.Textbox(label="日期 (Date)", value="2025-01-10"),
+        gr.Textbox(label="地點 (Location)", value="學務處會議室"),
+        gr.Textbox(label="輸入重點/逐字稿 (Key Input/Transcript)", value="討論期末獎懲核定程序。新生訓練場地佈置、人員編組確認。", lines=5),
+    ],
+    # 修改：輸出元件改為 gr.Markdown
+    outputs=gr.Markdown(label="AI 生成文件預覽 (Markdown Preview)"),
+    title="行政 Copilot：會議記錄生成 (Admin Copilot: Meeting Minutes Generation)",
+    description="🎯 生成格式嚴謹的行政文件預覽。您可以直接複製此 Markdown 內容。",
+    flagging_mode="never",
+)
+
+# Module B Interface (Teaching Designer)
+lesson_plan_designer_interface = gr.Interface(
+    fn=lesson_plan_designer,
+    inputs=[
+        gr.Dropdown(label="年級 (Grade)", choices=["國中", "高中", "國小"], value="高中"),
+        gr.Textbox(label="學科 (Subject)", value="歷史"),
+        gr.Textbox(label="單元主題 (Unit Topic)", value="從茶葉看全球化：17-19世紀的貿易網絡"),
+        gr.Slider(label="課時數 (Number of Sessions)", minimum=1, maximum=10, step=1, value=4),
+        gr.Dropdown(label="教學法偏好 (Pedagogy Preference)", choices=["探究式、PBL", "翻轉教學", "合作學習", "講述法"], value="探究式、PBL"),
+        gr.Textbox(label="可用設備 (Available Equipment)", value="平板電腦、投影設備、網路"),
+        gr.Textbox(label="班級特性 (Class Characteristics)", value="班級組成多元，需考慮多樣化的史料呈現方式。"),
+    ],
+    # 修改：輸出元件改為 gr.Markdown
+    outputs=gr.Markdown(label="AI 生成教案預覽 (Markdown Preview)"),
+    title="教學 AI 設計器：教案與 Rubric 生成 (Teaching AI Designer: Lesson Plan & Rubric)",
+    description="📘 生成符合課綱精神的單元教案結構和評量規準預覽。",
+    flagging_mode="never",
+)
+
+# Integrate the two modules into a Tabbed Interface
+demo = gr.TabbedInterface(
+    [admin_copilot_interface, lesson_plan_designer_interface],
+    ["模組 A: 行政 Copilot", "模組 B: 教學設計器"],
+    title="CampusAI Suite (台灣校園 AI 文書/教學 MVP 演示)",
+    theme=gr.themes.Soft()
+)
+
+# --- Launch the application ---
+if __name__ == "__main__":
+    demo.launch()
+
+