程優智慧督導中心 — 完整使用手冊
版本：v4.0 ｜ 更新日期：2026 年 3 月 ｜ 適用對象：執行長、管理幹部
目錄
- 系統簡介
- 登入與身份驗證
- 總覽儀表板（首頁）
- 每日人次監控
- 歷史趨勢分析
- 科次趨勢分析
- 月度分析報告
- 文件庫
- 排程健康監控
- 教師生產力分析
- 使用手冊（本頁）
- 浮動 AI 督導助理
- 背景音樂播放器
- PWA 安裝（加入主畫面）
- 資料更新機制
- 分校清單
- 常見問題（FAQ）
- 版本更新紀錄
1. 系統簡介
程優智慧督導中心是專為程優教育科技集團設計的 CEO 級智慧管理平台，整合各分校的科次數據、出席率、財務指標與系統健康狀態，讓執行長可在任何時間、任何裝置上即時掌握全集團營運全貌。
核心設計理念
- 即時性：每日多時段自動從 weclass 系統抓取最新科次與出席率數據
- 視覺化：所有關鍵指標以 3D 圖表、動態動畫呈現，一眼判別趨勢
- 行動優先：完整支援手機、平板、電腦，隨時隨地督導
- 智慧警示：異常自動標紅、推播通知，不遺漏任何異常
系統架構
| 層次 | 技術 | 說明 |
|---|---|---|
| 前端 | React 19 + Tailwind 4 | 響應式深色科技風介面 |
| 後端 | Express + tRPC | 型別安全 API，無縫前後端通訊 |
| 資料庫 | MySQL（TiDB） | 儲存科次快照、出席率、設定值 |
| 排程 | Node.js Cron | 每日 09/11/14/17/20/22 時自動更新 |
| 外部系統 | weclass API | 各分校科次與出席率數據來源 |
功能模組總覽
| 模組 | 路由 | 說明 |
|---|---|---|
| 總覽儀表板 | / | 核心 KPI 卡片、即時科次、出席率監控 |
| 每日人次監控 | 首頁區塊 | 分校人次變動追蹤 |
| 歷史趨勢分析 | /history | 30 天出席率折線圖、分校比較 |
| 科次趨勢分析 | /session-trend | 日/週/月科次變動追蹤 |
| 月度分析報告 | /monthly-report | 月度數據彙整、PDF 匯出 |
| 文件庫 | /document-library | 所有上傳文件管理、OCR、分享 |
| 排程健康監控 | /scheduler-health | 排程執行記錄、weclass 健康、系統設定 |
| 教師生產力分析 | /teacher-productivity | 教師科次完成率排名、分校比較 |
| 使用手冊 | /user-manual | 線上閱讀、多格式下載、分享 |
2. 登入與身份驗證
2.1 登入方式
系統採用 Manus OAuth 單一登入，點擊「登入」後跳轉至 Manus 帳號驗證頁面，驗證成功後自動返回系統。執行長帳號具有最高管理權限，可存取所有功能模組。Session 在瀏覽器關閉後依然有效，下次開啟無需重新登入。
登出： 點擊左側邊欄底部的「登出系統」按鈕即可安全登出，Session Cookie 立即清除。
注意：Safari 私密瀏覽、Firefox 嚴格追蹤保護模式、Brave 積極防護模式可能導致登入失敗，建議使用 Chrome 或 Edge 瀏覽器。
2.2 權限說明
| 角色 | 說明 | 可存取功能 |
|---|---|---|
| 執行長（Owner） | 最高管理員 | 所有功能，含系統設定 |
| 管理幹部 | 一般登入用戶 | 查看儀表板、報告、文件庫 |
3. 總覽儀表板（首頁）
首頁是每日管理的核心視圖，整合最重要的即時資訊。
3.1 頂部警示橫幅
頁面最頂部常駐顯示系統狀態：
- 綠色：各分校科次正常，今日無異常警示
- 紅色/黃色：有異常分校，顯示受影響分校名稱與異常類型
3.2 側邊導覽列
左側固定側邊欄包含：
- 執行長大頭照、姓名、公司名稱
- 系統狀態指示燈（監控中）
- 各功能頁面快速連結
- 底部：即時讀取、刷新所有數據、系統設定、登出
手機版：點擊左上角漢堡選單（三條橫線）展開側邊欄，點擊任一項目後自動收合。
3.3 四大核心 KPI 卡片
| 卡片 | 說明 | 異常條件 |
|---|---|---|
| 今日總科次 | 全集團當日科次合計，含昨日比較（+/-）與距目標差距 | 較前日下降顯示紅色 |
| 本月營收 | 財務模組整合中 | 財務系統接入後啟用 |
| 平均出席率 | 全校今日平均出席率，標示異常分校數 | 低於 80% 卡片變黃/紅色 |
| 異常警示 | 當日異常事件數量 | 有事件時顯示脈衝動畫 |
今日總科次卡片詳解：
- 主數值：今日截至目前的科次合計
- 右上角徽章：與昨日比較（+0.2% 綠色 / -1.5% 紅色）
- 副標題：數據新鮮度（即時讀取 / 快照資料 / 快取資料）
- 距目標差距：若已設定每日目標，顯示「距目標 -91」或「超目標 +50」
3.4 今日數據更新進度條
時間軸顯示六個更新時段的完成狀態：
| 時段 | 說明 |
|---|---|
| ✅ 09:00 | 早上第一次更新（已完成） |
| ✅ 11:00 | 上午第二次更新（已完成） |
| ⚪ 14:00 | 下午第一次更新（待執行） |
| ⚪ 17:00 | 下午第二次更新（待執行） |
| ⚪ 20:00 | 晚上第一次更新（待執行） |
| ⚪ 22:00 | 當日最後更新（待執行） |
右側顯示「下次更新：14:00」與「查看歷史趨勢」連結。
3.5 手動輸入今日科次
若 weclass 系統暫時無法連線，可手動輸入各分校科次：
- 點擊「手動輸入今日科次」卡片
- 輸入各分校科次數值
- 點擊「鎖定快照」確認當日數據
鎖定後數據不會被排程覆蓋，副標題顯示「快照資料」。
3.6 時段漸層背景
系統根據當前時間自動切換背景主題：
| 時段 | 背景風格 |
|---|---|
| 清晨 05:00–08:59 | 晨曦橙紫漸層 |
| 上午 09:00–11:59 | 清澈藍白漸層 |
| 下午 12:00–17:59 | 深藍科技感 |
| 傍晚 18:00–20:59 | 暮色紫藍漸層 |
| 深夜 21:00–04:59 | 深邃星空黑藍 |
右上角「晨光時段」按鈕可手動切換時段背景。
4. 每日人次監控
側邊欄「每日人次監控」連結至首頁的人次變化監控區塊。
4.1 日/週/月 Tab 切換
- 日：今日各分校人次較昨日的變動（+/- 差值與百分比）
- 週：本週人次較上週的變動（週一 09:00 快照對比）
- 月：本月人次較上月的變動（每月 1 日 09:00 快照對比）
每個分校顯示彩色差值徽章：綠色代表成長，紅色代表下降，灰色代表持平。
4.2 週排名與月排名
- 週排名：每週一 00:30 自動計算，顯示各分校出席率週排名
- 月排名：每月 1 日 00:30 自動計算，顯示各分校出席率月排名
5. 歷史趨勢分析
路由：/history
5.1 出席率 30 天折線圖
以面積折線圖顯示過去 30 天的全台平均出席率趨勢：
- 每日出席率折線（藍色）
- 80% 警戒線（紅色虛線）
- 滑鼠 hover 顯示當日詳細數據
5.2 分校篩選
下拉選單可選擇特定分校，圖表即時更新為該分校的歷史出席率曲線。
5.3 統計摘要卡片
| 卡片 | 說明 |
|---|---|
| 30 天平均出席率 | 期間整體平均值 |
| 最高單日出席率 | 期間最佳表現日 |
| 最低單日出席率 | 期間最差表現日 |
| 低於 80% 天數 | 異常天數統計 |
6. 科次趨勢分析
路由：/session-trend
本頁面追蹤全台各分校的課程科次數量變化，幫助管理者掌握招生與課程開設趨勢。
6.1 科次趨勢圖
以 3D 長條圖顯示各分校科次數量，支援時間範圍篩選（本週、本月、近三個月）。
6.2 科次排行榜
以排行榜形式顯示各分校科次數量，搭配增減箭頭標示與前期比較結果。
6.3 數據匯出
頂部導覽列提供 PDF 下載按鈕，可匯出完整的科次趨勢報告。
7. 月度分析報告
路由：/monthly-report
7.1 月份選擇
頁面頂部提供月份選擇器，可查看任意歷史月份的完整分析報告。
7.2 報告內容
| 區塊 | 內容 |
|---|---|
| 月度科次摘要 | 總科次、日均科次、最高/最低單日 |
| 出席率分析 | 各分校月均出席率、排名變化 |
| 異常事件統計 | 本月異常次數、最常發生分校 |
| 財務文件清單 | 已上傳的財務相關文件 |
7.3 PDF 匯出
SmartDownloadPanel 提供以下下載選項：
- PDF 下載：完整排版的 PDF 報告（含圖表）
- 複製連結：產生可分享的報告連結
- 原生分享：透過 Web Share API 分享至其他應用程式（支援 iOS/Android）
8. 文件庫
路由：/document-library
8.1 支援格式
| 類型 | 格式 |
|---|---|
| 圖片 | JPG、PNG、GIF、WebP、HEIC |
| 文件 | PDF、Word (.docx)、Excel (.xlsx) |
| 簡報 | PowerPoint (.pptx) |
| 文字 | TXT、CSV、Markdown |
單一文件最大 50MB，圖片上傳前自動壓縮至 1920px/JPEG 0.85。
8.2 上傳方式
- 拖拽上傳：將文件拖拽放入上傳區域，支援同時拖拽多個文件
- 點擊上傳：點擊上傳區域開啟檔案選擇器
- 相機掃描：在支援相機的裝置上，對準紙本文件拍攝後自動 OCR
8.3 OCR 智慧識別
上傳圖片或 PDF 後，系統使用 Gemini Vision API 自動進行 OCR 文字識別，並自動提取 3–8 個關鍵標籤（如金額、日期、分校名稱）以彩色 Badge 顯示。
8.4 文件操作
| 操作 | 說明 |
|---|---|
| 👁 預覽 | 開啟文件預覽 Modal |
| ⬇ 下載 | 直接下載原始文件 |
| ⭐ 收藏 | 加入/取消收藏 |
| 🔗 分享 | 產生有效期分享連結（7/30 天）+ QR Code |
| 🔄 重新 OCR | 重新執行 OCR 識別 |
| 🗑 刪除 | 刪除文件（需二次確認） |
8.5 批次操作
點擊「多選」按鈕進入多選模式：
- 批次刪除：二次確認後同時刪除所選文件
- 批次下載 ZIP：將所選文件打包為 ZIP 壓縮檔下載
- 批次重新 OCR：對所選圖片/PDF 並行補跑 OCR
8.6 智慧搜尋
頂部搜尋列同時搜尋：檔案名稱、OCR 識別文字、AI 自動提取的標籤。採用 300ms debounce 即時回應。
8.7 分類篩選
| Tab | 說明 |
|---|---|
| 全部 | 顯示所有文件 |
| ⭐ 已收藏 | 只顯示已收藏文件 |
| 財務 | 財務相關文件 |
| 報告 | 分析報告類文件 |
| 警示 | 異常事件附件 |
| 一般 | 其他文件 |
9. 排程健康監控
路由：/scheduler-health
這是系統維運的核心監控中心，分為三個分頁。
9.1 立即執行排程
頁面右上角綠色閃電按鈕「立即執行排程」：
- 立即觸發一次完整的科次 + 出席率更新
- 顯示執行中 spinner 動畫
- 完成後 toast 通知顯示更新結果
- 不必等待下一個排程時段
9.2 圖表分析 Tab
① 分校科次趨勢圖
- 下拉選單切換分校（全部 / 各分校）
- 天數選擇：7 / 14 / 30 / 60 天
- AreaChart 面積圖，直觀顯示趨勢
② 分校出席率趨勢圖
- 同樣支援分校篩選與天數選擇
- LineChart 折線圖，可比較多分校趨勢
③ weclass 回應時間圖
- 顯示近 48 次 weclass API 健康檢查的回應時間（ms）
- 超過警戒閾值的點以紅色標示
9.3 執行日誌 Tab
顯示所有排程執行記錄：
- 執行時間、執行結果（成功/失敗）
- 抓取到的科次數值
- 錯誤訊息（若有）
可調整顯示筆數（10 / 25 / 50 / 100 筆）。
9.4 weclass 健康 Tab
24 小時統計卡片
| 指標 | 說明 |
|---|---|
| 健康檢查次數 | 24 小時內執行次數 |
| 成功率 | 成功回應百分比 |
| 平均回應時間 | 所有成功回應的平均 ms |
| 最快/最慢 | 回應時間範圍 |
weclass 警報閾值設定
- 預設 200 ms，可自訂（100~5000 ms）
- 快速預設：200 ms / 500 ms / 1000 ms
- 超過閾值自動標記為「緩慢」狀態
每日科次目標設定
- 設定每日科次目標值（預設 3,800 科）
- 快速預設：3,500 / 3,800 / 4,000 / 4,500 科
- 設定後首頁科次卡片即時顯示「距目標差距」
推播通知設定
| 開關 | 說明 |
|---|---|
| 每日提醒 | 22:30 若快照未鎖定，自動推播提醒 |
| 異常偵測推播 | 出席率異常時立即推播通知 |
歷史健康檢查記錄 顯示最近 30 次 weclass 健康檢查記錄，含狀態、回應時間、科次數值。
10. 教師生產力分析
路由：/teacher-productivity
提供教師工作績效的多維度分析，幫助管理者掌握各分校教師的科次完成情況。
說明：目前為範例模板，顯示 115 學年度 10/13–10/23 期間的示範數據。上傳實際 Excel 檔案後可替換為真實數據。
10.1 KPI 摘要卡片
| 指標 | 說明 |
|---|---|
| 整體完成率 | 所有教師平均科次完成百分比 |
| 總科次完成 | 期間內實際完成科次數 vs 目標科次數 |
| 參與教師數 | 納入分析的教師人數與分校數 |
| 最高完成率 | 本期表現最佳教師姓名與分校 |
10.2 圖表分析 Tab
提供 5 張專業分析圖表，點擊左側選單切換，右上角可全螢幕燈箱檢視：
| 圖表 | 說明 |
|---|---|
| 完成率排名 | 各教師科次完成比例橫向比較（水平條形圖） |
| 每日工作趨勢 | 期間內每日科次完成量折線圖 |
| 目標 vs 實際 | 各教師目標科次與實際完成量對比（雙色條形圖） |
| 分校雷達圖 | 各分校綜合生產力多維度評估（雷達圖） |
| 綜合儀表板 | 整體生產力指標全覽（儀表板式綜合圖） |
10.3 教師排名 Tab
完整教師排名表格，包含：
- 名次（前三名以金/銀/銅色標示）
- 教師姓名、所屬分校
- 完成率進度條（顏色依完成率自動變化）
- 實際科次 vs 目標科次
- 趨勢（▲ 上升 / ─ 持平 / ▼ 下降）
- 綜合評分（優秀 / 良好 / 待改善）
10.4 分校摘要 Tab
各分校卡片，顯示：
- 分校排名
- 平均完成率（進度條視覺化）
- 教師人數
- 最佳教師姓名
11. 使用手冊（本頁）
路由：/user-manual
11.1 線上閱讀
- 目錄導覽：左側章節目錄，點擊快速跳轉
- Markdown 渲染：完整支援表格、程式碼、粗體等格式
- 響應式排版：手機、平板均可舒適閱讀
11.2 下載格式
| 格式 | 適用場景 |
|---|---|
| Markdown (.md) | 技術人員、版本管理（可用 Typora/Obsidian 開啟） |
| JSON (.json) | 系統整合、程式處理（結構化章節格式） |
| 純文字 (.txt) | 通用閱讀、Email 附件 |
| 列印/PDF | 紙本存檔、正式文件（使用瀏覽器列印功能） |
11.3 分享功能
產生分享連結：
- 點擊右上角「分享」按鈕
- 選擇有效期：7 天 / 30 天 / 365 天
- 複製連結或掃描 QR Code 分享
- 收到連結者無需登入即可閱讀
12. 浮動 AI 督導助理
頁面右下角的金色圓形按鈕為 AI 督導助理，點擊可展開對話視窗。
12.1 可詢問的問題類型
- 「今日哪間分校出席率最低？」
- 「本月科次較上月增減多少？」
- 「最近有哪些異常警示？」
- 「幫我摘要今日重點」
12.2 自動摘要氣泡
系統在特定時間點（如數據更新後）會自動在 AI 助理按鈕旁顯示摘要氣泡，提示重要數據變化，無需主動詢問。
13. 背景音樂播放器
右下角的音樂控制列提供輕柔的 Lo-Fi 背景音樂。
| 控制項 | 功能 |
|---|---|
| ▶/⏸ | 播放/暫停 |
| 🔊 | 音量滑桿（0%–100%） |
| 🔁 | 循環播放開關 |
音樂預設為暫停狀態，需手動點擊播放。音量設定在頁面重新整理後保留。
14. PWA 安裝（加入主畫面）
系統支援 Progressive Web App（PWA），可安裝至手機或電腦主畫面。
14.1 Android / 桌面 Chrome
左側邊欄底部顯示「加入主畫面」按鈕（當瀏覽器支援時顯示），點擊後按照提示完成安裝。
14.2 iOS Safari
- 點擊 Safari 底部的「分享」按鈕（方框加箭頭圖示）
- 向下滾動選擇「加入主畫面」
- 確認名稱後點擊「加入」
安裝後，App 圖示（深藍底金色「程」字）會出現在主畫面，點擊即可全螢幕開啟。
15. 資料更新機制
15.1 自動排程時段
系統每日在以下時段自動從 weclass 抓取最新數據：
| 時段 | 說明 |
|---|---|
| 09:00 | 早上第一次更新 |
| 11:00 | 上午第二次更新 |
| 14:00 | 下午第一次更新 |
| 17:00 | 下午第二次更新 |
| 20:00 | 晚上第一次更新 |
| 22:00 | 當日最後一次更新（建議鎖定快照） |
15.2 數據新鮮度標示
首頁科次卡片的副標題會顯示數據來源：
| 標示 | 說明 |
|---|---|
| ✓ 即時讀取 weclass | 最新 weclass 數據，最可靠 |
| 💾 快照資料 | 當日已鎖定的快照數據 |
| ⏳ 快取資料 | 暫存數據，weclass 暫時無法連線 |
15.3 手動鎖定快照
每日確認科次後，建議點擊「鎖定快照」固定當日數據，避免後續排程覆蓋已確認的數值。
15.4 立即手動更新
至「排程健康監控」頁面點擊綠色閃電按鈕立即觸發更新，無需等待下一個排程時段。
16. 分校清單
系統目前監控以下 11 間分校：
| 編號 | 分校名稱 | 類型 |
|---|---|---|
| 1 | 青溪一分校（青一） | 國中文理 |
| 2 | 青溪二分校（青二） | 國中文理 |
| 3 | 慈文分校 | 國中文理 |
| 4 | 北門分校 | 國中文理 |
| 5 | 大有分校 | 國中文理 |
| 6 | 大成分校 | 國中文理 |
| 7 | 中路分校 | 國中文理 |
| 8 | 升大分校 | 國中文理 |
| 9 | 建國分校 | 國中文理 |
| 10 | 福豐分校 | 國中文理 |
| 11 | 莊敬分校（皇家菁英美語） | 國小美語 |
17. 常見問題（FAQ）
Q1：首頁科次顯示的是哪個時間點的數據？
A：顯示最近一次排程成功更新的數據。副標題會標示數據新鮮度（即時 / 快照 / 快取）。若需確認是否為最新，可點擊「立即執行排程」手動更新。
Q2：今日科次顯示負成長，但實際上有增加，怎麼辦？
A：這是已知的數據新鮮度問題。若今日排程尚未執行，系統可能使用昨日快照作為「今日」值。請點擊「立即執行排程」手動更新，或至「排程健康監控」確認最新執行狀態。
Q3：出席率異常但沒有收到推播通知？
A：請至「排程健康監控 > weclass Tab」確認「異常偵測推播」開關是否已開啟。同時確認 Manus 帳號的推播通知權限已授予。
Q4：weclass 顯示「連線失敗」怎麼辦？
A：weclass 系統可能暫時維護中。系統會自動使用上一次成功的快取數據。可等待下一個排程時段自動重試，或點擊「立即執行排程」手動重試。
Q5：如何修改每日科次目標？
A：進入「排程健康監控 > weclass Tab > 每日科次目標設定」，輸入新目標值或點擊快速預設（3,500 / 3,800 / 4,000 / 4,500 科），點擊「確認設定」即生效。
Q6：如何修改 weclass 警報閾值？
A：進入「排程健康監控 > weclass Tab > weclass 警報閾值設定」，輸入新閾值（100~5000 ms）或點擊快速預設（200 / 500 / 1000 ms），點擊「確認設定」即生效。
Q7：分享連結過期了怎麼辦？
A：重新進入使用手冊頁面，點擊「分享」按鈕重新產生新的分享連結，選擇合適的有效期（7 / 30 / 365 天）。
Q8：手機版側邊欄如何開啟？
A：點擊左上角的漢堡選單圖示（三條橫線）即可展開側邊欄。點擊任一導覽項目後，側邊欄會自動收合。
Q9：如何查看特定分校的歷史科次趨勢？
A：進入「排程健康監控 > 圖表分析 Tab」，在「分校科次趨勢圖」的下拉選單中選擇特定分校，即可查看該分校的歷史科次趨勢。
Q10：某分校顯示「今日沒開班」是什麼意思？
A：表示 weclass 系統中該分校今日無課程記錄，屬於正常情況（如假日、特殊假期）。
Q11：上傳文件後 OCR 識別結果不準確？
A：OCR 準確度受圖片品質影響。建議確保照片清晰、光線充足、文字無遮擋。可點擊文件卡片上的「重新 OCR」按鈕重新識別。
Q12：如何在手機上使用系統？
A：系統採用響應式設計，支援手機瀏覽器直接使用。建議安裝為 PWA（參見第 14 節），可獲得更好的全螢幕體驗。
18. 版本更新紀錄
| 版本 | 日期 | 主要更新內容 |
|---|---|---|
| v4.0 | 2026-03 | 教師生產力分析頁面（5張圖表、排名、分校摘要）、每日科次目標設定、昨日記錄補正、手冊全面改版（v4.0） |
| v3.0 | 2026-03 | 分校出席率趨勢圖、通知設定開關（每日提醒/異常偵測）、立即執行排程按鈕、分校科次趨勢切換 |
| v2.5 | 2026-03 | 排程健康監控頁面、weclass 健康檢查、weclass 警報閾值設定、異常推播測試 |
| v2.0 | 2026-02 | 文件庫（OCR、批次操作、版本管理）、使用手冊（線上版）、QR Code 分享、多格式下載 |
| v1.5 | 2026-02 | 月度分析報告、歷史趨勢分析、科次趨勢分析 |
| v1.0 | 2026-01 | 首頁儀表板、分校出席率監控、科次自動排程、PWA 安裝 |
本手冊由程優智慧督導中心系統自動維護，最新版本請以線上版本為準。
© 2026 程優教育科技集團 老師用心・孩子開心・家長放心