完整文件履歷

第一版式樣草案 · Markdown 來源：01-履歷.mdGitHub 版本尚未推送；目前以本機手冊為準

2026/10/23 — 多階段閱讀與驗收

• 依核准標記遷移 29 個第二階段畫面，12～15 加全文件階段標記；完成 00、05、06（含 6.3）、08、09、DESIGN、02 虛擬銀行通則、03 T-50 經濟分頁及流程索引的階段區塊。
• 補齊 S-10 存摺、A-11 肖像同意與家長帳號標記，以及 T-01、A-01、A-20、A-30、S-11、S-20 的第二階段入口；修正 T-04-A 引用、S-08 自動連結及 07 範圍項目階段標記。
• 新增全站階段切換、累積畫面／本階段改動、階段總覽與變化時間線；目錄、系統地圖與流程同步依階段顯示，後續內容收為提示。第三階段以後先登記再使用。
• 新增標記格式、畫面編號與已驗收內容凍結檢查；驗收標籤尚未建立，凍結待確認後啟用。工程驗證與限制見內部進度記錄。

2026/10/22 — 第二階段：接送與點名、電子聯絡簿、虛擬銀行

• 新增家長端（G-00～G-05，LINE 手機網頁）與 29 個畫面：學生端 S-100～S-105、教師端 T-05／T-06／T-07／T-100～T-103、管理端 A-02／A-24／A-34／A-100～A-106；T-50 加「經濟」分頁，A-11 補充肖像權與家長帳號。全部標「原型待補」，Figma 未修改。
• 新增規則文件：接送與點名規則、電子聯絡簿規則、虛擬銀行規則；更新 05、06、07、08、09。
• 範圍調整：家長端由首版範圍外改為第二階段提供；服藥與代收紀錄刪除；Q幣與 Diamond 分開；負債利息改為每週單利並設上限；外匯採臺灣銀行牌告匯率與固定報價單位。
• ERP 介接契約、LINE 官方帳號連結、匯率下載條款與同意書保存期限仍待確認。以上是產品規格，不代表功能已實作。

2026/10/18 — 耶加 APlus 第一版式樣

• 以耶加英語核心班整理三端規格，ERP 管理名冊／請假／收費，APlus 管理學習與成果；名冊首版人工匯入，API／SSO 仍待契約。
• 統一 APlus、Animal Friends、Diamond 及 Word／Phrase／Sentence；英語內容、題型、匯入欄位與語音回饋同步改寫。課程表、檢定分類與 ASR 評分門檻仍待正式資料。
• 從 QL APP 只讀匯出真實截圖與節點樣式；不同之處照實展示並標「設計稿待更新」。無獨立 Frame 者標「原型待補」。Figma 未修改。
• 第一版為本機產品手冊；GitHub 推送、正式部署及三端業務 App 開發尚未完成。
• 以下 2026/09/25 及更早履歷為 Nihao 來源歷史，涉及華語、HSK／YCT、Zuzu 等舊名稱時以本版現行正文為準。

2026/09/25 — 班級教學目標與代理登入老師

• T-01 在頁頭與 KPI 之間顯示只讀 Class target，標出該班的 Category 與 Level。未設定時顯示 Course not assigned，不混算學生各自的 Level。T-10、T-30、T-40 頁頭仍只顯示班名。
• A-10 與 A-11 Teacher 新增 Sign in as teacher。Super Admin 可進入任何 Active Teacher；Zone Admin 只可進入全部 Academy Zone 都在自己負責範圍內的老師。
• 代理工作階段獨立存在，60 分鐘到期，不讀取或修改老師密碼。可做該老師的排課、推送、廣播與 T-21 學習範圍調整；不可改老師個人資料，也不開放 T-43、A-52、A-90 導出。
• 以上仍是產品規格。Figma 與三端業務實作尚未修改。

2026/09/07 — 第 3 項改為原列表停用／重新啟用

• 第 3 項正式路徑改為 Disable → 原列表篩選 Disabled → Re-enable；A-10／A-11／A-13／A-14 不再放置 Move to Recycle Bin 當期按鈕。
• A-15、30 天保留與到期清理維持後續候選；重新啟用不自動恢復舊權限或連鎖啟用下屬 School／Class／User。
• 第 1／2／4／5／6 項規格不變。

2026/09/07 — A-51 最小修改與六項範圍收斂

• A-51 保留原有單一彈窗、Basic Settings、19 欄 CSV、Audio／Image ZIP、邏輯預覽與 Cancel／Submit；撤回四份 CSV、手填版本、Source Mapping 介面與逐 Section 策略。
• 真實題庫尚未提供，先核實缺欄，再決定是否最少追加；不預先新增必填欄位或宣稱無損。
• S-31 沿用原聽力播放與答題流程；一份 Exam 仍是一個 Challenge／整卷 Result。EXP 維持三模組答對 1 題 10 EXP，重考可重複獲得，獎盃仍只發一次。
• A-50 先增加班級聚合 CSV，沿用原列表；完整 A-52、A-15 回收站、30 天自動清理、T-43 Teacher-only／15 分鐘下載均不作本次必做需求。
• 所有修改仍是產品規格，Figma、真正的產品實作及題庫驗收尚未完成。

