Skip to content

v1.4.6

Choose a tag to compare

@chinglin-k chinglin-k released this 05 Sep 05:22
· 5 commits to main since this release
0561d30

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() 新增去重機制:

  1. 以「學號 + 房號 + 問題描述前 50 字」組成字串
  2. 取 MD5 雜湊後編碼為 CacheService 的 key
  3. 120 秒內若命中相同指紋,直接拒絕並回傳 DUPLICATE_REPORT
  4. 僅於格式驗證通過、且實際寫入試算表成功後才存入快取,避免驗證失敗的請求誤佔用去重配額

前端 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 一致

📎 相關連結