課堂點名系統 社團/分組
📱 一、 極致流暢的前端操作體驗 (UI/UX)
💛Mobile-First (手機優先) 設計：專為走動式教學、跨班跑班的老師設計，介面宛如原生 iOS App，支援單手輕鬆操作。
💛一鍵式直覺點名：捨棄傳統下拉選單，採用「出、缺、事、病、公」五段式獨立按鈕，點擊時具備色彩變換與手機微震動回饋，精準防錯。
💛高度個人化面板：內建 12 款精選馬卡龍漸層背景與 8 款卡片主題色，老師可自由打造專屬的點名系統外觀，並支援自訂系統主標題。
💛即時統計與防呆機制：畫面上方即時顯示「應到、實到、異常」人數；送出前若全班到齊或有異常，皆會跳出智慧確認視窗，且防止網路延遲時的重複點擊。
🏫 二、 貼合校園實務的教務管理
💛智慧顯示週期：系統能判斷「今天是星期幾」，自動過濾並只顯示當天有排課的社團或跑班清單，老師不必在茫茫列表中尋找。
💛課程代碼精準串接：以唯一的「課程代碼」作為資料庫橋樑，完美解決同名社團（如：籃球社A、籃球社B）的名單錯亂問題。
💛動態名單管理：學生總名單集中管理，並具備「自動依班級、座號排序」功能。遇到學期中轉學或退社的學生，只需在試算表註記「退社」，系統即會自動隱藏該生，保留歷史紀錄。
💛今日進度總覽 (Dashboard)：內建總覽面板，一鍵秒看全校（或全領域）今日所有課程的點名進度，誰已點名、誰還沒點名一目了然。
🤖 三、 雲端資料庫與自動化通知
💛無紙化試算表後台：點名結果自動寫入 Google Sheets，詳細記錄時間、節次、任課老師，並自動彙整出清晰的「異常學生名單字串」（例：701-05 林小宇(事假)），方便學務處直接查閱或匯出。
💛自訂備註功能：遇到突發狀況（如學生去保健室、公假去比賽），老師可在送出點名前即時輸入文字備註，同步回傳後台。
💛LINE 異常精準推播：系統綁定 LINE Messaging API，「只有當出現缺席或請假時」，才會將整理好的精美異常名單推播至導師或學務處群組，全班出席則靜默紀錄，避免群組訊息轟炸。
💛金鑰分離架構：將 LINE Token 等機密設定獨立於試算表分頁中，方便老師將系統打包、建立副本分享給校內其他同仁無痛啟用。(選填)
📱 數位點名系統 - 專屬建置指南
這套點名系統專為校園內的「跨班選修、社團活動、分組跑班」所設計。結合 iOS 原生質感的網頁介面與 LINE 異常名單自動推播，幫助老師在操場或專科教室也能用手機單手輕鬆完成點名！
💡 最大亮點： 您不需要懂任何程式碼！只要會用 Google 試算表打字，5 分鐘就能建置出您專屬的點名 Web App！
🚀 快速啟用 4 步驟
步驟一：複製系統核心（建立副本）
- 請點擊右方連結取得奕鈞老師分享的系統範本：
https://docs.google.com/spreadsheets/d/1fV8ooKEEekCQKNmPV3YNh8_v1P-nudJsoWQzkL8na88/edit?usp=sharing
- 點擊「檔案」中的 「建立副本」。
- 系統會自動將包含了網頁程式碼的試算表，複製一份到您的個人
Google 雲端硬碟中。
步驟二：填寫您的課程與學生名單(可省略此步驟，建置成功後再來修改即可)
請打開您剛剛複製的試算表，裡面有四個分頁。請先在
「系統設定」 與 「學生總名單」 這兩個分頁中，填入您這學期的課程資訊。 (⚠️ 填寫時請務必嚴格遵守最下方的【資料表格式規範】，以免系統讀取失敗喔！)
步驟三：填入您的 LINE 推播金鑰(可省略此步驟)
若希望點名送出後能自動傳送異常名單，請前往
「參數設定」 分頁：
- 在 B2 儲存格（對應 LINE_TOKEN）貼上您申請到的 LINE Channel Access Token。
- 在 B3 儲存格（對應 LINE_TARGET_ID）貼上您要接收通知的 User ID 或 Group ID。 (若不需要 LINE 通知功能，這兩欄保留空白即可，系統依然可正常運作儲存。)
步驟四：發布您的專屬網頁 (最重要的一步！)
- 在試算表上方的工具列，點選 「擴充功能」 ➔ 「Apps Script」。
- 進入程式碼畫面後，直接點選右上角的 「部署」 ➔ 「新增部署作業」。
- 點擊左側齒輪圖示 ⚙️，選擇 「網頁應用程式 (Web App)」。
- 設定如下：
- 執行身分：我 (您的帳號)
- 誰可以存取：所有人 (或具有 Google 帳戶的使用者)
- 點擊 「部署」。
🔓 首次啟用的「Google 安全授權」解鎖 (必看)：
- 點擊部署後，畫面會跳出「需要授權」視窗，請點選 「審查權限」。
- 選擇您的 Google 帳號。
- 看到「Google 尚未驗證這個應用程式」的警告時，請點擊左下角小字
「進階」。
- 點選最下方的 「前往 您的專案名稱 (不安全)」。
- 滑到最下面點選 「允許」。
- 授權完成後，畫面會給您一串 「網頁應用程式網址」，把這串網址複製下來，大功告成！
- 「網頁應用程式網址」就是點名系統的網址！
📌 【重要】試算表格式規範須知
為了讓系統精準運作，請務必遵守以下各分頁的欄位順序與填寫規則。請勿隨意刪除分頁或更動第一列的「標題名稱」！
📁 分頁一：【系統設定】(設定這學期有哪些課)
- A欄 (學期)： 如 114-2。
- B欄 (課程代碼)： ⚠️ 極度重要！ 必須為唯一的英數字（如 c001、EngA），系統靠這個代碼來抓取學生名單，不可重複。
- C欄 (課程名稱)： 顯示在網頁上的名稱（如
籃球社）。
- D欄 (任課老師)： 如
王大明。
- E欄 (上課地點)： 如
活動中心。
- F欄 (上課節次)： 純文字呈現（如
第五六節、週三 第7節）。
- G欄 (顯示週期)： 控制這門課星期幾才要出現在網頁上。
- 1 = 每週一顯示 / 2,3 = 每週二、三顯示（請用半形逗號隔開）。
- 若留空或填 0 = 每天都會顯示。
📁 分頁二：【學生總名單】(全校社團名單大匯集)
- A欄 (課程代碼)： ⚠️ 必須與【系統設定】的 B 欄一模一樣，否則學生會出不來。
- B欄 (原班級)： 如 701。
- C欄 (原座號)： 如 05 或 5。
- D欄 (姓名)： 如 林小宇。
- E欄 (狀態)： 平時留白。若學生學期中退社或轉學，請在此欄填寫 退社，該名學生就不會再出現在點名畫面上。
📁 分頁三：【點名紀錄】(系統自動寫入，請勿手動修改)
- 這裡是網頁送出資料後的「純儲存庫」。
- 包含時間、日期、節次、應到/實到人數，以及最精華的「缺席與請假明細」。
- 建議期末再到這裡匯出資料，平時不需要手動輸入。
📁 分頁四：【參數設定】(放置 LINE 金鑰的地方)
- 必須保持 A 欄為名稱，B 欄為數值。
- 第一列為標題 參數名稱 | 參數值。
- 第二列 A 欄固定為 LINE_TOKEN。
- 第三列 A 欄固定為 LINE_TARGET_ID。
📱 網頁應用程式網址美化小撇步
網頁應用程式網址很長，可在Google sites新增一個「空白網頁」：
- 輸入標題： 如「健康國小社團點名系統」。
- 右方工具列「插入」下方新增「按鈕」：輸入名稱，如「點我進入系統」➔ 網址貼上 網頁應用程式網址。 這樣就能把這套點名系統變成像一般正式網站一樣中規中矩囉！
- 點擊「發佈」：輸入想使用的網址(英數字)，如club-roll-call➔確認。
- 複製「已發佈網址」：將網址發送給任課老師，完工！
(2026 @ 奕鈞老師製作 V.14 提供)
