T-43 Student Result Matrix

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

P1 版本

畫面用途

對應「每個學生的每題成績」。採用矩陣圖形式，讓老師一眼看出誰在哪一題丟了分。

322:7780 ↗Student Matrix 🔗 ↗在系統地圖中查看關係 ↗

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

閱讀完整規格 ↓

變化時間線

1. P1新增 +1移除 −0

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

取圖紀錄： QL APP，2026-10-18，版本 2410774734466577464；節點 322:7780 。學生 2x／Web 1x。圖片是目前設計稿，文字為 APlus 首版目標規格。 圖片範圍： 本節包含獨立浮層或選定的元件變體，並非完整底頁。以對應節點確認角色及狀態，尚待設計驗收。 設計稿待更新（F-26）： 圖中舊品牌、華語內容或待核對項目照實保留；請以本節英語文字規格為目標。設計修改後重新取圖。

學生答題明細矩陣

🎨 Figma: Student Matrix 🔗

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

⚠️ 候選方案，非本次必做： 下方 Teacher-only、逐學生導出欄位與 15 分鐘有效期尚未確認，不據此直接改動既有 Export 角色或按鈕。先完成 A-50 班級聚合 CSV；T-43 的導出政策另行審核，未確認前也不得擴張既有授權。

🎯 功能定位

對應「每個學生的每題成績」。採用矩陣圖形式，讓老師一眼看出誰在哪一題丟了分。

🧱 画面結構

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

• Header:

  • < Back — 返回 T-42
  • {English Exam Name} > Student Answer Matrix

• Main Content:

  • Filters: [All Students ▾] [Pass/Fail ▾] [🔍 Search] [📥 Export]（Export 僅授權 Teacher）
  • Student Answer Matrix — Grid Table:
    • Sticky Columns: Name | Member State | Score | Status | Attempts
    • Question Columns: Q1 | Q2 | Q3 | ...（水平滑動）
    • ✅ 綠色 = 正確 / ❌ 紅色 = 錯誤（Hover 顯示實際錯誤答案）
    • PASS 🏆 / FAIL — 狀態標籤
  • Bottom Row — 每題全班正確率（Corr Rt: 15% | 5% | 32% | ...）
  • 性能：分段加載，避免大矩陣卡頓

[設計稿參考]

📦 區塊說明

#	區塊	元件	行為/交互	備註
1	過濾器	Dropdown + Search + Button	按學生、及格狀態過濾，支援名稱搜索；目前仍被指派該班級的 Teacher 可導出受限 Excel	Admin／Super Admin 查看時隱藏 Export，改走 A-52 聚合或 A-90 授權流程
2	Status 列	Label + Icon	根據 Effective Result 顯示 PASS（+ 🏆）或 FAIL	合格者即已在 S-32 獲得 Trophy
3	Q1-Qn 矩陣	Grid (✅/❌)	✅ 綠色 = 正確；❌ 紅色 = 錯誤。Hover 於 ❌ 顯示實際錯誤答案	Sticky Column: Name 和 Score 固定在左側
4	Correct Rate 底行	Stat Row	垂直彙總每題的正確率	與 T-42 數據呼應
5	Member State	Status	顯示 Current／Former／Deleted	名冊改變不移除歷史列；隱私永久刪除後移除個別列，底部聚合依 A-52 隱私閘門抑制，不以人數門檻當匿名保證

🔁 交互流程圖

流程圖

正在載入流程圖…

⚙️ 狀態管理與性能優化

狀態	觸發條件	畫面表現
正常	數據載入	顯示矩陣表格
加載中	首次載入或過濾變更	分段加載（避免大矩陣卡頓）
導出中	授權 Teacher 點擊 Export	建立一次性檔案，Loading + 下載進度；建立與下載時都重新驗權
權限失效	Teacher 已不再被指派該 Class	立即取消生成／下載，隱藏 Export 並返回無權限狀態
空狀態	過濾結果為 0	提示無匹配結果

🔎 邏輯自我檢查

• Sticky Column： 題目可能多達 50-100 題，Name 和 Score 欄位必須固定在左側（Sticky），方便橫向捲動時識別學生。
• 分段加載（Pagination/Chunked Loading）： 矩陣數據點極多（學生數 × 題數），使用分段加載避免畫面卡頓。
• 導出角色： 只有目前仍被指派該 Class 的 Teacher 可建立與下載；Admin／Super Admin 不可借 T-43 導出逐學生資料，分別使用 A-52 班級聚合或 A-90 授權流程。
• 欄位白名單： school_student_id、display_name、member_state、effective_score、total_score、pass_status、attempt_count 及各題 correct／incorrect／unanswered。不得包含 Email、internal UUID、原始錯誤答案文字、語音、裝置或家長資料。
• 刪除邊界： Recycle Bin／Deleted 學生的身份欄位留空；永久刪除的學生整列與逐題資料完全排除。底部 Correct Rate 如含永久刪除貢獻，依 A-52 的隱私顯示閘門抑制，不能僅因 Assigned 達到 5 就顯示。
• 下載與審計（候選）： 建議下載連結 15 分鐘後失效，只能由建立者下載；建立與每次下載都重新校驗 Teacher－Class Assignment，並記錄操作者、Class、Challenge、篩選條件、列數、時間與結果。Audit 不記錄檔案內容；連結失效不代表已下載檔案消失。
• 重考口徑： 矩陣顯示 Effective Result 所對應的 Attempt；Attempts 欄保留總提交次數，避免把多次作答誤算成多名學生。
• 權限與刪除： 老師離開該班級或權限失效後不可再查看／導出；既有下載連結同步失效。
• 待確認的導出政策： 本 PR 建議 T-43 僅 Teacher 可導出、15 分鐘連結有效期；這是用途權限的候選決策，不表示 Super Admin 不能在授權畫面查看學生明細，也不能依賴 A-90 取得未定義的 Trophy 矩陣。最終導出角色需產品確認；已下載副本不會隨連結失效自動消失。

---