教師每日工作台安裝指南
這份指南帶你完成單檔安裝、初始化、Web App 部署、Google Sites 嵌入，以及教室大屏佈告欄設定。
一、安裝前準備
- 一個可使用 Google Sheets、Apps Script、Google Sites 的 Google 帳號。
- 本專案產生的安裝檔：
dist/teacher_daily_workflow_installer.gs - 本專案產生的 manifest：
dist/appsscript.json
若安裝檔有更新，請先在專案根目錄執行：
sh scripts/build_install_bundle.sh
二、建立 Google Sheets 主控台
- 到 Google Drive 建立新的 Google Sheets。
- 命名為：
教師每日工作台_主控台 - 在試算表中點選：
擴充功能 > Apps Script
三、貼上 Apps Script 安裝包
- 在 Apps Script 左側打開
Code.gs。 - 刪除原本內容。
- 將
dist/teacher_daily_workflow_installer.gs全部內容貼入Code.gs。 - 點選儲存。
- 到左側「專案設定」，勾選「在編輯器中顯示 appsscript.json 資訊清單檔案」。
- 打開
appsscript.json，用dist/appsscript.json的內容覆蓋。 - 再次儲存。
四、初始化主控台
- 回到 Google Sheets，重新整理頁面。
- 等待上方選單出現：
教師每日工作台 - 點選：
教師每日工作台 > 初始化設定 - 第一次執行會要求授權，依 Google 畫面允許權限。
初始化會自動建立資料表、預設設定、通知模板、Dashboard、View 表、協作平台建置包，並自動隱藏系統頁籤。
若看到「Google 尚未驗證這個應用程式」，請點「進階」，再點「前往專案」，然後允許權限。
五、填寫基本設定
到 設定 表填入以下欄位：
| key | 用途 | 範例 |
|---|---|---|
class_name | 班級名稱 | 六年甲班 |
teacher_name | 教師姓名 | 王老師 |
teacher_email | Email 提醒收件人 | teacher@example.com |
web_app_url | Web App 部署後的網址 | https://script.google.com/macros/s/.../exec |
site_url | Google Sites 發布後的網址 | https://sites.google.com/... |
六、部署 Web App
- 回到 Apps Script。
- 點右上角：
部署 > 新增部署作業 - 類型選：
網頁應用程式 - 說明填：
教師每日工作台 Web App - 執行身分建議選：
存取網頁應用程式的使用者 - 存取權依學校環境選擇，例如校內網域或指定可存取範圍。
- 點選部署，完成授權。
- 複製產生的 Web App URL。
- 回到
設定表，把網址填入web_app_url。
Web App URL 通常長這樣：
https://script.google.com/macros/s/AKfycbxxxxxxxxxxxxxxxx/exec
七、建立 Google Sites 前台
- 到 Google Sites 建立空白網站。
- 網站名稱建議：
六年甲班｜教師每日工作台 - 新增首頁「今日工作台」。
- 使用：
插入 > 嵌入 > 網址 - 貼上
web_app_url。 - 調整嵌入框高度，建議先依
web_app_embed_height，預設約 980px。 - 發布網站後，將 Google Sites 網址填回
設定.site_url。
不建議直接嵌入 Google Sheets，因為 Google Sites 可能顯示整本試算表與下方分頁列。
八、教師管理 UI
同一個 web_app_url 已內建管理 UI。老師可在頁面下方「管理資料」區塊操作：
待辦
- 新增待辦
- 一鍵完成待辦
- 設定類型、優先級、截止日期
作業回條
- 建立全班追蹤
- 勾選已交、未交、補交、需訂正、免交
- 產生未交提醒文字
學生紀錄
- 選學生
- 新增客觀紀錄
- 設定是否通知家長、是否需追蹤
資料同步
- 資料仍寫回 Google Sheets
- 更新後會清除 Web App 快取
- 前台會讀取最新資料
九、教室大屏佈告欄
Web App 另有大屏模式，適合投影到教室電視或電子白板：
web_app_url?view=board
例如：
https://script.google.com/macros/s/AKfycbxxxxxxxxxxxxxxxx/exec?view=board
預設顯示：
- 今日日期與時間
- 班級公告文字
- 今日公開提醒
- 作業／回條未完成數量
預設不顯示學生個別狀況紀錄，也不顯示未交學生姓名。若確定班級內部可顯示姓名，可將
classroom_board_show_missing_names 改為 TRUE。
十、日常維護
- 老師優先使用 Web App 管理 UI，不需要直接編輯太多試算表。
- 如果前台資料沒有立刻更新，可執行：
教師每日工作台 > 清除 Web App 快取 - 若要查看系統頁籤，可執行：
教師每日工作台 > 維護模式：顯示所有頁籤 - 平常可執行：
教師每日工作台 > 一般模式：隱藏系統頁籤
十一、安裝後檢查清單
- Google Sheets 上方出現「教師每日工作台」選單。
設定、學生名冊、每日待辦、作業回條等工作表存在。web_app_url已填入 Apps Script Web App URL。- 打開
web_app_url可看到每日工作台與管理資料 UI。 - 打開
web_app_url?view=board可看到教室大屏佈告欄。 - Google Sites 已嵌入
web_app_url。 - 新增一筆作業回條後，Web App 與 Sheets 都有資料。
十二、常見問題
為什麼 Google Sites 裡顯示試算表分頁？
代表你嵌入的是 Google Sheets 連結。正式版應嵌入 web_app_url，不要嵌入 docs.google.com/spreadsheets 連結。
為什麼協作平台建置包顯示「尚未設定 web_app_url」？
代表還沒有把 Apps Script Web App 部署網址填到 設定.web_app_url。
為什麼 Web App 資料沒有馬上更新？
系統有 3 分鐘 HTML 快取。可執行 清除 Web App 快取 或等待快取過期。
老師需要看到 Dashboard / View 表嗎？
不需要。初始化會自動隱藏系統頁籤，讓老師聚焦在實際維護資料與 Web App UI。