PHVS — 白河商工宿舍管理系統

國立白河高級商工職業學校學務處 — 宿舍夜間點名、請假、修繕、緊急通報與晚自習出勤。

Cloudflare Worker：phvs · D1：phvs-db · R2：phvs-files

快速開始

npm install
cp .dev.vars.example .dev.vars   # 可選：填入 GEMINI_API_KEY、SESSION_SECRET
npm run db:reset:local
npm run dev

開啟 http://127.0.0.1:8787

帳號	角色	密碼
admin	管理員	bhvs2026
staff	學務處	bhvs2026
warden	舍監	bhvs2026
tutor	導師	bhvs2026
4121101	住宿生	bhvs2026

功能

• 夜間 GPS／電子圍籬簽到，自動比對核准請假並產出未到報表
• 緊急求助即時警報（輪詢＋徽章＋通知）
• 宿舍修繕報修（含相片上傳）與進度追蹤
• 晚自習出勤管理與 CSV 匯出
• 宿舍公告、帳號權限、PWA
• 智慧助理（Gemini 3.6 Flash）

技術架構

• Cloudflare Workers（Hono API）+ 靜態前端
• 資料庫：D1（phvs-db）
• 檔案：R2（phvs-files）
• LLM：Gemini gemini-3.6-flash

部署

npx wrangler login
npx wrangler d1 create phvs-db
npx wrangler r2 bucket create phvs-files
# 將 database_id 寫入 wrangler.jsonc 後：
npm run db:migrate
npm run db:seed
npm run deploy
npx wrangler secret put SESSION_SECRET
npx wrangler secret put GEMINI_API_KEY   # 可選