國立嘉義高中｜重補修報名繳費與排課系統

依教務處教學組需求文件建置：資格稽核 → 線上報名 → 繳費 → 排課衝堂 → 上課通知。
技術：Cloudflare Workers + D1 + Gemini。

對應需求重點

需求	系統做法
資格稽核（高三暑期限修、畢業生跨修）	規則引擎讀取 audit_rules，可於畫面啟停
線上報名＋微幅衝堂警示	報名送出即檢核並顯示衝堂表
繳費單（App／ATM／超商）＋即時入帳	金流回報／App 完成即入帳；/status 隨時查詢
衝堂比例／統計表／方案（無衝堂・≤1/6・≤1/5）	排課方案分級產生、可儲存與套用為正式班次
自學輔導／重修專班	依人數建議，報名前可見；可依人數自動調整
已繳費上課通知	含時段／教室，並寫入點名名冊
停開／改選	停開通知＋線上改選（已繳費一併退費）
家長簽名報名	線上家長同意聲明
請假節次／衝堂對照	school_periods 主檔＋日曆選 weekday×period；請假不得手輸時間
畢業學分缺口	應修總學分／已取得／重補修／進行中／仍差；資格頁可查
班級數預估	開課需求板顯示建議增開／維持／可能停開
幹部→櫃台→納組	報名作業鏈狀態（收件／勾核／入帳）
點名出缺席	依班次建立場次，登錄出席／缺席／遲到／請假

快速開始

npm install
cp .dev.vars.example .dev.vars   # 可填 GEMINI_API_KEY
npm run db:reset:local
npm run dev

開啟終端機顯示的本機網址（常見 http://127.0.0.1:8788），登入：

帳號	角色	密碼
admin	管理員	demo
teaching	教學組	demo
finance	納組	demo
seed 內學號（如 111101）	幹部／學生	demo

建議走訪路徑

1. 管理員 → 總覽：待辦佇列、問題對照、開課需求
2. 學生／幹部 → 我的重補修進度 → 資格 → 報名 → 繳費 → 通知
3. 教學組 → 高三暑期查高一（應擋）、畢業生跨修（應放行）
4. 納組 → 開立繳費單 → 確認入帳 → 退費
5. 排課 → 查看分級方案 → 編輯開課時段 → 儲存方案
6. 通知 → 批次上課通知（含時段教室）

種子資料規模（約）

學生 36、課程 26、成績 149、報名 54、繳費 42、通知 36、文件 50、規則 10。
含：寒假報名、高三暑期限修駁回、畢業生跨修、補考未入帳、衝堂偏高示範。