2026/09/05 — 六項方案二次審核

歷史記錄。A-51 的 v2／Legacy 方案已由 2026/09/07 最小方案取代；回收站與導出期限、角色仍為候選。

• A-21／A-23 老師指派共用資格，保留同 Zone 跨 School 行為；CSV 範例改與正文一致並標記示意資料。
• A-51 補回 Legacy 19 欄完整對照、題型阻擋與不可變 Exam 版本；多選、輸入、題組共用素材與計時仍列待確認。
• T-40 未到期且仍可重考時不提前歸檔；A-52 明細篩選不改分母，跨班先加總再計算比例。
• A-52／T-42／T-43 不再以 5 人門檻當匿名保證；補永久刪除後的聚合驗證與抑制邊界。
• 區分 A-10 學生遷移與 A-14 School 遷移。
• EXP 改回三模組答對 1 題 10 EXP；重考依當次答對題數重複獲得，Trophy 獎盃仍只發一次。
• 30 天恢復、15 分鐘下載及 Teacher-only 導出標記為候選決策；修正「文件檢查通過即全部跨端完成」的過度結論。

---

2026/09/03 — 管理員六項問題規格對齊

歷史提案，不是完整的當前交付範圍。四份 CSV／策略引擎已撤回；A-15、完整 A-52、30 天及 Teacher-only／15 分鐘方案依 2026/09/07 記錄列後續候選。

班級導入與帳號規則

• A-23 Class Bulk Import 新增 teacher_emails，定義多位老師、權限範圍、舊 7 欄模板相容與關聯寫入規則。
• status 固定為 Active／Inactive，空值預設 Active，並補齊 Inactive 的可見、派送與歷史行為；Class 導入改為原子交易。
• A-23 不包含生日；A-12／A-12-A 生日統一 YYYY-MM-DD，嚴格驗證格式、真實日曆與未來日期。

刪除安全與恢復

• 新增 A-15 Recycle Bin & Recovery，統一 Remove from Class、Disable、30 天軟刪除、Restore 與 Permanent Delete。
• Student、School、Zone 的刪除權限、依賴守衛、審計與隱私永久刪除例外完成對齊。

管理介面入口

• A-50 將分類入口明確命名為 + Category，考試導入入口命名為 + Import Exam。
• A-22 Student List 新增 View Analysis，連到 A-11 Learning Analytics，並保留班級與返回上下文。

Trophy Import 與完成度

• A-51 新增 Exam_Bundle_v2.zip 正規化格式及 Legacy 19 欄 Adapter；補齊 Legacy Basic Settings、Source Mapping、Section 導航與暫停策略；原始檢定題庫逐欄 Mapping 仍待真實樣本驗證。
• Trophy 模型統一為一個 Exam 包含多個 Section；一次教師派送只建立一個 Challenge，學生產生一份整卷 Result；重考只更新 Effective Result，Trophy 獎盃不重複發放，EXP 依當次答對題數重複獲得。
• 新增 A-52 Trophy Exam Detail & Class Analytics，完成度分母固定取派送時 Snapshot，並提供限 Zone、可審計且不含逐學生身份的 Trophy 聚合 CSV。
• T-43 逐學生矩陣導出只開放仍被指派該班的 Teacher，採欄位白名單、刪除隱私處理、雙重驗權、15 分鐘短效下載與 Audit。

---

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-A（A-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-11→T-21）和班級數據（A-22→T-01）

08-數據收集.md

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

09-規則配置.md（10 章節完整版）

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

• 全部內容整合至 02-App畫面-學生.md S-07/S-08 + 09-規則配置.md §10
• 11-Zulu收集系統.md 添加已整合說明，保留原始需求為存檔

---

文件結構一覽：

• 01-履歷.md — 變更履歷（本文件）
• 02-App畫面-學生.md — 學生端畫面設計
• 03-App畫面-教師.md — 教師端畫面設計
• 04-App畫面-管理員.md — 管理員端畫面設計
• 05-AI-外部服務範圍定義.md — AI / 外部服務
• 06-角色與權限定義.md — 權限矩陣
• 07-範圍外.md — 非本次開發範圍
• 08-數據收集.md — 隱私與數據收集
• 09-規則配置.md — 伺服器端參數配置（10 章節）
• 10-盒子系統.md — Leitner 盒子機制
• 11-Zulu收集系統.md — Zuzu 收集系統（已整合，保留存檔）
• index.md — 畫面索引總表
• pic/ — 截圖目錄