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

45 Commits

Author SHA1 Message Date
sky121113
b21ea670bf [FIX] 修正遠端指令中心機台列表顯示與規格文件更新 
1. 修正 `tab-machines-index.blade.php` 最後通訊時間的 HTML `<template>` 渲染錯誤，確保正常顯示。
2. 更新 `index.blade.php` 的 `formatTime` 邏輯，超過 2 小時的通訊時間將顯示完整日期與時間，與庫存頁面格式統一。
3. 更新 `tab-machines.blade.php` 與語系檔，將庫存警示相關文案精準化為「庫存警示 (Inventory Alerts)」與「庫存穩定 (Inventory Stable)」。
4. 更新 `api-technical-specs/SKILL.md` 中對於 B017 API 的描述，強調其為機台端主動拉取資料，而非單純依賴 MQTT 觸發。
5. 修正 `iot-communication/SKILL.md` 中 Redis Key 前綴的說明，對齊實際讀取 `.env` (`MQTT_REDIS_PREFIX`) 的設定。
 2026-04-22 12:33:01 +08:00
sky121113
1d5aff2f2e [REFACTOR] 遷移遠端管理指令至 MQTT 非同步架構與邏輯優化 
1. 實作 MqttService 統一管理 MQTT 指令發送。
2. 遷移「遠端庫存與效期中心」至 MQTT 流程，並加入 batch_no (批號) 支援。
3. 修改 RemoteController 指令中心所有指令同步改由 MQTT 推送。
4. 修正 Go Gateway redis_consumer.go 確保 JSON 格式符合最新規格（移除寫死的 target/message_id）。
5. 實作 ProcessCommandAck 自動更新指令結果、異常回滾 (Rollback) 與機台自動亮燈 (Online)。
6. 完善 mqtt-communication-specs 規格文件，補齊所有指令定義與 ACK 範例。
7. 強化指令狀態保護，確保只有 pending 狀態的指令能被更新結果，防止重複處理。
 2026-04-22 11:30:39 +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
45b5ee5acd [REFACTOR] 整合 MQTT 異常上報與 MachineService 硬體代碼映射 
1. 重構 ProcessMachineError Job，將異常日誌記錄邏輯統一由 MachineService@recordErrorLog 處理，確保 error_code 能正確對應多語系標籤。
2. 更新 SKILL.md MQTT 通訊規範，修正機台故障上報 (B013) 的 Payload 範例並修復章節編號錯誤。
3. 優化 deploy-demo.yaml CI/CD 流程，解決檔案變動導致 tar 退出碼為 1 的部署中斷問題，並排除不必要的 storage 目錄同步。
 2026-04-21 16:35:20 +08:00
sky121113
2aa0bf23ab [FIX] 優化 CI/CD 部署流程與更新 MQTT 心跳規範 
1. 修復 .gitea/workflows/deploy-demo.yaml：改用 bash 函式處理 tar 同步，容許 exit code 1 (檔案變動警告) 並攔截致命錯誤。
2. 更新 .agents/skills/mqtt-communication-specs/SKILL.md：簡化心跳上報 (Heartbeat) 規範，僅保留 firmware_version 與 temperature 欄位。
 2026-04-21 16:01:32 +08:00
sky121113
d0f84eb82b [REFACTOR] 廢棄 B010 HTTP API 並整合 MQTT 心跳回報流程 
1. 移除 routes/api.php 中的 B010 心跳上報路由。
2. 刪除 MachineController.php 中的 heartbeat 方法與相關過期邏輯。
3. 刪除 docs/b010_technical_spec.md 並更新相關技術規格文件。
4. 修改 ListenMqttQueue.php，移除獨立的溫度與版本號處理，統一由 heartbeat 任務分發。
5. 更新 MQTT 通訊規範，廢棄獨立的屬性 Topic (temperature, firmware_version)。
 2026-04-21 15:48:49 +08:00
