程優智慧督導中心 — 完整使用手冊
版本: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 程優教育科技集團 老師用心・孩子開心・家長放心