A-50 Trophy Room Exam Management
- P1新增 +1移除 −0
第一版式樣草案 · Markdown 來源：04-App畫面-管理員.mdGitHub 版本尚未推送；目前以本機手冊為準
取圖紀錄： QL APP，2026-10-18，版本
2410774734466577464；節點 912:3209 。學生 2x／Web 1x。圖片是目前設計稿，文字為 APlus 首版目標規格。 設計稿待更新（F-30）： 圖中舊品牌、華語內容或待核對項目照實保留；請以本節英語文字規格為目標。設計修改後重新取圖。
🎨 Figma: node-912-3209 (A-50/A-51 共用) 🔗
⚠️ Figma 待同步： 現有截圖的右上角仍為
+ New Exam，Category 列僅顯示無文字+。目標文案如下表。
🎯 功能定位
使用者： Admin / Super Admin
- 類別控制： 定義可配置的英文檢定分類；Cambridge YLE Starters／Movers／Flyers 僅為候選示例，採用待確認。
- 數據生命週期： 提供「查看預覽」、「封存 (Archive)」、「徹底刪除」功能。
- 營運分析： 依 Zone／School／Class 查看每份 Exam 的派送、完成、平均分與及格情況。
- 安全性： 遵循「不可直接編輯」原則，修改必須重新導入，確保題庫庫存的嚴謹。
🧱 畫面結構
| 區域 | 說明 |
|---|---|
| Header | APlus Admin Trophy Room > Exam Management, [👤 Admin] |
| Sidebar | 導航菜單 |
| Toolbar | Trophy Library, [+ Import Exam] 按鈕（右上角，進入 A-51）、[Export Trophy CSV] |
| Category Management | [+ Category] 按鈕（Category 列左側），分類卡片 [📂] English Exam Categories（示例；分類與數量待確認）, [📦] Archived |
| Exam Table | 沿用 Exam Name、Level、Round、Status、Created 與 Preview／Archive／Delete；不為 CSV 重做列表 |
| Export Dialog | 選擇 Exam、School／Class 與派送日期；Admin 的 Zone 固定為其管轄範圍，使用 A-52 的共用 CSV 規格 |
📦 區塊說明
| 區塊 | 元件 | 行為/交互 | 備註 |
|---|---|---|---|
| Category Cards | [📂] Category Buttons | 點擊切換分類，顯示該類所有考試 | 含已封存分類 [📦] |
| [+ Category] | Button | 建立 Trophy Category，不建立 Exam | Super Admin Only；Admin 隱藏此按鈕 |
| [+ Import Exam] | Button | 跳轉至 A-51 導入新考試 | Admin / Super Admin |
| [Export Trophy CSV] | Button | 以範圍選擇彈窗產生班級聚合 CSV | 不依賴完整 A-52 頁面；不包含學生明細或語音 |
| [👁️] Preview | Button | 預覽題目內容與邏輯渲染 | 不可修改 |
| [📦] Archive | Button | 封存後考試從推送選單消失 | 學生數據保留 |
| [📂] Unarchive | Button | 將封存項目恢復至 Active | 反向操作 |
| [🗑️] Delete | Button | 沿用刪除入口與確認；已有 Challenge 引用時禁用 | 包含已派送但尚未開始的考試，提示「Please archive instead.」，避免破壞既有派送 |
📊 班級完成度共用口徑
第一階段以 Export Trophy CSV 解決各班完成狀況查詢，沿用現有題庫列表。下表是 CSV 與既有教師報表的共用計算規則，不要求同時新增列表 KPI。跨班 Dashboard、[👁 Analytics] 下鑽及完整 A-52 頁面留待後續；指標以派送時名單／Snapshot 為準，不以目前班級名冊反推歷史分母。
| 指標 | 顯示 | 統一定義 |
|---|---|---|
| Assigned | N | 選定範圍內 challenge_member_snapshot 的人次 |
| Completion | Completed / Assigned (Rate) | 至少有一次 Final Submitted Attempt 的派送人次 / Assigned |
| Avg. Score | Score / Total 或 — | 每位完成者取 Effective Result 後計算平均；無完成者顯示 — |
| Pass Count / Rate | Pass / Completed (Rate) 或 — | Effective Score ≥ Exam Pass Score 的完成者；無完成者顯示 — |
同一學生重考時，Effective Result 取所有 Final Submitted Attempts 的最高分；同分時取最後完成的一次。完成度只計一次，避免重考灌大分母或完成數。