sky121113
32bc13ac1b [FIX] 修復 MQTT 監聽器與機台連線狀態同步邏輯 
1. 補齊 ListenMqttQueue 中的 Job 類別引用，修復 mqtt-worker 崩潰重啟問題。
2. 實作 Go Gateway 的 Client ID 解析邏輯，正確將 SC_{serial}_{random} 格式還原為機台編號。
3. 修復  系統主題解析與 Laravel ProcessStatus Job 對齊，實現毫秒級連線狀態同步。
4. 在 ProcessStatus Job 中增加第二層 serial_no 清理保險，提高系統容錯。
5. 更新機台列表 UI 狀態顯示邏輯，支援 在線/斷線/故障 三態顯示與多語系。
6. 更新 MQTT 通訊規範 (Skill) 文件，確保全域開發定義的一致性。
7. 同步更新 zh_TW.json, en.json, ja.json 翻譯文件。
 2026-04-21 12:38:42 +08:00
sky121113
23225ffe3f [DOCS] 更新 MQTT 即時通訊規範，新增 App 端 WSS 連線標準 
1. 補齊各連線通道 (TCP/SSL/WS/WSS) 的埠號建議表。
2. 新增 App 端 (Android) WSS 連線專節，包含 URL 參數與密碼雜湊要點。
3. 提供 HiveMQ Client 初始化範例程式碼。
4. 定義 MQTT 優先、HTTP 兜底的 Fallback 通訊機制與時間窗口。
 2026-04-17 17:25:20 +08:00
sky121113
e3ad7dd44f [DOCS] 修正並對齊 Demo 環境基礎設施資訊 
1. 更新 README.md 與 framework.md 中的 Demo 環境網域、伺服器指令、部署路徑。
2. 更新 Gitea Workflow (.gitea/workflows/) 中的 Gitea 官方網址 (gitea.setdomains.work)。
3. 更新遠端部署模板中的舊 IP、路徑與機器人信箱，確保全站文件一致性。
 2026-04-17 10:30:05 +08:00
sky121113
959625a640 [FEAT] 實作 MQTT Gateway 整合與高併發 IoT 通訊架構 
1. 導入 Go 語言撰寫的 MQTT Gateway (mqtt-gateway/)，負責訊息接收並透過 Redis List 轉發至 Laravel。
2. 更新 compose.yaml 以包含 EMQX Broker 與 mqtt-gateway 服務，並配置相關環境變數。
3. 新增 ListenMqttQueue 指令與對應的異步處理 Job (ProcessHeartbeat, ProcessTransaction, ProcessMachineError)。
4. 實作 MqttSyncAuth 指令與 Machine Model Observer，支援自動化的機台認證資訊同步至 Redis。
5. 新增 MqttCommandService 用於處理雲端至機台的即時指令下發。
6. 更新專案規範文件 (framework.md 與 Skills) 以反映新的 MQTT 通訊機制與安全性規範。
7. 提供 simulate-heartbeat.sh 指令碼以供開發與測試使用。
 2026-04-16 14:28:42 +08:00
sky121113
376f43fa3a [FIX] 修正 IoT 管理介面分頁持久化與實作 B055 遠端出貨 API 
1. 視圖持久化優化：將 index/stock 視圖切換從 x-if 改為 x-show，解決 HSSelect 在切換分頁後失效的問題。
2. 變數存取安全：為所有 selectedMachine 屬性存取補上可選鏈 (?.) 保護，防止 x-show 模式下的 null 錯誤。
3. UI 體驗提升：放大「指令中心」與「庫存管理」歷史紀錄的時間字體至 15px 並加粗顯示。
4. API 功能實作：在 routes/api.php 與 MachineController 中實作 B055 遠端指令出貨控制端點。
5. 文件同步：更新 SKILL.md 技術規格文件，明確定義 B055 的請求與回應格式。
6. 樣式調整：修改 app.css 優化奢華風 UI 字體與間距細節。
 2026-04-15 10:54:58 +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
