軟體代表作/Hoist

Hoist

為總盛建設設計並開發營建管理系統,現已於正式環境服務中。

客戶
總盛建設
領域
營建
合作形式
開發委託
角色
系統架構師:架構、開發、雲端遷移
期間
2026 年 5 月啟動;10 月 1 日上線
狀態
正式環境服務中

起點

工地與行政管理,分散於 Excel、通訊軟體與紙本。

總盛建設的工地與行政管理分散於 Excel、通訊軟體與紙本。系統需承載實際營運所需的工程進度、收款節點、文件與權限,並從單機自架環境安全遷移至雲端。

範圍 Hoist 是為總盛建設打造的營建管理系統:建置行動 App、管理後台與雲端平台並完成雲端遷移,2026 年 10 月 1 日交付正式環境。

難題

上百條業務規則、專案經理的管理流程、客戶的回報,全部收斂進同一套流程。

  1. A
    規則多,而且會變

    一場需求會議拆成 64 張工單、67 條規則,每場追蹤會議持續累積規則;多條規則整理比對且實作後,仍需要客戶拍板。

  2. B
    配合專案經理與客戶的回報

    工地回報、第一個真實專案的回饋、權限需求表,最後累積成 251 張 GitHub issue;App 內的「系統優化回報」把文字與截圖直接開成 issue。

  3. C
    正式資料不能出錯

    從單機自架環境遷移到雲端,切換期間只能有一個寫入來源;即時推送也要撐得住多人同時檢視。

做法

每一輪都由 AI 整理流程、建構測試、跑壓力測試,再以平行 subagent 驗證所有功能。

設計並開發 Flutter iOS/Android App、Next.js 管理後台與 87 頁教學站,支援 14 種職務角色與約 35 項權限。

CLIENT 01Flutter AppiOS/AndroidCLIENT 02Next.js 管理後台14 種角色・約 35 項權限DOCS87 頁教學站獨立網站DATABASE資料庫版本化 migration資料庫函式列級權限規則pgTAP 測試REALTIME每專案私有 Broadcast取代逐筆資料變更推送MIGRATION單機自架 → 雲端ADR 先行・三輪對抗式審查推送給同一專案的訂閱者

← 左右滑動查看完整系統圖 →

資料讀寫即時推送遷移與獨立元件

AI 整理需求成 issue登記測試案例隔離工作樹・TDD本機 CI壓力測試平行 subagent 稽核合併或還原
  • 433 個測試案例先登記再實作:267 個自動化,其餘手動或待實機驗證
  • 壓力測試 100 位同時使用者、200 個專案:p95 65 ms
  • 6 條平行稽核分支找出 100 項問題,修正後再逐項對抗驗證
  • 雲端端對端測試 597 項全數通過

架構決策

每個關鍵轉折,都先寫成架構決策紀錄。

雲端遷移以架構決策紀錄(ADR)先行,經三輪對抗式審查,明訂上線決策責任與回滾時段,確保切換期間只有一套系統接受正式資料寫入。

ADR架構決策紀錄
R1對抗式審查
R2對抗式審查
R3對抗式審查
  • 明訂上線決策責任
  • 明訂回滾時段
  • 切換期間只有一套系統接受正式資料寫入
  1. 雲端遷移原本單機自架環境決策ADR 先行,經三輪對抗式審查後遷移至雲端確保切換期間只有一套系統接受正式資料寫入
  2. 即時推送原本逐筆資料變更決策每專案私有 Broadcast確保避開四人以上同時檢視時的訊息量上限
  3. 工期規則原本寫死在程式裡的日期規則決策時間相依圖加關卡條件;範本內建,每個專案保留自己的快照確保客戶調整規則不必改程式,進行中的專案不受影響
  4. 規則來源原本客戶規則與法規混在一起決策客戶規則做成可設定;法定期限寫死並註明出處確保客戶能自己調整,法規不會被誤改

專案時程

2026.10.01

清除測試資料,交付總盛建設

2026 年 5 月啟動;5 個月、1,361 次 commit、251 張 issue;正式環境服務中

出處 +
2026 年 5 月6 月7 月8 月9 月10 月 1 日123456
  1. 12026 年 5 月啟動開發;MVP 34 項功能由平行 subagent 逐項驗證
  2. 22026 年 6 月v3、v4 發布;壓力測試 100 位同時使用者
  3. 32026 年 7 月 17 日客戶需求會議:64 項新需求、67 條規則
  4. 42026 年 8 月64 項需求重建上線;工期改為時間相依圖;第一個真實專案開始回饋
  5. 52026 年 9 月切換到雲端;平行稽核與對抗驗證;8 條核心業務流程驗證通過
  6. 62026 年 10 月 1 日清除測試資料,交付總盛建設

成果

工地與辦公室,現在看同一份資料。

14種

職務角色

工務、行政、財務、業務、使照、主管等,每個人只看到自己該看的

87頁

圖文教學站

另有 3 支短影片,員工依角色找到自己的操作說明

8條

核心業務流程於正式環境驗證通過

2026 年 9 月 23 日;10 月 1 日交付總盛建設

技術

Flutter、Next.js、Supabase。

行動 App
Flutter(iOS/Android)
管理後台
Next.js
資料與權限
Supabase;資料庫函式與列級權限規則
即時推送
每專案私有 Broadcast
驗證
pgTAP;正式環境核心業務流程斷言
開發流程
Flywheel:測試案例先行、TDD、本機 CI,每個工作階段只做一個功能
專案紀錄
原始碼、測試結果與架構決策文件;因保密要求不公開
工程備註

約 10,700 項自動化測試與斷言pgTAP 完整執行 5,119 項斷言零失敗(2026-09-29)正式環境 8 條核心流程 98 / 98 項斷言通過(2026-09-23)即時推送重構後,建立專案時每位訂閱者訊息 273 → 1 則(141 節點測試專案)付款頁 p50 1,229 → 431 ms(權限查詢 15 → 1 次)273 個資料庫 migration約 361 個資料庫函式約 108 條列級權限規則約 2,700 個先於開發登記的測試案例1,364 次提交中 1,181 次標示 AI 代理共同作者

更多案例