Wade Lee

CHALLENGE

第三方 callback 可能重送、同時到達、亂序，或在本地處理到一半時中斷；促銷配額與庫存也可能在競爭下超賣。

WHAT I BUILT

• PostgreSQL advisory locks＋unique constraint＋INSERT ON CONFLICT，避免 callback 重送或併發造成重複建單
• Callback 即時查帳，核對付款狀態、金額與 TradeNo，確保資料一致後才建立訂單
• Inbox-like durable callback log＋reconciliation jobs，支援限次 retry、orphan takeover 與下游補送，避免建單或開票永久卡住
• Temporary payment snapshot＋frozen cart，避免付款期間購物車變更造成訂單不一致
• Conditional atomic SQL update＋compensation，避免 Bundle 庫存與 Flash Sale 配額在並行結帳下超賣
• Production container 採最小權限執行，降低資安風險
• Migration fingerprint＋deployment health gate，阻擋不健康 release 與 schema-incompatible rollback
• 每日與部署前的 PostgreSQL 加密備份上傳至 GCS，保留資料恢復能力
• 透過 GIN index 避免商品搜尋隨資料量增加退化成全表掃描

TRADE-OFF

Raw SQL、PostgreSQL locks 與 GIN index 提高了資料庫綁定及索引維護成本，換取並行正確性、可修復性與部署安全。

CHALLENGE

熱門教師時段可能被多人同時預約；付款與自動續訂 callback 可能重複送達；大型影片需要可靠上傳、受控存取與可拖曳播放。

WHAT I BUILT

• 針對付款與自動續訂 callback，在 database transaction 中完成簽章驗證、金額核對、付款紀錄鎖定與狀態檢查，確保重送只會生效一次，避免重複建立或延長訂閱
• 預約時鎖定教師的可預約時段並重新檢查衝突，再由資料庫層阻止同一教師時段被重複建立
• 實作大型影片分片上傳，並透過短效簽名 URL 提供受保護的 MP4 播放；瀏覽器使用 byte-range requests 按需載入影片內容
• 使用 Spatie Permission 建立 RBAC，搭配 Laravel Policy、Gate、資源所有權與訂閱狀態檢查，控制不同角色對課程、作業、附件及影片的存取
• 串接信用卡綁定與自動續訂，加密保存金流服務提供的綁卡識別資料，並處理續訂成功、扣款失敗、重試及寬限期

TRADE-OFF

Laravel monolith 與 database queue 降低部署及維運複雜度，加快產品交付，也保留未來將高負載非同步工作水平擴展至獨立 workers 的空間。

CHALLENGE

scheduler 可能重複結算；贈品在領用、調撥與日報同步時可能出現負庫存或失去稽核軌跡。

WHAT I BUILT

• 使用 transaction-level PostgreSQL advisory lock 依週／日期互斥結算
• 保存 batch running／completed／failed，並以 dedup key 防止重複通知
• 建立 gift lot、warehouse balance、transfer 與 movement ledger
• mutation 鎖定 rows，搭配 nonnegative constraints、audit logs 與 owner-based access

TRADE-OFF

使用 PostgreSQL lock 省去 Redis distributed lock；domain 擴張後，handler 邏輯應逐步抽成 application services。