32fa28dc0f [DOCS]：初始化 MQTT 架構實作計畫與相關技術規範 
1. 新增 MQTT 即時通訊與 Topic 規範文件 (.agents/skills/mqtt-communication-specs/SKILL.md)。
2. 建立 MQTT 基礎架構實作計畫文件 (docs/mqtt-implementation-plan.md)。
3. 更新全域開發框架規範 (framework.md)，納入 Go Gateway 與 EMQX 架構說明。
4. 重構 IoT 通訊處理規範 (iot-communication/SKILL.md)，支援 HTTP 與 MQTT 雙軌管線。
5. 更新背景 API 規範 (api-rules.md) 與技能觸發規則 (skill-trigger.md) 以符合新架構。
 2026-04-14 13:02:08 +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
b60afc3abe [FIX] 修正與標準化 B005 廣告下載 API 以相容既有 Android App 
1. 修改 MachineController@getAdvertisements 回傳欄位，將 t070v02 改為播放秒數，t070v03 改為位置代碼 (Flag)。
2. 根據 Android App 原始碼分析結果，調整位置對應：3 為待機廣告 (HomeActivity)，1 為販賣頁廣告 (FontendActivity)。
3. 在 AdvertisementController@getMachineAds 增加 sort_order 排序，確保後台管理介面視圖與 API 輸出順序一致。
4. 更新廣告下載 API 的技術文件 (SKILL.md)，明確標記欄位用途與位置代碼。
5. 在 routes/api.php 補上 B005 與 B009 的路由定義。
 2026-04-07 11:41:24 +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
e085058d63 [FEAT] 遠端指令中心優化與規格同步 
1. 實作遠端指令去重機制 (Supersede)：避免重複下達相同待執行指令。
2. 修正遠端指令發送後的 Toast 提示邏輯，確保頁面跳轉後正確顯示回饋。
3. 增加 RemoteCommand 操作者 (user_id) 紀錄與狀態列舉擴充 (superseded)。
4. 修復機台列表「最後頁面」欄位對照錯誤，同步更新 Machine Model 與 API 規格。
5. 優化遠端指令中心 UI：放大卡片字體、調整側面欄間距，符合極簡奢華風規範。
6. 更新 API 技術規格書 (SKILL.md) 與 config/api-docs.php，補全所有機台代碼 (66-611) 與指令。
7. 補全繁體中文、英文、日文多語系翻譯檔案。
 2026-04-02 14:57:41 +08:00
sky121113
ea0333d77e [STYLE] 系統用語標準化與客戶管理 UI 點選透明度優化 (所屬單位 -> 公司名稱、姓名 -> 名稱) 2026-03-30 10:16:05 +08:00
sky121113
c875ab7d29 [FEAT] 移除「商品狀態」冗餘模組、優化麵包屑導航與完善帳號角色過濾邏輯 2026-03-27 16:53:43 +08:00
sky121113
ac51027dda [DOCS] 建立獨立 API 技術規格技能 (api-technical-specs) 並精簡 IoT 通訊規範 2026-03-26 15:03:00 +08:00
sky121113
17b5c1a316 [DOCS] 現代化 IoT API (B010) 通訊協議與文件中心 UI/UX 重整 2026-03-26 14:59:49 +08:00
sky121113
87ef247a48 [FIX] 整合機台效期管理功能並優化 UI 比例 
- 修正 Alpine.js 作用域問題，恢復效期編輯彈窗功能
- 整合機台日誌與效期管理至主列表頁 (Index)
- 優化大螢幕貨道格線佈局，解決日期折行問題
- 縮小彈窗字體與內距，調整為極簡奢華風 UI
- 新增貨道效期與批號欄位之 Migration 與模型關聯
- 補齊中、英、日三語系翻譯檔
 2026-03-24 16:46:04 +08:00
sky121113
38770b080b [FEAT] 優化帳號管理授權顯示邏輯與 UI 樣式一致性 2026-03-23 17:16:26 +08:00
sky121113
d2cefe3f39 [FEAT] 完善全站多語系支援、角色權限篩選優化及 UI 元件重構 
- [DOCS] 補齊 en, ja, zh_TW 語系檔翻譯並完善驗證錯誤訊息 (validation.php)
- [FEAT] 角色權限頁面新增「所屬單位」篩選功能 (僅限系統管理員)
- [STYLE] 優化角色列表顯示，將「類型」變更為具體「所屬單位」名稱
- [STYLE] 修正角色頁面工具列佈局，搜尋框置前並修正下拉箭頭顯示
- [REFACTOR] 統一全站刪除確認視窗，導入新版 <x-delete-confirm-modal /> 組件
- [REFACTOR] 優化 PermissionController 查詢效能 (Eager Loading)
- [FIX] 修正 RoleSeeder 角色命名與資料庫同步邏輯
 2026-03-20 13:41:51 +08:00
