臺中一中｜學務 AI 協助平台（Demo）

依「校務運作以 AI App 協助解決方案構想」打造的學務處示範系統。視覺依 臺中一中官網 VIS（校徽紅／灰）與正式校名「臺中市立臺中第一高級中等學校」調整。

本版重點

• 對齊原始六大需求：文書、法規、報表整理、趨勢預警、教材、輔導建議
• P0：LLM 草稿接地（學生時間軸＋法規片段）、報表日期／班級篩選與多類型 CSV、預警時間窗／門檻／排程、示範帳號列表收斂、法規 FTS／語料擴充
• P1：家長通知模擬發送、法規問答、學生 CSV 匯入、校安承辦／家長知會欄位
• 跨模組流程：請假核准自動同步出缺勤；校安關聯學生；預警可追蹤並轉輔導／學生總覽
• 學生 360：名冊可檢視獎懲／出缺勤／請假／預警／輔導／校安時間軸
• 導師班級範圍：學生與相關紀錄依班級過濾
• 總覽待辦深鏈至對應分頁；預警產生去重
• 所有業務物件持久化於 D1；文書／教材全文以 D1 為主
• 完整 CRUD；帳號不可改、姓名／密碼可改（PBKDF2）
• LLM：Gemini 3.6 Flash（可選）；夜間 Cron 自動產生預警

假資料數量

資料	筆數
students	36
discipline	48
attendance	72
leave	36
incidents	30
regulations	24
docs	28
alerts	28
materials	24
guidance	28
users	8

角色與密碼

帳號	角色	密碼
director	學務主任	demo
staff / staff2	學務人員	demo
teacher1/2/3	導師（含班級）	demo

本機啟動

npm install
npm run setup:local
# 可選：把 Gemini key 寫入 .dev.vars
# GEMINI_API_KEY=...
npm run dev

登入後即可測各模組 CRUD。主任可在「權限管理」一鍵 重新匯入假資料。

Gemini

• Model：gemini-3.6-flash
• 本機：.dev.vars → GEMINI_API_KEY=...
• 正式：npx wrangler secret put GEMINI_API_KEY

部署

1. npx wrangler d1 create tcfsh-db（更新 database_id）
2. npx wrangler r2 bucket create tcfsh-files
3. npm run db:migrate:remote
4. 設定 GEMINI_API_KEY secret
5. npm run deploy