A-90 Data Export Center
內容依原始規格呈現 · 查看 Markdown 來源 ↗需具備倉庫查看權限
數據導出中心
🎨 Figma: node-4153-12967 🔗
🎯 功能定位
使用者： Admin / Super Admin
A-90 用於提取平台底層數據。分為兩大類：
- 用戶使用數據 (Usage CSV)： 用於分析學生群體的學習進度與盒子分佈。包含學生的每個 level 每個 session 的單字分別在哪個 box 的現在狀態（數量），同時列出 box0 和 box1 的所有單字。
- 語音研究數據 (Voice ZIP)： 包含原始音檔與標籤（Metadata），供 AI 模型訓練與發音診斷使用。
Super Admin / Admin 都有導出權限。
🧱 畫面結構
| 區域 | 說明 |
|---|---|
| Header | Nihao Admin Dashboard > Data Export Center, [👤] |
| 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 欄位說明 🆕
| 欄位 | 說明 |
|---|---|
student_id | 學生唯一 ID |
level | 當前 Level |
session | 當前 Session |
box_0 | Box 0 內的所有單字列表（逗號分隔） |
box_1 | Box 1 內的所有單字列表（逗號分隔） |
box_2 ~ box_7 | 各 Box 內的單字數量 |
total_vocab | 該 Level/Session 總單字數 |
Box 0 和 Box 1 列出所有單字內容（非僅數量），方便管理員分析未掌握與初步掌握的單字。
🔁 交互流程圖
正在載入流程圖…
⚙️ 開發邏輯與安全更新
| 規則 | 說明 |
|---|---|
| 區域限制 (Zone Isolation) | Super Admin 可導出所有數據；Admin 僅能看到並導出其所屬 Zone 的數據。 |
| 異步處理 | 大數據量導出採用後端異步任務，前端輪詢進度。 |
| 任務追蹤 | 歷史紀錄含 Task ID, Type, Zone/Class, Status (Done/Processing/Waiting)。 |
🔎 邏輯自我檢查
- 按班級分的實用性： 語音研究現在可以針對「特定老師帶出來的學生口音」或「特定校區的環境噪音」進行對比。
- 區域權限： 已加入 Zone 限制，符合補習班體系連鎖經營的資料安全規範。