T-40 Trophy Room Management

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

P1 版本

畫面用途

這是老師管理「檢定與榮譽」的指揮中心：

151:636 ↗Trophy Room Management 🔗 ↗在系統地圖中查看關係 ↗

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

閱讀完整規格 ↓

變化時間線

1. P1新增 +1移除 −0

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

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

🎨 Figma: Trophy Room Management 🔗

⚠️ Figma node 151-636 為父容器，T-42 Exam Analytics 及 T-43 Student Result Matrix 為其子幀/面板。三者共用同一 Figma Frame。

⚠️ Figma 待同步： 現有畫面的完成度先共用下方統計口徑；新增欄位與 Section 摘要可後續安排，不作本次 A-51 匯入調整的前置需求。

🎯 功能定位

這是老師管理「檢定與榮譽」的指揮中心：

1. 監控戰績： 查看全班學生在歷次模擬考中獲得的獎盃分佈與及格率。
2. 發起挑戰： 從管理員建立的「考卷庫」中挑選試卷，推送給學生。
3. 進度追蹤： 查看目前正在進行中（Active）的挑戰任務進度。

🧱 画面結構

Web 佈局：12-col grid，1280px max-width，深色 Sidebar

• Header:

  • APlus Teacher Trophy Room Management — 頁面標題
  • [Class 3A ▾] [🔔] [👤] → T-02 / T-03 / T-04

• Sidebar (深色):

  • 🏠 Dashboard 📈 Progress ⚠️ Error Hub 🏆 Trophy Room 📊 Leaderboard
  • 底部：班級快捷切換器

• Main Content — Trophy Room:

  • [+ Push Challenge] — Header Button → T-41 Modal
  • KPI Cards × 3:
    • Total Trophy: 42 🏆 Avg Mock Score: 165/200 Last Pass Rate: 85%
  • Active Challenges — DataTable:
    • Columns: Exam Name | Start | Assigned | Completion | Avg Score | Action
    • [👁️] → 查看進行中詳情
  • Trophy History — DataTable:
    • Columns: Exam Name | Date | Completion | Pass Count / Rate | Avg Score | Action
    • [📊] → T-42 深度分析

📦 區塊說明

#	區塊	功能	行為與權限
1	Header [+ Push Challenge]	推送按鈕	點擊後開啟 T-41 彈窗
2	KPI Cards	戰績總覽	反映該班級在所有模擬考中的累積表現
3	Active Table	進度追蹤	顯示目前進行中的 Challenge，完成分母取派送時的 Member Snapshot。點擊 [👁️] 查看詳情
4	History Table	歷史歸檔	記錄過去所有檢定成績。點擊 [📊] 進入 T-42 深度分析

指標口徑

• Assigned、Completed、Completion、Avg. Score、Pass Count／Rate 與 A-52 完全共用定義。
• Listening／Reading 是同一 Exam 的 Section；一次推送只建立一個 challenge_id，不在 T-40 顯示兩筆 Challenge。
• 學生多次重考只算一個 Completed；分數與及格狀態取 Effective Result（最高 Final Submitted 分數，同分取最新）。

🔁 交互流程圖

流程圖

正在載入流程圖…

⚙️ 狀態管理

狀態	觸發條件	畫面表現
正常	數據載入	顯示 KPI + Active + History 三區
空狀態 - 無挑戰	尚無任何挑戰記錄	引導老師發起第一個挑戰
推送中	點擊 Confirm & Push	Loading + 按鈕禁用
推送成功	API 成功	Toast + Modal 關閉 + Active Table 刷新
Challenge 結束	Due Date 到期，或所有派送對象均 Pass 且無可重考對象	項目從 Active 移至 History；Completed 是提交指標，不能單獨用作關閉條件

🔎 邏輯自我檢查

• 試卷來源： 老師看到的試卷由管理員在 A-50（Admin 端）導入。
• 班級過濾： 老師只能看到自己擔當的班級，與 T-02 保持一致。
• 推送即時性： Confirm & Push 後，學生端 S-30 立刻顯示 Challenge 卡片。
• 轉化邏輯： 個別提交只更新 Completion 與結果；全員提交但仍有 Fail 且未到期時，Challenge 保留在 Active 供重考。依上方結束條件才移至 History，合格學生獲發 Trophy。
• 歷史穩定： 推送後的轉班、離班或刪除不改寫該 Challenge 的 Assigned 分母。

---