T-21 Individual Student Detail

教師端追蹤學生設計規格

畫面用途

1. 個人 KPI 總覽： Active Rate / Session Mastery / Questions Practiced / 單字纍積量 四大指標，範圍為學生個人。

Student Detail 🔗 ↗

閱讀完整規格 ↓

內容依原始規格呈現 · 查看 Markdown 來源 ↗需具備倉庫查看權限

🎨 Figma: Student Detail 🔗

🎯 功能定位

1. 個人 KPI 總覽： Active Rate / Session Mastery / Questions Practiced / 單字纍積量 四大指標，範圍為學生個人。
2. 詞彙成長追蹤： 三層曲線圖（Curriculum / Review / Mastered），以學生個人數據呈現。
3. Session 單字結構： 該學生當前與下個 Session 的 Words / Vocab / Sents 比例對比。
4. 記憶深度分析（Cognitive Depth）： 可選擇 Total / Discovery Hub / Speak Studio，以及不同 Level（有數據才可選）。
5. Trophy 表現： 該學生的 pending / pass / fail / progress，支援 total / month / latest 時間選擇。
6. 練習量趨勢： Questions Practiced 三線圖，範圍為學生個人。
7. 學籍資訊管理： 區分基礎資訊與家長聯絡資訊。
8. 學習範圍設定： 老師可手動調整「開始 Session」與「結束 Session」以定義學生的實際學習路徑。

🧱 畫面結構

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

• Header:

  • "Hello, Sandra!" — 問候語 + 教師名稱
  • [🔔] [👤] → T-03 / T-04

• Sidebar (深色，圖標式):

  • Home User Clock Calendar Chart Trophy

• Main Content — Individual Analytics:

  • < Back to List — 返回上一頁
  • Student Profile & Configuration — Card:
    • Basic Info: Display Name: [Emma_Superstar ✎] Real Name: Emma Zhang Gender: Female Birthday: 2018/05/20 Email: emma.z@example.com
    • Parent Info: P1: [Name1] [Email1] [Phone1] P2: [Name2] [Email2] [Phone2]
    • Session Config: Enrollment: NH_L1_3-1 (Fixed) Learning Start: [NH_L1_1-1 ▾] Learning End: [NH_L2_4-2 ▾]

      Learning Start 即 Mode 回溯邊界： 系統在查詢學生練習範圍時，不會回溯到早於 Learning Start 的 Session。Mode 參數配置見 09-規則配置.md §8。

KPI Cards × 4（橫排）：

• Active Rate: 85% — 該學生個人活躍率（定義同 T-01，參數見 09-規則配置.md §9）
• Session Mastery: 72% — 個人平均掌握度
• Questions Practiced: 320 — 個人累計練習次數
• 單字纍積量: 180 — 個人累積詞彙

單字纍積量 (Vocabulary Accumulation) — 學生個人版：

• 三層曲線：Curriculum / Review / Mastered（定義同 T-01，Mastered = Box4+）
• x 軸時間切換：total / month / week

當前 Session vs 下個 Session 單字結構 — 學生個人版：

• 該學生的 Words / Vocab / Sents 堆疊柱狀圖

Session Mastery — 學生個人版：

• TTL / DH / SS 三線折線圖，範圍為該學生個人

Trophy 表現：

• pending / pass / fail / progress 四項指標
• total / month / latest 時間選擇
• 範圍為該學生個人

Questions Practiced — 學生個人版：

• total / discovery / speak 主線 + curriculum 參考線
• DH 藍色 / SS 粉紅色
• x 軸固定過去 30 天

Cognitive Distribution：

• 可選擇 [Total ▾] / [Discovery Hub ▾] / [Speak Studio ▾]
• 可選擇不同 Level（僅有數據的 Level 可選，無數據的灰階禁用）
• 五階段堆疊柱狀圖（定義同 T-01）

Top 10 Weak Items：

• 正確率最低的前 10 項（Word/Sentence），顯示類型與正確率
• 時間範圍選擇：1 週 / 1 月，預設 1 週

📦 區塊說明

#	區塊	元件	行為/交互	備註
1	基礎資料	Info Fields	Display Name 可編輯（✎），其餘唯讀（同步自 A-10）	—
2	家長資料	Info Fields	唯讀顯示兩位家長聯絡方式	同步自 A-10
3	Session 配置	Dropdown × 2	Learning Start / End 可調整	Enrollment Session 永久固定
4	KPI Cards	Card × 4	顯示個人 Active Rate / Session Mastery / Questions Practiced / 單字纍積量	—
5	單字纍積量	Multi-line Chart	學生個人三層曲線 + total/month/week 切換	定義同 T-01
6	當前 vs 下個 Session 單字	Stacked Bar Chart × 2	該學生 Words / Vocab / Sents 堆疊	—
7	Session Mastery	Multi-line Chart	學生個人 TTL / DH / SS	—
8	Trophy 表現	Stat Cards × 4 + Time Selector	學生個人四指標 + total/month/latest	—
9	Questions Practiced	Multi-line + Ref Line Chart	學生個人三線 + curriculum 參考線	DH 藍 / SS 粉 / x 軸 30 天
10	Cognitive Distribution	Stacked Bar Chart + Module/Level Selector	可選 Total/DH/SS 和 Level（有數據才可選）	階段定義同 T-01
11	Top 10 Weak Items	List	正確率最低 10 項	1 週/1 月時間範圍

🔁 交互流程

流程圖

正在載入流程圖…

⚙️ 狀態管理

狀態	觸發條件	畫面表現
正常	數據載入完成	顯示完整個人分析
加載中	時間維度或 Level 選擇變更	Skeleton Loading
空狀態	無練習數據	顯示「尚無練習記錄」引導
無數據 Level	選擇的 Level 無數據	Level 選項灰階禁用
錯誤	API 失敗	錯誤提示 + Retry

🔎 邏輯自我檢查

• 範圍一致性： Active Rate / Session Mastery / 單字纍積量 / Trophy / Questions Practiced 的定義與 T-01 完全一致，僅範圍從「全班」改為「學生個人」。各項閾值參數見 09-規則配置.md §7（Alert）及 §9（Active）。
• Cognitive Distribution Level 選擇： 僅有數據的 Level 可選，無數據的 Level 灰階禁用。
• Learning End 動態覆蓋： 若學生實際 Current Session 超過手動設定的 Learning End，系統自動以 Current Session 為準。
• Learning Start 範圍： 老師可選擇入學 Session 之前的 Session 作為學習起點。此處設定的值即 Mode 回溯邊界（09-規則配置.md §8），不得越過。
• Enrollment Session： 永久固定，不可修改。
• Top 10 Weak Items 範圍： 篩選範圍與時間範圍一致。

---