sky121113
773396fc90
All checks were successful
star-cloud-deploy-demo / deploy-demo (push) Successful in 52s
1.9 KiB
1.9 KiB
[暫緩執行] B710 API (計時器狀態回傳) 技術規範與執行指南
本文件定義 B710 API 的技術實作規範，用於處理計時型設備（如洗衣服務、按摩服務）的剩餘時間監測與狀態回報。
1. 業務流程與資料流
1.1 狀態回報
- 回報內容：機台定期回報特定貨道 (product/timer) 的
remaining_seconds(剩餘秒數) 與目前狀態。 - 資料用途：
- 即時監控：供管理後台儀表板顯示設備的使用進度。
- 稼動分析：紀錄設備的總租用時數與閒置率。
2. 執行面機制 (Execution Strategy)
- 異步處理：由於計時狀態可能高頻回報，系統應優先將數據更新至 Redis 快取，以確保前端查詢的高效能與資料庫的負擔平衡。
3. 資料庫結構：timer_statuses
| 欄位 | 說明 | 備註 |
|---|---|---|
machine_id |
機台 ID | |
product_id |
產品/服務 ID | |
remaining_seconds |
剩餘秒數 | |
status |
運行狀態 | 1:運行中, 0:停止 |
4. 待確認事項 (To-be-confirmed)
以下議題目前皆列為待確認，將於後續開發階段釐清：
4.1 回報頻率與快取
- 更新頻率：確認機台呼叫 B710 的精確頻率，以及資料庫寫入的節流策略（例如：僅在關鍵變動或每分鐘寫入一次）。
4.2 遠端通知與異常
- 結束通知：倒數結束時，雲端是否需主動對對消費者發送推播或系統訊息？
- 斷線判定：針對長期未回報的計時器，雲端應自動判定為結束還是異常？
4.3 復歸機制
- 斷電補償：機台意外斷電重啟後，是否需向雲端 B010 撈回最後的剩餘秒數以恢復服務？
4.4 報表需求
- 稼動分析：後台是否需要針對此數據計算「設備利用率」等績效指標。