menu_book 數據字典

TryAI LiveRoom 平台數字說明 · 最後更新 2026-03-28

group 教室裡有哪些角色？

老師 — 建立這間教室的人。可以出題、管理學員、查看儀表板。排行榜上會看到「老師」的標籤。

助理老師 — 老師指定的幫手。擁有和老師一樣的管理權限（可以出題、編輯關卡），排行榜上標示「助理老師」。

學員 — 加入教室來學習和闖關的人。排行榜的名次只算學員。

簡單來說：老師和助理老師可以管理教室，學員專注闖關學習。

leaderboard 排行榜怎麼算的？

排行榜顯示教室裡所有人的闖關進度，但名次只算學員。

排名規則

按照「已完成的關卡數」由多到少排列。完成數相同時，按姓名排序。老師和助理老師會出現在排行榜上，但旁邊顯示 ★ 而不是名次數字。

舉例

老師完成了所有關卡，但第 1 名是小明，不是老師。

團隊排行：如果老師有設定「組別」功能，排行榜可以切換成團隊模式，按組別的平均完成率排名。

dashboard 儀表板數字怎麼看？

儀表板是老師的管理工具，所有數字只統計學員，不包含老師和助理老師的數據。

為什麼在線人數含老師？ 因為「在線人數」代表「教室裡現在有多少人」，是一個教室熱度指標。

學生總覽列表：表格中只列出學員，方便老師聚焦在學生的學習狀況。

wifi 在線人數是什麼意思？

排行榜區和儀表板都會顯示「N 人在線」。這個數字代表目前開著這間教室頁面的所有人，包含老師、助理老師和學員。當有人離開頁面，數字會自動更新。

可以把它理解為：現在教室裡坐了多少人。

school 證書發放條件

學員完成教室裡所有已發布的關卡後，就可以領取證書。

• 草稿狀態的關卡不算，只有「已發布」的才計入
• 證書上會顯示學員填寫的真實姓名和服務機關
• 日期使用民國年格式

小提醒：如果你還沒填寫「個人設定」裡的真實姓名，證書上會用你的帳號名稱。建議先到個人設定填好資料。

edit_note 草稿和發布的差別

老師可以先用「儲存為草稿」把關卡存起來，準備好再按「發布給全班」。發布後學員就能看到並開始闖關。

rooms/{roomId}/users/{uid}/
  ├── role: 'teacher' | 'student'
  ├── online: boolean
  ├── isGuest: boolean
  ├── softDeleted: boolean
  ├── completed: { challengeId: true, ... }
  └── ...

rooms/{roomId}/meta/
  ├── createdBy: uid  ← 教室建立者
  └── ...

isCreator = (roomMeta.createdBy === currentUser.uid);

if (isCreator) isTeacher = true;
else if (existing.role === 'teacher') isTeacher = true;  // 助理老師
else isTeacher = false;  // 學員

// UI: isCreator ? '你是老師' : isTeacher ? '你是助理老師' : '闖關進行中'