Skip to content

完整文件履歷

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

2026/05/13 修改

  1. 學生端 S-10 下面增加了變色龍表情規則(原本已有需求)
  2. 管理員端 A-90 從第二階段開發移到第一階段開發
  3. 增加了 Zulu 收集系統,簡單的增加 1 個畫面

2026/05/14 修改

畫面減少

  • A-40 出題規則畫面不要,改為伺服器端設置出題規則(整合至 09-規則配置.md

T-01 Teacher Dashboard

  • 一部分圖標刪除

數據導出功能修改

  • A-90 Data Export Center 管理員數據導出畫面
  • 新增學生單位的 Box 導出(CSV)

教師端 Exam 規則修改

  • T-41: [2] Select Target Class 不要,改為現在發送或者預約發送(日期 時間)
  • Passing Score 和 Exam Duration 改為 Read-Only
  • 可以選擇全部發送或者個別發送

教師端畫面修改

  • T-21: Average Cognitive Distribution 增加 Category 和 Level 的選項
  • T-21: Error Hub 支援不同時間段查詢

Trophy 獎勵規則更改

  • A-51 Trophy Room Exam Import: Trophy 獎盃改為隨機,不需要 Trophy 的設置
  • S-30 Trophy Room: 增加 Trophy Gallery 備注
    • 獲得的獎盃分為高/中/低,各有 3 款,為隨機獲得
    • 評價標準:Total Score − Passing Score 的分數,前 30% 為高,中間 40% 為中,後 30% 為低

其他

  • T-10 Class Schedule & Progress: Block 的設定是和班級綁定,學生轉移到別的班級則不影響
  • T-01 Dashboard: Session Mastery 可以左右移動,默認進去後直接定位後面有數據的部分
  • T-01 Active Rate: 一周 2 天使用 app,至少進行 1 次練習
  • T-01 單字累積圖支援 total / month / week 切換
  • T-03 Message Center 添加 Broadcast 功能(向班級 / 單個學生發送通知)
  • T-03 Filter 設定:All / System(自動)/ Notice(管理員發出)
  • T-42/T-43 Exam: 已發送的 Exam 允許查看和學生端一樣的頁面,模擬手機端(Preview Test)
  • S-10 Home 添加信箱功能(可收到管理員 / 教師的通知)
  • 管理員 Broadcast 功能:全校 / 校區發送,針對管理員 / 教師發送
  • A-01 Dashboard: Class Analytics 選擇單一 Level 時才顯示 Cognitive Distribution

2026/06/14 — 三端 Dashboard 全面改寫

T-01 Teacher Dashboard(v5.0 重寫)

  • KPI Cards × 4:Active Rate / Session Mastery / Questions Practiced / 單字累積量
  • Active Rate 定義統一:一周 2 天使用 app,至少進行 1 次練習(跨 T-01/T-21/A-01
  • 單字累積量:3 層曲線(Curriculum 總量/ Review Box1+/ Mastered Box4+)
  • Session Mastery:TTL(全部)/ DH / SS 三線折線圖
  • 當前 vs 下個 Session 單字結構:Words / Vocab / Sents 堆疊柱狀圖
  • Trophy 表現:pending / pass / fail / progress 四指標,hover 顯示學生列表
  • Questions Practiced:total / discovery / speak 填充曲線 + curriculum 參考線
  • Cognitive Distribution:5 階段(⚪ Not Started / 🌱 Emerging / 🌿 Developing / 🌳 Proficient / 🏆 Mastered)
  • Alert 系統:從 6 項合併為 5 項 Alert 1~5
    • Alert 1(⚠️ Warning: Active Rate < 60%)→ Alert 2(🔴 Critical: 完全不活躍 > 30%,覆蓋 Alert 1)
    • Alert 3(Session Mastery < 30%),Alert 4(Trophy Fail Rate > 50%),Alert 5(連續 14 天不活躍)
    • 全部 5 項閾值均為可配置參數(09-規則配置.md §7)

T-21 Individual Student Detail(擴充)

  • KPI Cards × 4(個人 Active Rate / Session Mastery / Questions Practiced / 單字累積量)
  • 新增:單字累積量、當前 vs 下個 Session、Session Mastery、Trophy 表現、Questions Practiced
  • Cognitive Distribution:Total / DH / SS + Level 選擇器
  • Top 10 Weak Items(錯誤單詞排行)
  • Session Config:Learning Start / End 可調,Learning Start 即 Mode 回溯邊界

A-01 Admin Dashboard(v4.0 重寫)

  • KPI Cards × 4(Total Users / Active Rate / Questions Practiced / Mastery Rate)+ vs 1 個月前對比
  • Class Analytics 三層 Drill-down:L1 All Category → L2 Single Category → L3 Single Level
  • 3 指標切換(Mastery / Active Rate / Questions Practiced),Y 軸平均值參考線
  • Cognitive Distribution 僅 L3 顯示

A-03 Admin Message Center(重構)

  • 從 4 分類 / 13 指標 → 5 分類 / 18 指標
    • ⚙️ System: API Latency, Server Load, Error Rate, Service Down, Peak Traffic
    • 📚 Academic: DAU Drop, Error Spike, T-01 Alert Escalated, Exam Fail Spike
    • 👥 Operations: Zone Status Change, Broadcast Sent, Batch Grade+1, Bulk User Import
    • 🔒 Security: Brute Force, Privilege Change, 2FA Failures(不可 Dismiss)
    • 📥 Import: Structure/Vocab Import, Exam Import
  • Security 保留天數由 config 控制,不可批量清除

2026/06/14 — 架構級變更

Figma 全面對應

  • 三端 Figma 覆蓋率:學生 72% → 教師 92% → 管理 92%(總體 85%)
  • 全部採用「組合拳」格式:文首快速對照表 + 🔗 Figma 直連 + <img> 截圖嵌入
  • 清除硬編碼色碼與 CSS 變數引用(DESIGN.md 僅保留理念參考)

11-Zulu收集系統.md → 整合

  • 新增 S-07 Mission / S-08 Zuzu Pedia 完整畫面章節
  • 5 Tab Bottom Nav(HOME / STUDY / MISSION / ZULU / SETTINGS)
  • EXP + Elalitte 雙積分制

DESIGN.md 清理

  • 從 02/03/04 三份畫面文檔中移除所有 --color-* / --gray-* / hex 色碼 / CSS class 名稱
  • 保留 Figma 連結與功能性描述

2026/06/14 — 文檔修正與補充

A-51 / A-91

  • A-51 Trophy Room Exam Import:替換截圖
  • A-91 Broadcast Modal:Admin(本校區)vs Super Admin(全校或指定校區多選)

T-10-A Schedule Planner(新增)

  • 新增 Schedule Planner Modal:Date + Interval(1/3/7/14/30 Days)+ Add Note(Skip)+ Skip List + Save
  • Lock/Unlock Toggle 支援手動切換與連鎖開啟邏輯

A-13 → A-12-A 重新編號

  • User Bulk Import 從 A-13 改為 A-12-AA-12 Create User 的批量版本)
  • 更新所有內部引用

A-10 User Migration

  • 新增 User Migration 功能:批量變更學生 School/Zone

10-盒子系統.md Mode 機制重構

  • 移除「當前 Level + 上個 Level」雙窗口模型
  • 改為單一 prev_session 回溯(Mode 1=2 sessions/Box≤2 … Mode 6=all/Box≤7)
  • 新增 T-21 Session Start 邊界約束

06-角色與權限定義.md

  • 從空殼重寫為完整 4 角色權限矩陣(Student / Teacher / Admin / Super Admin)
  • 覆蓋 66+ 畫面,7 條安全規則
  • Admin 可查看個別學習數據(A-11T-21)和班級數據(A-22T-01

08-數據收集.md

  • 重寫:隱私合規(COPPA/GDPR / S-05 家長同意 / 匿名化 / 12 個月保留 / 刪除權)
  • 資料來源:A-90 Data Export Center
  • 操作審計:關聯 A-03 Security

09-規則配置.md(10 章節完整版)

§內容參數數
1學生默認密碼2
2Mastery 計算係數(denominator coefficient = 0.9)1
3DH 題目抽取規則(Listening/Reading/Special Box)4
4SS 口說規則(Box 分佈 / 評分閾值 / Special Logic)3
5Leitner 盒子系統(Cooldown / Cognitive Weights)2
6Category/Level 結構 + Session Sort + Point Rewards3
7Alert 閾值配置(全部 5 項 Alert + A-03 Academic)12
8Mode 機制配置(prev_session + box_cap JSON)6 modes
9Active 行為定義(判定邏輯 + 關聯畫面)4
10Zuzu 收集系統配置(Daily/Weekly/Gacha/Comic 分組)13

2026/06/16 — 配置引用嵌入

畫面文檔織入伺服器端配置引用

在現有內容中就地添加指向 09-規則配置.md 的交叉引用,不另起附錄:

T-01 Teacher Dashboard

  • Active Rate 定義 → §9
  • Alert 1 (alert_1_active_rate_threshold / active_rate_window_days) → §7
  • Alert 2 (alert_2_inactive_threshold) → §7
  • Alert 3 (alert_3_mastery_threshold) → §7
  • Alert 4 (alert_4_trophy_fail_threshold) → §7
  • Alert 5 (alert_5_consecutive_inactive_days) → §7
  • 層級關係圖後備註:全部閾值由 Super Admin 在 §7 調整

T-21 Individual Student Detail

  • Session Config Learning Start → §8 Mode 回溯邊界
  • Active Rate 定義 → §9
  • 邏輯自我檢查 → §7(Alert)& §9(Active)

A-01 Admin Dashboard

  • Active Rate KPI / 定義 → §9
  • Class Analytics Active Rate(Zone/Class 級警告閾值)→ §7
  • 邏輯自我檢查:跨平台一致,伺服器端統一管理

A-03 Admin Message Center

  • Security 保留天數(alert_security_retention_days)→ §7
  • Bulk User Import(alert_import_failure_notify)→ §7
  • T-01 Alert Escalated → §7
  • 邏輯自我檢查 Security 保留天數 → §7

Zuzu 收集系統整合(11-Zulu收集系統.md → 尾聲)


文件結構一覽:

提交版本內容版本 29c89979提交 5ca7557規格文件,功能實現狀態另行確認