sky121113
3ce88ed342
- 機台日誌：對齊 Luxury UI 規範，實作整合式佈局與分頁組件。 - 多語系：完成機台日誌繁、英、日三語系翻譯與動態處理。 - UI 規範：更新 SKILL.md 定義「標準列表 Bible」。 - 後端：完善 TenantScoped 隔離邏輯，修復儀表板死循環與 User Model 缺失。 - IoT：擴展機台、會員 Model 並建立交易、商品、狀態等核心表結構。 - 基礎設施：設置台北時區與 Docker 環境變數同步。
2.2 KiB
2.2 KiB
IoT API 測試與對接文件 (IoT API Testing & Documentation)
本文件紀錄 Star Cloud IoT API 的測試紀錄與對接規格，供後續開發與測試追蹤。
🟢 B010: 心跳上報與狀態同步 (Heartbeat & Status)
機台定時（建議每 5-10 秒）上送，用於確認連線狀態、溫度及門禁狀態。
1. API 資訊
- Endpoint:
POST /api/v1/app/machine/status/B010 - 認證方式: Bearer Token (或 Request Body 帶
key) - 處理方式: 異步處理 (Redis Queue)，立即回傳 202。
2. 請求範例 (JSON)
{
"temperature": 5.2,
"door_status": 0,
"current_page": "home",
"firmware_version": "1.0.5",
"log": "Status heartbeat test",
"log_level": "info"
}
3. 回應規格
- 成功:
202 Accepted
{
"success": true,
"code": 200,
"message": "OK",
"status": "49"
}
🔵 B600: 交易紀錄上報 (Transaction Record)
當機台端完成交易（收款或扣點成功）後上傳。
1. API 資訊
- Endpoint:
POST /api/v1/app/B600 - 認證方式: Bearer Token
- 處理方式: 異步處理 (Redis Queue)。
2. 請求範例 (JSON)
{
"flow_id": "F123456789",
"total_amount": 100,
"pay_amount": 100,
"payment_type": 1,
"items": [
{
"product_id": 1,
"product_name": "Test Product",
"price": 50,
"quantity": 2
}
]
}
📝 測試紀錄 (Test Logs)
2026-03-16: B600 交易功能測試
- 測試機台:
SN001 - 測試方式:
curl命令模擬 - 驗證項目:
- HTTP 回傳
202 - 資料庫
orders產生紀錄 - 資料庫
order_items產生紀錄
- HTTP 回傳
- 結果: 準備中...
2026-03-16: B010 首次演練測試
- 測試機台:
SN001 - 測試方式:
curl命令模擬 - 驗證項目:
- HTTP 回傳
202 - 資料庫
machines.last_heartbeat_at更新為台北時間 machine_logs產生對應日誌
- HTTP 回傳
- 測試備註: 過程中發現
current_page為tinyInteger導致寫入失敗，已將其修改為string以支援彈性的頁面名稱。 - 結果: ✅ 成功 (SUCCESS)。機台狀態已同步為 5.2度，當前頁面「home」。