T-42 Exam Analytics

教師端查看檢定設計規格P1 起

P1 版本

畫面用途

提供該次模擬考的「大數據面」，幫助老師快速找出全班的集體薄弱環節（Top 10 錯誤率題目）。

301:768 ↗Exam Analytics 🔗 ↗在系統地圖中查看關係 ↗

原型與規格有待確認事項，請一併閱讀正文中的差異說明。

閱讀完整規格 ↓

變化時間線

1. P1新增 +1移除 −0

第一版式樣草案 · Markdown 來源：03-App畫面-教師.mdGitHub 版本尚未推送；目前以本機手冊為準

取圖紀錄： QL APP，2026-10-18，版本 2410774734466577464；節點 301:768 。學生 2x／Web 1x。圖片是目前設計稿，文字為 APlus 首版目標規格。 設計稿待更新（F-20）： 圖中舊品牌、華語內容或待核對項目照實保留；請以本節英語文字規格為目標。設計修改後重新取圖。

班級檢定分析報告

🎨 Figma: Exam Analytics 🔗

T-40 為 151:636，T-42 為 301:768，T-43 使用 322:7780 成績矩陣子元件，不共用同一張截圖。

⚠️ Figma 待同步： 完成度使用固定派送分母；額外的 Assigned／Completion KPI 呈現可後續安排，不要求為 A-51 重做此頁版面。

🎯 功能定位

提供該次模擬考的「大數據面」，幫助老師快速找出全班的集體薄弱環節（Top 10 錯誤率題目）。

🧱 畫面結構

Web 佈局：12-col grid，1280px max-width（無 Sidebar）

• Header:

  • < Back — 返回 T-40
  • Exam: {English Exam Name} | Date: {Date} | Class: {Class Name}
  • [🔔] [👤] → T-03 / T-04

• Main Content:

  • Exam Summary — KPI Cards:
    • Assigned: 30 Completion: 24 / 30 (80%) Avg. Score: 172 Pass: 21 / 24 (88%) Highest: 198 Lowest: 95
  • Top 10 Most Errored Questions — DataTable:
    • Columns: Rank | Question | Category | Err Rate | Action
    • [👁️] → 彈窗：題目內容 + 正解 + 錯誤分佈
  • [📂 View Student Matrix >] → T-43
  • [Preview Test] → 手機模擬器展示 S-31（不記錄答題數據）

📦 區塊說明

#	區塊	元件	行為/交互	備註
1	Exam Summary	KPI Cards	顯示該場 Challenge 的固定派送分母與全班統計	Assigned、Completion、平均分、及格數／率、最高分、最低分
2	Top 10 錯誤題	DataTable	按錯誤率降序排列。點擊 [👁️] 彈窗查看題目內容、正解及錯誤分佈	自動計算全班錯誤頻率最高前 10 題
3	Student Matrix Link	Button	點擊跳轉 T-43 學生答題矩陣	—
4	Preview Test	Button	點擊開啟手機模擬器視窗，展示學生端 S-31 考試畫面	🆕 方便老師在課堂上向學生說明考試內容

指標真值

T-42 與管理員端 A-52 讀取同一份統計，不允許前端各自重算：

指標	定義
Assigned	該 challenge_id 的 challenge_member_snapshot 人數
Completed	至少一次 Final Submitted Attempt 的 Snapshot Member 數
Completion	Completed / Assigned；Assigned = 0 顯示 —
Effective Result	每位完成者取最高 Final Submitted 分數；同分取該學生最新完成的 Attempt
Avg. Score	Effective Score 總和 / Completed；Completed = 0 顯示 —
Pass Count／Rate	Effective Score 達 Exam Pass Score 的完成者數；Rate 分母為 Completed

手機模擬器預覽 (Preview Test)

點擊 [Preview Test] 按鈕時，彈出一個手機模擬器視窗（模擬學生端 S-31 Test In Progress 畫面），展示該次 Challenge 的完整考題與 UI。此功能設計目的為：

• 課堂說明： 老師可以在投影螢幕上展示學生視角，講解答題方式
• 完全模擬： 模擬器渲染與學生端 App 完全一致的 UI（含手機外框、375×812 基準）
• 僅預覽模式： 不記錄任何答題數據，僅供展示用途

🔁 交互流程圖

流程圖

正在載入流程圖…

⚙️ 狀態管理

狀態	觸發條件	畫面表現
正常	數據載入	顯示 Summary + Top 10
加載中	頁面首次載入	Loading
空狀態	尚無考試數據	引導提示

🔎 邏輯自我檢查

• 錯誤率計算： Error Rate = 該題錯誤人數 / 總作答人數。
• 數據來源： 同一場 Challenge 的 Snapshot 與所有 Final Submitted Attempt；逐題錯誤率以 Effective Result 對應的 Attempt 為準。
• Section 呈現： Listening／Reading 可分 Section 查看題目統計，但頁面頂層只顯示一場 Exam／Challenge 與一組完成度。
• 名冊變更： 轉班、離班與軟刪除不改寫 Assigned；隱私永久刪除後僅保留匿名聚合。
• 隱私抑制： 含永久刪除貢獻且匿名聚合方案尚未驗證時，依 A-52 同步隱藏表現摘要、Highest／Lowest、Top 10 與錯誤分佈；不能用這些衍生報表推算被刪者答案或分數。

---