terrylee/star-cloud
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
218 Commits 16 Branches 0 Tags 11 MiB
40aec884b0
Commit Graph

15 Commits

Author SHA1 Message Date
sky121113
40aec884b0 [REFACTOR] 溫度回報邏輯優化與 MQTT 規格標準化 
1. 優化 ProcessHeartbeat 溫度處理邏輯，改為「變動即記錄」並標準化為整數型態。
2. 在 Machine Model 中新增 temperature 欄位的 integer cast。
3. 更新 MQTT 與 API 技術規格技能文件 (SKILL.md)，同步最新的溫度記錄規則。
4. 更新 config/api-docs.php，明確標註心跳上報之溫度規格與日誌規則。
5. 移除 routes/api.php 中已廢棄之 B600 與機台日誌 REST API 路由。
6. 清理 docs 目錄，將初期計畫文件遷移至 docs/plan/。
 2026-04-22 17:02:24 +08:00
sky121113
680d922e1f feat: add ProcessErrorLog job to handle B013 mqtt errors 2026-04-22 16:36:56 +08:00
sky121113
f49c1d3058 feat: implement mqtt transaction business logic and fix sidebar syntax error 2026-04-22 16:35:47 +08:00
sky121113
ae554ef130 [FEAT] 重構與深化 MQTT 通訊規範並優化 API 文件中心 
1. 重構 config/api-docs.php，將 HTTP API 與 MQTT Topic 徹底解耦，建立清晰的協議分類。
2. 實作 api-docs.blade.php 雙頁籤 (HTTP/MQTT) 介面，優化「極簡奢華風」視覺呈現與互動體驗。
3. 詳細定義 MQTT 指令下發 Payload，包含遠端出貨、庫存同步、遠端找零及系統控制。
4. 新增 Heartbeat (心跳) 與 Transaction (交易) MQTT 主題規範，確保 APP 端有明確的對接基準。
5. 修正 Heartbeat Payload 參數，僅保留實際傳送的溫度與韌體版本，確保文件與現況對齊。
6. 移除 B012 (商品同步) 尚未實作的 PATCH 方法，統一只保留 GET 方法以維持系統一致性。
7. 同步更新 SKILL.md 技術規格文件，確保開發規範與實際程式碼邏輯完全對等。
 2026-04-22 16:25:48 +08:00
sky121113
c1bf9294cd [DELETE] 移除 B010 (Heartbeat) HTTP API 殘留與文件 
1. 從 config/api-docs.php 中完全移除 B010 配置。
2. 清理 routes/api.php 中關於 B010 的註解。
3. 更新 api-technical-specs/SKILL.md，將依賴 B010 的觸發描述改為 MQTT 指令。
4. 補上 B010 在 SKILL.md 中的廢棄區塊並導向 MQTT 規範。
 2026-04-21 16:50:30 +08:00
sky121113
82832d04db [DELETE] 移除已過時的 B013 HTTP API 端點 
1. 移除 routes/api.php 中的 B013 路由。
2. 移除 MachineController@reportError 方法及其註解。
3. 更新 config/api-docs.php，移除 B013 文件配置。
4. 更新 api-technical-specs/SKILL.md，將 B013 標註為已廢棄並引導至 MQTT 规范。
 2026-04-21 16:46:54 +08:00
sky121113
f49938d1a7 [DOCS] 補齊 B024, B027, B055 API 技術規格與文檔定義 
1. 更新技術手冊 (SKILL.md) 與 API 規格文件 (api-docs.php)，補齊 B024, B027, B055 之定義。
2. 修正文件序號跳號問題，確保 B017 序號正確銜接。
3. 詳細說明 B055 之指令 ID 遠端出貨運作機制。
 2026-04-14 17:36:56 +08:00
sky121113
2702e5a655 [REFACTOR] 標準化 IoT API 方法並修正日期格式 
1. 將 B014 (參數下載) 與 B017 (貨道同步) 路由從 POST 改為 GET。
2. 移除 B017 冗餘的 machine 參數，改由 Bearer Token 自動識別。
3. 修正 B017 回傳資料中 expiry_date 的 ISO 8601 格式問題，統一為 Y-m-d。
4. 同步更新所有技術規格文件 (.agents/ 規範) 與 API 說明配置 (config/api-docs.php)。
 2026-04-14 16:46:35 +08:00
