Repository navigation
v1.4.6
v1.4.6 — 重複送出防護、房號床號驗證對齊與文件稽核
發布日期 / Release Date:2026-09-05
上一版本 / Previous:v1.4.5
完整比對 / Full Diff:v1.4.5...v1.4.6
本文件為 GitHub Release 頁面用文字,內容與
CHANGELOG.md的[v1.4.6]條目一致,
另加上「升級須知」與「稽核方法」兩節,供閱讀 Release 頁面的使用者快速掌握重點。
🔑 重點摘要 / TL;DR
- 🛡️ 新增報修表單 120 秒重複送出防護,避免手滑或腳本造成試算表重複案件(
DUPLICATE_REPORT) - 🔒 房號/床號後端格式驗證收緊為與前端完全一致,修復可被繞過前端直接送出不合規格資料的問題
- 📄 修復 7 處文件與程式碼不一致之處(BUG-52 ~ BUG-58),包含一處文件內部自相矛盾的高風險項目(BUG-54)
- ✅ 單元測試由 53 項增至 55 項全數通過,ESLint 維持 0 error / 0 warning
- 🔢 全站版本號統一升級為 v1.4.6
- ℹ️ 一則資訊性附註:Gemini 模型清單現況查核(未變更程式碼,供專案擁有者參考)
✨ 新功能(回補文件)
這兩項功能已於 2026-09-04 合併上線(PR #27、#28),但發布時未同步更新文件;本次版本一併補齊文件並正式收錄進 CHANGELOG.md:
報修表單 120 秒重複送出防護
gas/Code.gs 的 writeReport() 新增去重機制:
- 以「學號 + 房號 + 問題描述前 50 字」組成字串
- 取 MD5 雜湊後編碼為
CacheService的 key - 120 秒內若命中相同指紋,直接拒絕並回傳
DUPLICATE_REPORT - 僅於格式驗證通過、且實際寫入試算表成功後才存入快取,避免驗證失敗的請求誤佔用去重配額
前端 report.js 已備妥對應的雙語友善錯誤訊息。新增 2 組迴歸測試。
房號/床號後端格式驗證對齊前端
| 欄位 | 修復前(後端) | 修復後(前後端一致) |
|---|---|---|
| 房號 | /^[A-Za-z0-9-]{1,8}$/(僅檢查英數字與連字號) |
/^(H|I|G|F[ABCDEF])[0-9]{1,4}(-[0-9]+)?$/i(須以 H、I、G、FA~FF 開頭) |
| 床號 | /^[0-9]{1,3}$/(允許 1–3 位數字) |
/^[0-9]$/(僅 1 位數字) |
修復前,後端正則式比前端寬鬆,代表任何人繞過前端、直接呼叫 GAS Web App,都能送出前端表單根本不允許的格式並成功寫入試算表——這正是後端驗證存在的意義被架空的典型案例。
🛠️ 本次稽核修復(BUG-52 ~ BUG-58)
本次針對全專案原始碼與文件進行逐行一致性稽核,範圍涵蓋全部 js/*.js、gas/Code.gs、css/style.css、index.html、test/*.js、AGENTS.md、README.md、CHANGELOG.md、doc/*.md,並實際執行 npm test、npm run lint、git log/git blame 歷史比對。未發現任何生產程式碼缺陷;css/style.css 經比對後無需修改。
| 編號 | 嚴重度 | 問題 | 影響範圍 |
|---|---|---|---|
| BUG-52 | 中 | 床號格式描述全站過時(仍寫「1–3 位數字」) | 6 份文件 |
| BUG-53 | 中 | 房號格式描述全站過時,且範例「A123」在新規則下不合法 | 6 份文件 |
| BUG-54 | 高 | 報修成功畫面描述與 v1.4.5(BUG-50)已移除的實作直接矛盾,其中一處甚至與同一文件下方的決策記錄自相矛盾 | 3 份文件 |
| BUG-55 | 低 | 單元測試數量過時(53 → 應為 55) | 2 份文件 |
| BUG-56 | 低 | index.html 腳本載入順序註解遺漏 wifi-modal.js |
1 個檔案 |
| BUG-57 | 低 | 測試檔獨立維護的意圖白名單漏掉 BUTTON_QUERY,自 v1.4.0 起未同步 |
1 個檔案 |
| BUG-58 | 低 | 文件內查詢驗證程式碼片段與實際雙錯誤代碼邏輯不符,且與同段文字說明矛盾 | 1 個檔案 |
BUG-54 特別說明:doc/project-memory.md 的「已確認業務規則」章節寫著「報修成功介面僅保留『報修成功!』與進度條,隱藏標題列 Header」——但同一份文件再往下 30 行的「v1.4.4/v1.4.5 決策記錄」卻明確記載這個畫面已於 v1.4.5 當作死碼移除。這代表文件在同一個檔案內就自相矛盾,且該過時描述還擴散到了 doc/requirements.md 與 doc/architecture.md。這類「新程式碼已上線、但描述舊行為的文字散落在文件各處未被清乾淨」的情況,正是本次逐行稽核要抓的重點。
📄 文件同步
以下檔案已更新內容並統一升版為 v1.4.6:
README.md・AGENTS.md・CHANGELOG.md・doc/architecture.md・doc/data-model.md・doc/requirements.md・doc/project-memory.md・doc/todo.md・package.json・package-lock.json
另修正 test/validation.test.js(BUG-57)與 index.html(BUG-56)。
doc/architecture.md 新增 §5.4.3 重複送出防護 小節;doc/todo.md 新增 J 輪 記錄本次工作,A~I 輪等既有歷史紀錄維持原樣不予更動(與本專案一貫做法一致:修正現況描述,但不竄改歷史紀錄本身)。
🧪 測試
npm test → 55 pass / 0 fail(原 53 項,新增 2 組去重迴歸測試)
npm run lint → 0 error / 0 warning
ℹ️ 資訊性附註(未變更程式碼)
以網路搜尋查證 Google 官方文件(2026-09 現況),確認 GEMINI_MODELS_FALLBACK 現有 6 個模型(gemini-3.5-flash-lite、gemini-3.1-flash-lite、gemini-3.6-flash、gemini-3.5-flash、gemini-3.1-pro-preview、gemini-3-flash-preview)目前皆仍有效、正常運作,無任何一個已被官方宣告下架日期。
僅供專案擁有者參考,本次稽核未代為決定:
- Google 已於 2026-08-13 發布
gemini-3.7-flash,官方描述為目前程式碼/Agent 任務表現最佳的 Flash 模型 gemini-3.1-flash-lite已有預告下架日期 2027-05-07(尚有 8 個月餘裕,非急迫)
是否將 gemini-3.7-flash 納入備援清單、或調整既有模型的優先順序,屬於成本/RPM 配額層面的產品決策,建議由專案擁有者評估後另行處理。
⬆️ 升級須知
- 本版本不需要任何手動遷移步驟或環境變數變更
- 房號/床號後端驗證收緊不影響任何透過正規前端表單送出的請求——前端從一開始就套用相同(甚至更早生效)的規則;唯一受影響的是繞過前端、直接呼叫 GAS Web App 且送出不合規格資料的請求(無論是誤用或惡意嘗試),這些請求現在會被後端正確拒絕,這正是本次修復的目的
- 若你的 GAS 部署是手動複製貼上
gas/Code.gs(而非透過 clasp 等工具同步),請記得重新部署最新版程式碼,才能套用重複送出防護與房號/床號驗證修復 - 建議部署後執行一次
npm test && npm run lint確認本地環境結果與本文件記載的 55/0 一致
📎 相關連結
- 完整技術細節:
CHANGELOG.md— [v1.4.6] - 架構設計文件:
doc/architecture.md - 資料模型文件:
doc/data-model.md - 需求規格書:
doc/requirements.md