產品整體設計
第一版式樣草案 · Markdown 來源：00-整體設計.mdGitHub 版本尚未推送；目前以本機手冊為準
產品定位與語言
本倉庫提供 APlus／耶加 APlus 的產品規格與文件網站，不代表學生端、教師端、管理員端、後端或 ERP 串接已實作。本文列出首版有效規格；尚未定案的資料與產品決策均標示為「首版建議／待確認」。
- 學生介面使用英文。
- 教師與管理員介面提供 English／繁體中文切換。
- 家長端（第二階段）與虛擬銀行畫面只使用繁體中文；家長端以 LINE 內的手機網頁開啟。
- 首版學習內容為英文；可按課程內容提供中文釋義，中文釋義是否逐項提供由正式教材確認。學生學習介面不顯示拼音或音標。
- 學習內容分類使用 Word／Phrase／Sentence。練習包含英語字母拼字與單字排句；不包含中文筆順。
- 學生主導航五個 Tab：HOME／STUDY／MISSION／FRIENDS／SETTING。
- 動物收藏與故事模組稱為 Animal Friends；任務獎勵使用 Diamond。
課程內容與校務邊界
課程結構採可配置的 Category → Level → Session → Word／Phrase／Sentence。各層名稱、數量、Session 排序與每學期長度均以耶加正式課程表為準；目前未取得正式表，不固定舊有 NH／EK／ES 分類，也不預設每個 Level 有 16 個 Session。FAD／FLD／FPG 僅為首版示例，正式分類與 Level 對照待確認。
耶加目前列出的服務據點為文府總校、龍華校、左新校；校區正式資料與行政層級名稱待校方確認。首版建議先由管理員匯入名冊，再於 APlus 管理班級與學習指派；不得描述為 ERP API 已接通或即時同步。
- ERP 負責： 校務名冊、請假、收費。
- APlus 負責： 英語學習內容、練習派送與結果。
- ERP 與 APlus 的資料交換方式、登入整合及同步頻率均待確認。
第二階段範圍（規格草案）
第一階段專注英語學習。第二階段新增三個營運模組與家長端，這些內容是規格草案，不代表已實作；尚無 Figma 畫面的項目標「原型待補」。
| 模組 | 內容 | 使用者 | 畫面 | 規則文件 |
|---|---|---|---|---|
| 接送與點名 | 到校點名、預約協商、鎖定、離校與授權接送人 | 教師、管理員、家長 | T-05、T-06、A-02、A-24、G-01～G-03 | 接送與點名規則 |
| 電子聯絡簿 | 老師發布、家長簽名、作業統計與 Q幣獎勵 | 教師、管理員、家長 | T-07、A-34、G-04 | 電子聯絡簿規則 |
| 虛擬銀行 | Q幣、薪資、負債利息、外匯、定存、排行與稽核 | 學生、教師、管理員 | S-100～S-105、T-100～T-103、A-100～A-106 | 虛擬銀行規則 |
| 家長端 | LINE 手機網頁：登入綁定、孩子狀態、預約、聯絡簿、訊息 | 家長 | G-00～G-05 | 家長端畫面 |
- ERP 邊界： ERP 仍負責名冊、請假、收費與正式出缺勤；APlus 只記錄接送與點名事件。介接契約確認前沿用人工匯入。
- 貨幣： Q幣與 Diamond 分開管理，Q幣不能兌換現金，只能兌換實體獎品。
- 通知： 一般通知只寫入家長端信息中心，不使用 LINE 推播；緊急事件另可推播，額度待確認。
- 共用 QR 卡： 接送與銀行共用同一張學生 QR 卡，補發沿用原碼。
學習功能
Discovery Hub（識別與理解練習）
以英文 Word／Phrase／Sentence 為練習內容，涵蓋聽力、閱讀理解、英語字母拼字與單字排句等題型。題目依盒子系統的既有抽題與回饋算法產生；本文件不變更其流程算法。中文釋義可作輔助理解資訊，首版不顯示拼音或音標。圖像選項只提供視覺線索，不得直接呈現英文正解。
Speak Studio（英語發音練習）
學生朗讀英文 Word／Phrase／Sentence，並可使用求助播放標準發音。系統記錄作答與發音回饋；不以中文聲調作判定。語音辨識、發音評測供應商尚未選定，首版規格只定義供應商中立的輸入、判定與回饋流程，不宣稱已接入特定服務。
Trophy Room（檢定練習與結果）
檢定分類採可配置英文分類。Cambridge YLE Starters／Movers／Flyers 僅作首版候選範例，分類、內容來源及可用範圍均待正式確認；不得宣稱已有正式授權題庫或認證評分。一份 Exam 可含多個 Section；教師派送建立一個 Challenge，學生完成一次整卷 Attempt 並產生一份 Result。Section 不得拆成獨立 Challenge。完成度分母取派送當下的學生 Snapshot，避免名冊變更造成歷史報表漂移。欄位、題型與報表算法沿用既有規格，與實際題庫的對應仍待核實，詳見 A-51／A-52。
複習與掌握度
複習功能沿用 Discovery Hub 的既有盒子抽題機制；是否可選擇已學過的 Level，依正式課程與教師指派規則確認。盒子進階、冷卻、掌握度及重考積分算法保留既有定義；P／B 對照與任何未正式確認的資料標示「首版建議／待確認」，不據此推定資料欄位或算法已定稿。
保留的有效學習與營運規則
下列規則由既有產品需求沿用，英文化不改變其業務含義、計算口徑或流程算法；與正式課程表、資料實作或未決配置相關的部分，另標示待確認。
課程範圍與教師操作
- 課程可包含多個 Category、Level 與 Session。教師及學生分析可在有資料且有權限的範圍內查看／選擇多個 Level；不得把分析範圍默認縮成單一 Level。實際 Category、Level 名稱與課綱數量依正式課程表確認。
- 教師在排課／進度管理中手動指定班級的 Current Session；學生出題從該 Current Session 開始，並受該學生設定的 Learning Start 回溯邊界限制。班級 Current Session、學生 Enrollment Session、Learning Start 與 Learning End 各有用途，不互相替代。各 Level 之間的先後排序與跨 Level 回溯依課程結構配置；若正式課綱尚未提供，該映射待確認。
- 教師排期可設定 Start Date、Interval 與多筆
Skip日期／備註。每筆 Skip 會略過對應排期並按既有公式位移後續 Session；刪除 Skip 則回推後續日期。已解鎖 Session 不可再 Skip。首次排期沒有預設日期或 Interval，由教師手動設定。 - Skip 日期只從 Alert 5「連續未練習」期間計算中排除；不改變 Active Rate、Mastery、Questions Practiced、練習記錄或其他統計口徑。
抽題、盒子、作答與積分
- Discovery Hub 與 Speak Studio 各自使用既有抽題配置；保留 Box 0–7、Special Box、冷卻時間、認知權重、Mode 1–6、回溯 Session 範圍、Box 上限、學生獨立 Mode、Session Start 截斷邊界及既有排序／升級條件。算法詳見 09-規則配置.md 與 10-盒子系統.md；本輪英語內容改寫不重定算法。
- Discovery Hub 保留既有 3－3 滑動窗口、聽力／閱讀題型、二選一和錯題回饋流程。圖卡只呈現視覺線索，不直接露出英文答案。正式英文內容以 Word／Phrase／Sentence 編排；中文只作釋義，不顯示拼音、音標或中文筆順。
- Speak Studio 保留原有 S1／S2／S3／QA 任務順序、求助播放、重試、Skip、錯題及 Special Box 流程；回饋目標改為英文發音表現，不判斷中文聲調。原規則中互有差異的重試次數、連錯門檻及特殊盒觸發條件沿用既有配置定義；若未能由 09-規則配置.md／10-盒子系統.md 唯一判定，列為「首版建議／待確認」，不得在畫面文案另造門檻。語音供應商未定。
- EXP 不因品牌或語言改版而變更： Discovery Hub、Speak Studio、Trophy Room 各模組每答對一題得 10 EXP；Trophy 重考按當次答對的非例題數重複計 EXP。Exam 分數另按題目 Points 計算；Trophy 獎勵仍按每個 Challenge／學生唯一發放，不因重考重複發放。
- Trophy 一份 Exam 可含多個 Section；教師一次派送只建立一個 Challenge，學生完成整卷產生 Attempt 與 Result，Section 不拆成 Challenge。分母使用派送瞬間建立的學生 Snapshot；同一 Snapshot Member 多次 Attempt 仍只計一人。Effective Result 取已提交 Attempt 最高分，同分取最新；名冊轉班／離班不改寫派送分母。T-40／T-42／A-52 共用既有口徑與隱私抑制規則。
- 導入保留 Structure 與 Vocabulary 先後依賴、NEW／SKIP／UPDATE／ERROR 預檢。既有架構 ID 已存在時標記 SKIP，不覆蓋名稱；Vocabulary 以內容與類型比對，完全一致 SKIP、有變更 UPDATE，歸屬不存在的 Category／Level／Session 或必要媒體缺失依既有規則報錯。英文 Word／Phrase／Sentence 與中文釋義的實際欄位映射待工程契約確認；舊 CSV/schema 欄名僅作相容識別，不代表學生畫面顯示拼音。
權限、名冊與未定資料
- ERP 負責名冊、請假與收費；APlus 負責英語學習內容、排課／指派、練習與結果。首版建議由管理員先匯入名冊；不得宣稱 ERP API、即時同步或共用登入已接通。耶加三校區為文府總校、龍華校、左新校；三校與 Zone／School 行政資料映射待校方確認。
- 檢定分類採可配置英文分類。Cambridge YLE Starters／Movers／Flyers 僅為首版候選示例，實際分類、內容來源、授權與評分依據待確認；不宣稱正式授權題庫或認證評分。
- 決策清單中尚待確認的產品／業務選項；FAD／FLD／FPG 與課程表的對照；跨 Level 的先後／回溯映射；語音評分門檻與供應商；ERP 資料交換與登入方式；初始化憑據、重設與密碼政策，均屬「首版建議／待確認」。不得將舊 NH／EK／ES、HSK／YCT、16 Levels／每 Level 16 Session 或生日推算密碼當作現行產品規則。
登入、設定與安全
- 帳號由管理員建立，學生不自行註冊的方向作為首版建議，帳號政策仍待確認。
- 不公開可由生日推算的預設密碼，也不在畫面、CSV 範例或通知中顯示密碼生成公式。首版建議由管理員透過受控管道發送初始憑據，使用者首次登入後強制修改；憑據有效期、重設方式、密碼政策與驗證步驟待確認。
- S-40／S-41 為個人頁相關畫面，目標 Frame 為
493:126；個人頁右上角齒輪進入 Settings。設定鎖定／解鎖目標分別為8194:6214／5957:954，S-45 鎖定輸入目標為5952:758。 - 語音同意與個人資料處理方式需依正式隱私條款確認；不以同意訓練作為預設前提。
積分與 Animal Friends
保留既有 EXP 計算機制作為首版規格基礎：Discovery Hub／Speak Studio／Trophy Room 每答對一題 10 EXP；Trophy 重考依當次答對題數計算，Trophy 獎勵仍依 Challenge 與學生唯一發放。MISSION 的任務條件、獎勵數量、Diamond 價格與 Animal Friends 收藏數量均由配置提供；正式數值待確認，不以舊版數字視為已定案。
教師與管理員職責
教師端負責查看班級進度與學生練習結果、安排學習 Session、派送檢定練習與追蹤結果。管理員端負責名冊匯入、班級與課程結構管理、學習內容匯入、規則配置及檢定內容管理。各項畫面及流程是規格草案，不代表相關業務系統已開發或資料已同步。
首版未確認資料
- 產品／業務決策清單中的待確認欄位與選項：首版建議／待確認；P-xx／B-xx 是決策編號，不是優先等級或課程代碼。
- FAD／FLD／FPG 與正式課程表、Level／Session 數：待確認。
- Cambridge YLE 範例的實際採用、題庫授權與評分依據：待確認。
- 語音辨識與發音回饋供應商、能力及採購：待確認。
- ERP／APlus 資料交換、帳號整合及同步方式：待確認。
- 初始憑據發放與密碼安全策略：首版建議／待確認。
- 檢定原始題庫、欄位映射、題型支援與可發布範圍：待正式資料確認。