Reclaim2K · CNEC 中華傳道會劉永生中學
教師及學校管理員手冊
Teacher & School-Admin Manual
教師介面功能總覽 + 設定指南（含:如何為每班設定密碼）· All teacher functions + setup guide, including how to set a password for each class.
給校長 / 副校長 / 宗教科統籌 / IT 及班級老師 · 查詢 reclaim2k@lws.edu.hk · 核對日期 Audited 2026-07-18
1 · 系統架構（一分鐘看懂）· How it fits together
Reclaim2K 用 Google Sheet 作後台,分兩層:
- 中央目錄（本校 CNEC 管理）—— 存放所有學校名單、每校的 4 位數「學校密碼」、以及指向各校自己 Sheet 的連結。學校要出現在 App 下拉選單,必須先在此登記。
- 每校自己的 Google Sheet —— 每間學校有自己的 Sheet(+ 一份部署好的 Apps Script Web App)。老師密碼、班級密碼、學生名冊全部存喺呢度,由學校自己掌管。
重點: 4 位數「學校密碼」由本校 CNEC 發出（中央目錄）;老師密碼、班級密碼、學生名冊則由貴校在自己的 Sheet 設定。
2 · 五種登入憑證 · The five credentials
| 憑證 Credential | 邊個用 Who | 點驗證 How | 邊度設定 Where |
|---|
| ① 學校 4 位數密碼 School access code | 所有人（每部裝置一次） | 對中央目錄逐字比對（明文） | 本校 CNEC 發出 |
| ② 老師密碼 Teacher PIN（全校 / 管理員） | 學校管理員 | 瀏覽器 SHA-256 → 對本校 Sheet | 貴校自設（App 或 Sheet 選單） |
| ③ 班級密碼 Class PIN（每班一個） | 班級 / 宗教科老師 | SHA-256 → 對本校 Sheet（班級範圍） | 管理員在教師介面設定 |
| ④ 清除密碼 Erase PIN | 學校管理員 | SHA-256 → 對本校 Sheet | 貴校自設（與老師密碼不同） |
| ⑤ 學生登入（班別+學號+出生日期） | 學生 / 家長 | 對學生名冊核對出生日期（無密碼） | 貴校在 Students 分頁輸入 |
另有:超級管理員權杖 super_admin_token（本校為每校產生的復原碼,用來重設忘記的密碼);以及可選的登入電郵 2FA（在 Sheet 加一行 2fa_email 即啟用,登入時發 6 位數電郵驗證碼,10 分鐘有效）。
3 · 如何進入教師介面 · Getting to the teacher screen
- 開啟 App → 揀學校 → 輸入 4 位數學校密碼（每部裝置一次）。
- 喺登入頁,打開「教師入口 Teacher Portal」（如未見,連按底部版本號 5 下即會出現）。
- 揀你的角色:
- 學校管理員 School Administrator —— 全校範圍,可設班級密碼、清除資料。
- 班級 / 宗教科老師 Class / RS Teacher —— 只看自己一班。
- 靈修小組 Devotion Group —— 教會 / 朋輩 / 家長小組長模式（與學校登入無關）。
- 輸入密碼登入。管理員入②老師密碼;班級老師入③班級密碼（用同一個密碼欄,系統自動分辨範圍）。
首次設定: 若學校未設老師密碼,登入時 App 會自動帶你到「首次設定」,要求同時設定「老師密碼」和「清除密碼」（兩者不可相同,各需 8 位以上,含大細楷 + 數字）。
忘記密碼: 用本校 CNEC 提供的 super_admin_token 經「忘記密碼」重設;或由管理員在 Sheet 的 Credentials 分頁清空該密碼格。
4 · 教師介面全部功能 · Every function on the dashboard
登入後是一頁式儀表板（向下捲動,無分頁）。由上而下:
- 密碼年齡提示 —— 密碼用超過 90 日會提示更換。
- 統計列 —— 全校 HFC 總額、學生總數、已參與人數（HFC>0）、平均 HFC。班級老師只看自己一班。
- 幸福感問卷（研究） —— 前測 / 後測分享連結（可複製、可預覽,WHO-5 + SAS-SV）;「查看結果」顯示去識別化的前後測平均值。
- 頒發獎勵 Award HFC —— 揀學生 → 金額（20/50/100/200）→ 頒發。受每人每日 HFC 上限限制。這是老師版的「鼓勵」;貼紙功能屬家長專用。
- 學生一覽 —— 班別篩選 + 姓名搜尋;HFC 排行表（最多 100 行）。
- AI 相關教案 —— EDB「AI 賦能教育」計劃（EDBCM 25/221）資訊頁。
- 班級 / 宗教科老師密碼（僅管理員）—— 見第 5 節。
- 更改密碼 —— 🔐 老師密碼 / 🔴 清除密碼 兩個分頁。
- 數據保護 · 清除所有資料（僅管理員）—— 需④清除密碼 + 兩次確認。
- 登出。
另一種角色:靈修小組長模式（獨立）
由「靈修小組」登入卡進入。可建立小組、產生 6 位數邀請碼、分享 WhatsApp 邀請、查看成員、給成員鼓勵貼紙。適合教會 / 朋輩 / 家長 / 師友小組。
不在教師介面內（在 Sheet 或由本校 CNEC 處理）
- 編輯 F.1–F.6 靈修 / 默書計劃 —— 在 Sheet 的 Dictation 分頁。
- 推送通知、家長活動 ParentTalks —— 在 Sheet 設定。
- 社群作品審批（Suno 歌、遊戲、見證）—— 由本校 CNEC 超級管理員審批後才公開。
5 · 如何為每班設定密碼 · How to set a password for each class
這是學校最常問的一項 —— 功能真實存在。 一個班一個密碼:班級老師用該密碼登入後,只看到自己一班的學生。
設定步驟 Steps
- 以「學校管理員」身分登入（必須是全校範圍;班級密碼管理只對管理員顯示）。
- 在儀表板找到「📚 班級 / 宗教科老師密碼 Class / RS Teacher PIN」卡。
- 剔選一個或多個班別（例如 1A、1B）。
- 輸入密碼（8 位以上,含大細楷 + 數字）,或按「自動 Auto」產生（格式如
1AT4821）。
- 按「確認設定 Set PIN」。系統把密碼（只存雜湊）寫入本校 Sheet,並在畫面顯示一次明文密碼 —— 抄低交畀該班老師。
- 該班老師之後在教師登入頁用這個班級密碼登入,就只看到自己一班。
要每班不同密碼?
若一次剔選多班並用同一個密碼欄,系統會把相同密碼寫入每一班。想每班不同,請逐班（或逐批）分開設定不同密碼。
查看 / 移除班級密碼
同一張卡會列出已設定的班級密碼;每行有「移除 Remove」可刪除該班密碼。
儲存位置: 班級密碼以 <班別>_pin_hash（例如 1A_pin_hash）存於本校 Sheet 的 Credentials 分頁,只存雜湊,永不存明文。
6 · 設定 / 更改 老師密碼與清除密碼
- App 內: 儀表板「更改密碼 Change PIN」→ 揀「老師密碼」或「清除密碼」分頁 → 輸入舊 + 新密碼 → 更改。
- Sheet 內（另一途徑）: 打開學校 Sheet → 選單「🛠 Reclaim2K → ② 設定老師密碼」,系統會加密後寫入
teacher_pin_hash。
- 首次設定: 見第 3 節（同時設老師密碼 + 清除密碼）。
7 · 學校自行處理 vs 需要本校 CNEC 協助
需要本校 CNEC（中央）協助的一次性開通
- 發出 4 位數「學校密碼」。
- 把學校加入 App 下拉目錄（active=TRUE）。
- 為學校建立專屬 Google Sheet,並部署 Apps Script Web App（執行身分:我;存取:任何人）。
- 產生
super_admin_token（復原碼）。
學校可自行處理（Sheet 及密碼建立後）
- 一鍵建立所有分頁:Sheet 選單「🛠 Reclaim2K → ① 建立 / 修復所有分頁」—— 自動建立 Students、Credentials 等,無需手動開欄。
- 設定 / 更換 老師密碼、清除密碼。
- 為每班設定 / 移除密碼（第 5 節）。
- 輸入學生名冊（Students 分頁）。
- 可選:加
2fa_email 啟用登入 2FA。
想加入 Reclaim2K? 電郵
reclaim2k@lws.edu.hk（App 內「電郵申請加入」按鈕會自動開啟一封已填好範本的電郵）。個別學校難以自行用 Google 表單完成 Sheet 設定,故一律改用電郵,由本校協助開通。
8 · Google Sheet 分頁參考 · Sheet tabs reference
Credentials 分頁（key | value）
| key | 意思 Meaning |
|---|
teacher_pin_hash | 全校老師密碼（雜湊） |
erase_pin_hash | 清除密碼（雜湊） |
<班別>_pin_hash | 班級密碼,如 1A_pin_hash |
*_pin_set_at | 各密碼設定時間（供年齡 / 輪換） |
mentor_pin_hash | 師友小組長密碼 |
super_admin_token | 復原碼（由中央推送） |
2fa_email | 可選:登入 2FA 電郵 |
重要: Credentials 只存雜湊,永不存明文密碼。用 App 或 Sheet 選單設定,不要自己填明文。
Students 分頁（登入必需）
欄位:reg｜name_chi｜name_eng｜class｜num｜dob｜email。class 例 1A / 2B;dob 格式 YYYY-MM-DD（學生 / 家長登入靠 班別 + 學號 + 出生日期 核對,務必準確）。
9 · 保安須知 · Security notes
- 密碼以 SHA-256 在瀏覽器加密後才傳送,Sheet 只存雜湊。
- 4 位數學校密碼以明文存於中央目錄,且長度短 —— 屬「裝置關卡」,不是強力保安;請提醒師生不要公開張貼。
- 老師 / 班級 / 清除密碼建議 8 位以上,含大細楷 + 數字;定期更換（超過 90 日會提示）。
- 學生出生日期是唯一的學生身分核對,請確保名冊準確、不外洩。
10 · 常見問題與陷阱 · Troubleshooting
⚠ 更新 Apps Script 後「沒有反應」? 最常見原因是用了「New deployment（新部署）」產生新網址,App 仍指向舊網址。正確做法:Apps Script →「管理部署 Manage deployments → 編輯（鉛筆）→ 版本:新版本 New version → 部署」,保持同一網址。若有多個部署,全部更新。
- 班級老師看不到學生?→ 確認已用「班級密碼」登入（而非全校老師密碼）,且該班在 Students 名冊有資料。
- 學生無法登入?→ 檢查 Students 名冊的 class / num / dob 是否與學生輸入一致（dob 必須 YYYY-MM-DD）。
- 忘記老師密碼?→ 用
super_admin_token 經「忘記密碼」重設,或在 Credentials 清空該格。
- 學校不在下拉選單?→ 未加入中央目錄（active=TRUE）;請電郵 reclaim2k@lws.edu.hk。
聯絡 · Contacts