sky121113
66f7c1ffb8 [FEAT] 實作 B017 貨道庫存全量同步 API 與多語系支援 
1. 實作 B017 (reload_msg) 端點，支援貨道庫存、效期與批號的全量同步。
2. 將 B017 回傳欄位映射至 App 需求：slot_no -> tid, stock -> num。
3. 新增 expiry_date (效期) 與 batch_no (批號) 欄位支援。
4. 實作指令狀態閉環邏輯，成功同步後自動將相關 reload_stock 指令標記為成功。
5. 將指令備註欄位多語系化，新增「庫存已與機台同步」繁中、英文、日文翻譯。
6. 更新 API 技術規格文件 (.agents/skills) 與系統 API 文件配置 (config/api-docs.php)。
 2026-04-14 15:06:51 +08:00
sky121113
8f008ffb61 [FEAT] 實作 B014 機台參數下載 API 與 B000 登入認證強化 
1. 強化 B000 登入接口：驗證成功後回傳 Sanctum Token 供後續初始化使用。
2. 實作 B014 (getSettings) API：整合機台、金流與發票設定，並映射至 Android App 預期欄位。
3. 強化安全性：B014 API 掛載 auth:sanctum 並執行 RBAC 權限檢查。
4. 更新 API 說明文件 (iot-spec.md, api-docs.php) 及技術規範 (SKILL.md)。
 2026-04-13 17:04:52 +08:00
sky121113
a599b14df1 [FEAT] 優化機台硬體通訊協議與管理介面互動性 
1. 修復帳號管理與角色權限頁面搜尋功能，支援 Enter 鍵快捷提交。
2. 完成 B013 (機台故障上報) API 實作，改用非同步隊列 (ProcessMachineError) 處理日誌上報。
3. 精簡 B013 API 參數，移除冗餘的 message 欄位，統一由雲端對照表翻譯。
4. 更新技術規格文件 (SKILL.md) 與系統 API 文件配置 (api-docs.php)。
5. 修正平台管理員帳號在搜尋過濾時的資料隔離邏輯。
 2026-04-08 14:52:00 +08:00
sky121113
c343df34ee [FEAT] 實作 B012 商品同步 API 與統一圖片絕對網址格式 
1. 實作 B012 API：新增 /api/v1/app/machine/products/B012 端點，支援 GET (全量) 與 PATCH (增量) 同步邏輯。
2. 統一圖片 URL：在 B005 與 B012 API 中使用 asset() 確保回傳絕對網址 (Absolute URL)，解決 App 端下載相對路徑的問題。
3. 文件更新：同步更新 SKILL.md 的欄位定義，並在 api-docs.php 補上 B012 的正式規格說明。
4. 資料庫變更：新增 machine_slots 表的 type 欄位與相關註解遷移。
5. 格式優化：為技術規格文件中的 API 欄位與狀態碼加上反引號，提升文件中心可讀性。
 2026-04-07 17:05:28 +08:00
sky121113
f2147ae6c4 [FEAT] 完善 IoT API 規范化、機台管理介面優化與 B005 改為 GET 
1. 將 B005 (廣告同步) 從 POST 改為 GET，符合 RESTful 規範。
2. 完善 B009 (庫存回報) 回應規格，加入業務代碼 (200 OK)。
3. API 文件 UI 優化：新增 Method Badge (方法標籤)，並修正 JSON 中文/斜線轉義問題。
4. 機台管理介面優化：實作「唯讀庫存與效期」面板，並將日誌圖示改為「👁️」。
5. 標準化 ID 識別邏輯：資料表全面移除對 sku 的依賴，改以 id 為主、barcode 為輔。
6. 新增 Migration：正式移除 sku 欄位並同步 barcode 指向。
7. 更新多語系支援 (zh_TW, en, ja)。
 2026-04-07 14:37:57 +08:00
sky121113
08b6c60d2e [FEAT] 實作 B000 機台登入 API 並同步 API 規格文件 
1. 於 routes/api.php 新增 B000 登入驗證路由，並設定速率限制。
2. 更新 .agents/skills/api-technical-specs/SKILL.md，補上 B000 規格並根據 Java App 實作精簡 B010 指令碼。
3. 同步更新 config/api-docs.php 中的 API 說明文件。
4. 調整 RemoteController 指令歷史紀錄上限為 5 筆以優化效能。
5. 統一機台編輯頁面之圖片上傳文字說明與標題。
6. 補齊多語系翻譯檔案 (zh_TW, en, ja) 出現的新字串。
 2026-04-02 17:24:13 +08:00
sky121113
17b5c1a316 [DOCS] 現代化 IoT API (B010) 通訊協議與文件中心 UI/UX 重整 2026-03-26 14:59:49 +08:00