跳至專案清單
ANLAN.STORE

專案資產庫

pulseboard project image

pulseboard

运营脉冲板

面向外貿 SaaS 場景的工程模板:以 Hono、PostgreSQL、Redis、BullMQ 串起十種已實作介面語言、API key 邊界、OpenAPI、健康探測、worker 與驗證腳本。

問題

可靠性工程無法只靠截圖判斷。PulseBoard 必須呈現系統邊界、失敗行為與運維控制,讓小型 SaaS 的可信度可被檢查。

我的角色

我負責公開產品介面、API 契約、持久化模型、工作佇列、部署計畫與驗證套件的設計及實作。

限制條件

系統必須維持低成本、可在本機重現、清楚劃分驗證邊界,且部署時不提交秘密。

關鍵決策

Hono 維持 API 精簡,PostgreSQL 管理持久狀態,Redis 與 BullMQ 隔離非同步檢查,Nginx 則維持 `/demo/` 下穩定的公開命名空間。

架構

請求先通過 API 金鑰邊界,再進入工作區範圍資源。工作送入佇列,由 worker 執行檢查;健康端點分別呈現存活與相依服務就緒狀態。

工程證據

線上控制台、客戶介面、OpenAPI、健康探針、測試、ADR、部署 Runbook 與公開介面驗證器共同構成工程證據。

成果

成果是一套可檢查的工程系統:訪客能從產品行為一路追到 API 與運維證據,不依賴虛構的使用數據。

限制與下一步

這仍是審閱規模的部署。負載測試、多區域容錯與正式告警投遞目前不在證據範圍內。