sky121113
f00fc940a9 [DOCS] 更新 RBAC 實作規範與角色初始化流程建議 2026-03-19 17:18:21 +08:00
sky121113
3f41896532 [FEAT] 補全機台與金流設定多語系，並調整帳號管理表格佈局 2026-03-18 13:52:54 +08:00
sky121113
99243d4206 [STYLE] 統一全站次要資訊字體規範並更新 UI Skill 文件 2026-03-17 17:44:09 +08:00
sky121113
fc79148879 [FEAT] 實作角色權限分類、租戶角控管理與介面多語系優化 
1. [FEAT] 權限劃分為「系統層級」與「客戶層級」，並在後端強制過濾跨權限分配。
2. [FEAT] 整合選單權限至主選單層級 (基本設定、權限設定)，簡化角色管理 UI。
3. [STYLE] 側邊欄優化：補齊多語系翻譯，並為基本設定子選單增加視覺圖示。
4. [REFACTOR] 更新 RoleSeeder，將 tenant-admin 重新分類為客戶層級角色。
 2026-03-17 16:53:28 +08:00
sky121113
3ce88ed342 [FEAT] 重構機台日誌 UI 與增加多語系支援，並整合 IoT API 核心架構 
- 機台日誌：對齊 Luxury UI 規範，實作整合式佈局與分頁組件。
- 多語系：完成機台日誌繁、英、日三語系翻譯與動態處理。
- UI 規範：更新 SKILL.md 定義「標準列表 Bible」。
- 後端：完善 TenantScoped 隔離邏輯，修復儀表板死循環與 User Model 缺失。
- IoT：擴展機台、會員 Model 並建立交易、商品、狀態等核心表結構。
- 基礎設施：設置台北時區與 Docker 環境變數同步。
 2026-03-16 17:29:15 +08:00
sky121113
1851e91c86 [REFACTOR] 簡化權限管理介面，整合權限設定至角色管理，並完成多語系支援 2026-03-16 13:47:16 +08:00
sky121113
56daf8940b [FEAT] 優化部署流程：加入 RoleSeeder 與 AdminUserSeeder，並實作權限系統基礎架構與多租戶隔離機制 2026-03-13 17:35:22 +08:00
sky121113
39d25ed1d4 [REFACTOR] 移除 framework.md 中重複的環境與時區規範 2026-03-13 10:50:33 +08:00
sky121113
78597f1c68 [FIX] 移除個人檔案姓名輸入框的 autofocus 並恢復開發規範文件內容 2026-03-13 10:47:39 +08:00
sky121113
588704642b [DOC] 更新 framework.md 加入 IP 偵測特性說明 2026-03-13 10:43:38 +08:00
sky121113
773396fc90 [REFACTOR] 實作側邊欄與儀表板多語系化，修復 UI 位移與樣式優化 2026-03-12 17:42:57 +08:00
sky121113
d679c0df17 [FIX] 更新技能觸發路徑：修正因技能更名導致的 broken links 並指向新的全域規範路徑。 2026-03-09 15:04:17 +08:00
sky121113
03dfcc9c7e [REFACTOR] 更新技能觸發規則：將 Eloquent 優化規範提升為全域技能並同步至觸發清單。 2026-03-09 14:59:38 +08:00
sky121113
682a9e7ac3 [FEAT] 儀表板 UI 大改造、中文化與項目開發規範同步 (含深色模式修復) 2026-03-09 11:30:06 +08:00
sky121113
c30c3a399d feat: 實作機台日誌核心功能與 IoT 高併發處理架構 2026-03-09 09:43:51 +08:00