A-90 Data Export Center
- P1新增 +1移除 −0
第一版式樣草案 · Markdown 來源：04-App畫面-管理員.mdGitHub 版本尚未推送；目前以本機手冊為準
取圖紀錄： QL APP，2026-10-18，版本
2410774734466577464；節點 4153:12967 。學生 2x／Web 1x。圖片是目前設計稿，文字為 APlus 首版目標規格。 設計稿待更新（F-35）： 圖中舊品牌、華語內容或待核對項目照實保留；請以本節英語文字規格為目標。設計修改後重新取圖。
數據導出中心
🎨 Figma: node-4153-12967 🔗
🎯 功能定位
使用者： Super Admin（僅 Super Admin 可建立、查看、下載或管理 Export Request）
A-90 用於提取平台底層數據。分為兩大類：
- 用戶使用數據 (Usage CSV)： 用於分析學生群體的學習進度與盒子分佈。包含學生的每個 level 每個 session 的單字分別在哪個 box 的現在狀態（數量），同時列出 box0 和 box1 的所有單字。
- 語音研究數據 (Voice ZIP)： 包含原始音檔與標籤（Metadata），供 AI 模型訓練與發音診斷使用。
權限限制： A-90 的入口、研究使用／原始語音 Export Request 建立、歷史紀錄、下載、取消與重試均僅開放 Super Admin。Admin 不顯示 A-90 入口，也不可透過其他管理頁面取得此類底層資料；A-52 的 Trophy 校務營運 CSV 是獨立、限欄位且限 Zone 的例外，不授予 A-90 權限。
🧱 畫面結構
| 區域 | 說明 |
|---|---|
| Header | APlus Admin Dashboard > Data Export Center, [👤 Super Admin] |
| Sidebar | [📊 Export Usage Data], [🎙️ Export Voice Data] |
| Export Parameters | Date Range, Zone, Class, Gender, Age Range |
| Create Export Task | 按鈕 |
| Recent Export Tasks | Task ID, Type, Zone/Class, Status, Action [Download] |
📦 區塊說明
| 區塊 | 元件 | 功能與行為描述 |
|---|---|---|
| 地理篩選 | Zone (區域) | 根據管理員權限顯示區域。選擇後，下方的班級選單會自動更新。 |
| 班級篩選 | Class (班級) | 支援「全選」或「多選」特定班級。 |
| 人口統計 | Gender, Age Range | 選擇性別與年齡區間。 |
| 任務追蹤 | Zone/Class Info | 在歷史紀錄中明確標示該數據包所屬的區域與班級。 |
| Usage Data | CSV Download | 包含學生學習進度、盒子分佈數據。支援學生單位 (per-student) 導出。 |
| Voice Data | ZIP Download | 包含原始音檔與 Metadata。 |
Usage CSV 欄位說明 🆕
| 欄位 | 說明 |
|---|---|
school_student_id | 學校提供的學生管理編號，供 Super Admin 進行校務對照；與 APlus internal UUID 分開 |
level | 當前 Level |
session | 當前 Session |
box_0 | Box 0 內的所有單字列表（逗號分隔） |
box_1 | Box 1 內的所有單字列表（逗號分隔） |
box_2 ~ box_7 | 各 Box 內的單字數量 |
total_vocab | 該 Level/Session 總單字數 |
識別欄位分層： APlus internal UUID 是系統內部識別，不得與 School Student ID 混用；Voice ZIP 與研究用途匯出使用
anonymous_export_id，不帶出 School Student ID 或 internal UUID。若後續需要匿名欄位，應明確命名為anonymous_export_id，不得沿用含義不明的student_id。
Box 0 和 Box 1 列出所有單字內容（非僅數量），方便管理員分析未掌握與初步掌握的單字。
🔁 交互流程圖
正在載入流程圖…
⚙️ 開發邏輯與安全更新
| 規則 | 說明 |
|---|---|
| 權限限制 (Export Request) | 僅 Super Admin 可進入 A-90、建立／查看／下載／取消／重試 Export Request；Admin 不可使用。 |
| 區域限制 (Zone Isolation) | Super Admin 可導出所有數據，並在建立 Export Request 時選擇適用的 Zone／School／Class 範圍。 |
| 異步處理 | 大數據量導出採用後端異步任務，前端輪詢進度。 |
| 任務追蹤 | 歷史紀錄含 Task ID, Type, Zone/Class, Status (Done/Processing/Waiting)。 |
🔎 邏輯自我檢查
- 按班級分的實用性： 語音研究現在可以針對「特定老師帶出來的學生口音」或「特定校區的環境噪音」進行對比。
- 權限閘口： A-90 全部操作僅 Super Admin 可用，Admin 不可見且不可透過 A-52 或其他入口取得 A-90 的研究／語音資料。
- 區域權限： Super Admin 可在 Export Request 中指定 Zone／School／Class 範圍，符合補習班體系連鎖經營的資料安全規範。