DispatchGuard - 現場調度可靠性

DispatchGuard 是一個完整的現場調度個案,設計時先由 QA 風險出發。我沒有只做順利流程,而是優先處理真正容易破壞調度工作的情況:並發派單、過期的離線操作、資格規則、重試及時區邊界。

已完成 v1.0 已完成 · v1.1 加固已驗證 原始碼私有 · 架構及驗證證據在此公開
  • TypeScript
  • PostgreSQL
  • Playwright
  • 離線同步
  • 並發控制
  • RCA / ADR

伺服器檢查

185 / 185

在今次核驗的 v1.1 證據快照中全部通過。

瀏覽器證據

23 項通過

另外,5 個 Playwright 項目中有 72 項檢查按設計跳過,每一項均記錄了具體原因。

決策記錄

6 份 ADR · 4 份 RCA

架構取捨及問題重現都可沿記錄回看。

部署邊界

只限 tailnet

最小可運行的 OCI 部署已在私有網絡驗證,不會包裝成公開正式服務。

為何建立這個項目

只示範順利流程,很容易令調度軟件顯得過於簡單。兩名用戶可能幾乎同時分配同一位技術人員,離線裝置亦可能稍後把根據舊狀態的操作重新提交。

我把這些失敗路徑放在設計中心,並把問題重現、設計決定、修正、回歸測試及 RCA 串在一起。即使不公開倉庫,審閱者也可理解推理過程。

關鍵工程及 QA 決定

在資料庫層守住約束

重疊分配由並發寫入真正交會的地方負責攔截,而不是依賴隨時可能過期的畫面可用狀態。

清楚處理離線重播

冪等鍵、重試規則及清晰的衝突結果,可避免裝置重新連線後悄悄重複或覆蓋操作。

測試真實的本地日曆邊界

除了資格及分配規則,測試亦涵蓋新西蘭夏令時間切換,避免日期時間假設滲入業務邏輯。

可講解的證據

倉庫保持私有,但項目展示不會只剩一張截圖和一串工具名稱。

  • 4 類並發缺陷修正前失敗、修正後通過的對照證據
  • 有關一致性、同步及部署選擇的架構決策記錄
  • 把症狀、重現、修正及回歸保護連起來的根本原因記錄
  • 把實際執行項與按原因主動跳過項分開的 Playwright 結果

這個案例不聲稱甚麼

這些邊界是案例的一部分,不是事後補上的免責聲明。

  • 公司、現場數據及新西蘭電氣服務情境均為合成內容,不代表 EWRB 或業界背書。
  • 部署記錄只限私有 tailnet;沒有公開正式服務或真實客戶使用聲明。
  • 工作階段認證適合目前個案範圍,但不會描述成正式環境級別的身份基礎設施。
  • Playwright WebKit 證據不能代替尚未完成的實機 Safari 測試矩陣。

原始碼私有,工作可核驗

在真實招聘流程中,我可以講解架構、RCA 及測試證據,不需要把倉庫公開。