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

444 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
sky121113
8feca33f13 [FEAT] 優化機台日誌管理、新增庫存變動紀錄與取貨碼/通行碼介面改善 
1. 新增機台異常日誌手動解除功能，包含資料庫欄位更新與 UI 操作按鈕。
2. 實作機台庫存變動紀錄系統 (Machine Stock Movements)，支援追蹤補貨與銷售產生的庫存異動。
3. 重構取貨碼 (Pickup Code) 與通行碼 (Pass Code) 管理介面，採用極簡奢華風 UI 並拆分 Partial Views 提升可維護性。
4. 優化取貨操作日誌，明確區分「取貨成功」與「取貨失敗」，並加入顏色標籤增強辨識度。
5. 擴充多語系支援 (繁中、英文、日文)，確保所有新功能與操作狀態均有對應翻譯。
6. 更新 IoT API 規格文件與相關 Service 邏輯，加強指令確認 (ACK) 處理機制。
 2026-05-04 08:43:35 +08:00
sky121113
cb5f8f8336 [FIX] 修正 SystemOperationLog 中的 User 模型路徑錯誤 2026-04-30 10:29:25 +08:00
sky121113
820e1c87db [FIX] 取貨碼操作紀錄顯示異常修正 
1. 修正 index.blade.php 的 HTML 標籤嵌套錯誤，解決操作紀錄分頁空白問題。
2. 移除暫時的除錯訊息。
3. 整合 SystemOperationLog 機制於取貨碼模組。
 2026-04-30 10:28:04 +08:00
sky121113
84bf7de750 [FEAT] 實作通行碼編輯功能與 UI 組件優化 
1. 實作通行碼 (Pass Code) 編輯功能，包含後端 Controller 邏輯與前端 Alpine.js 編輯彈窗。
2. 優化 searchable-select 組件的空值處理與樣式。
3. 更新繁體中文語系檔，統一通行碼相關操作之回傳訊息翻譯。
4. 修正通行碼更新邏輯，支援 nullable 狀態與到期日空值處理。
5. 在桌機版與手機版介面加入編輯操作入口。
 2026-04-30 09:28:07 +08:00
sky121113
b42695c4b8 [FEAT] 優化通行碼與取貨碼模組、補齊多國語系系統及介面風格調整 
1. 通行碼與取貨碼：新增代碼預覽、重新產生功能與到期時間預覽邏輯。
2. 通行碼：允許天數設為 0 (永久)，並改用搜尋式下拉選單選取機台。
3. 取貨碼：加強表單檢核並整合自訂 Toast 提示。
4. 語系優化：補齊繁中、英文鍵值，並完整建立日文語系目錄 (lang/ja) 與 JSON 檔案。
5. 組件優化：更新 PageHeader 與 TabNav 組件，提升 UI 互動性與一致性。
6. 訪客功能：新增通行碼訪客端查詢介面與控制器。
7. 其他模組：同步調整機台、遠端與倉庫模組視圖以符合極簡奢華風。
 2026-04-29 16:54:21 +08:00
sky121113
7356304d6f [STYLE] 機台分佈地圖行動端優化與補貨管理邏輯修正 
1. 機台分佈頁面行動端優化：新增懸浮標題切換按鈕、抽屜式列表與毛玻璃視覺效果。
2. 修正補貨單指派視窗：優化下拉選單初始化邏輯，解決二次開啟時的選擇殘留問題。
3. 更新多語系檔 (zh_TW, en, ja)：補齊機台分佈與補貨管理相關詞彙。
4. 移除暫存的簡報檔案 (star-cloud-demo-day.pptx)。
 2026-04-29 11:29:42 +08:00
sky121113
6b9b577978 [FEAT] 取貨碼功能強化與 UI 重構 
1. 取貨碼模組新增 Slug 機制與公開憑證頁面，支援外部連結訪問。
2. 狀態篩選下拉選單重構為極簡奢華風組件 (x-searchable-select)，並優化後端空值處理。
3. 機台分佈地圖新增「依型號分類」功能，提升管理便利性。
4. 新增 B660 取貨碼驗證 API 端點供機台通訊使用。
5. 更新多語言語系檔 (zh_TW.json) 確保介面一致性。
 2026-04-29 10:39:35 +08:00
sky121113
78321ad693 [FEAT] 取貨碼功能優化與 QR Code 生成標準化 
1. 修復 PickupCode 與 PassCode 模型中 User 命名空間錯誤。
2. 建立統一的 x-qr-code 組件，取代外部 API 並收斂至系統後端路由。
3. 優化取貨碼管理介面：將機台與商品貨道資訊拆分欄位，並動態顯示關聯商品名稱。
4. 補全 status-badge 組件中已使用、已過期與已取消的狀態樣式。
5. 修復取貨碼產生過程中的 Carbon 型別錯誤與 company_id 缺失問題。
 2026-04-28 17:25:59 +08:00
sky121113
0332eff9bc [FIX] 修正角色權限顯示邏輯與 UI 組件重構 
1. 修正角色編輯頁面、列表頁面與卡片視圖中的權限數量計算邏輯，確保過濾掉無效或隱藏權限。
2. 重構角色權限顯示 UI，將彈窗由不穩定的 Popover 改為基於 Alpine.js x-teleport 的全螢幕置中模窗，解決容器遮擋問題。
3. 抽離並組件化角色清單 (role-list) 與卡片 (role-card) 視圖，提升程式碼複用性。
4. 統一子帳號管理頁面的搜尋與重設按鈕佈局，確保全站視覺一致性。
5. 更新多語系翻譯，修正『租戶』為『客戶』，並新增『全部權限』翻譯項。
6. 完成取貨碼與密碼管理模組的極簡奢華風 UI 遷移。
 2026-04-28 16:13:57 +08:00
sky121113
d00444840f [REFACTOR] 重構廣告管理模組 UI 並優化多語系支援 
1. 重構廣告管理模組 (Ads Management) UI，完全對齊「極簡奢華風 (Minimal Luxury)」設計規範。
2. 新增 x-luxury-datetime-input 標準化組件，統一全站日期時間選擇器介面，並解決手機版顯示問題。
3. 修復 ad-modal.blade.php 內多語系標籤斷行與空格導致的翻譯失效問題，確保中文正確顯示。
4. 優化廣告列表與卡片視圖，移除冗餘時間資訊，強化資訊層級與行動裝置適應性。
5. 更新相關頁面導覽按鈕邏輯，確保在分頁切換時按鈕渲染與佈局穩定。
 2026-04-28 13:26:15 +08:00
sky121113
9686f37fbd [STYLE] 優化商品管理與客戶管理頁面之間距與按鈕樣式 
1. 調整商品管理與客戶管理主容器間距為 space-y-2，縮小標題與頁籤之空隙。
2. 統一頁籤 (Tabs) 與內容區域之頂部間距為 mt-6，標準化視覺節奏。
3. 修正商品與分類管理頁面之「新增」按鈕顏色不一致問題，統一使用奢華藍漸層。
4. 在各管理頁面主要按鈕加入 whitespace-nowrap，確保文字在窄屏下不換行。
5. 優化商品管理 RWD 佈局，使手機與平板裝置下之篩選列與標題區域對齊基準模組。
 2026-04-28 09:44:01 +08:00
sky121113
10bbfef2a4 [STYLE] 移除導覽列中無功能的搜尋圖示 
1. 移除 resources/views/layouts/admin.blade.php 中 mobile 版與 desktop 版的搜尋圖示預留區塊。
2. 優化頂部導覽列視覺，減少冗餘的 UI 元件。
 2026-04-28 08:38:47 +08:00
sky121113
c1fdf6bc9f [STYLE] 優化機台庫存概覽介面與多語系支援 
1. 移動「一鍵補貨」按鈕至總庫存量進度卡片下方，提升操作便利性。
2. 實作機台詳情頁面貨道列表的響應式卡片設計 (Mobile Card View)。
3. 新增貨道卡片動態底色與進度條顏色，根據庫存狀態 (充足、偏低、缺貨、過期) 顯示對應色調。
4. 修正 Stock Level > 50% 多語系翻譯失效問題，並同步更新中英日語系檔。
5. 統一貨道列表卡片樣式，與主機台清單達成視覺一致性 (極簡奢華風)。
 2026-04-27 17:35:37 +08:00
sky121113
772c7a62e8 [STYLE] 庫存管理響應式 UI 優化與卡片顯示格式修正 
1. 優化「目前庫存」分頁：修復平板模式下卡片展開導致的高度拉伸問題，並確保 Alpine.js 變數 (localCardOpen) 作用域隔離。
2. 優化「異動紀錄」分頁：將時間戳記從獨立行移入 2x2 內容網格，補上「時間」標題並修正字體顏色。
3. 優化「進貨單管理」分頁：卡片日期顯示格式修正為完整時分秒 (Y-m-d H:i:s)。
4. 統一搜尋佈局：將庫存管理各分頁與機台補貨單的「搜尋」與「重置」按鈕群組化，確保在窄螢幕換行時能保持連動。
5. 修正進貨單詳情：優化側邊欄 (Slide-over) 的資料載入邏輯與多語系顯示。
 2026-04-27 15:40:57 +08:00
sky121113
9d7fdc9c7f [STYLE] 優化維修紀錄與倉儲管理模組 RWD 響應式佈局 
1. 維修紀錄 (Maintenance Records)：優化標題區域與按鈕在行動裝置上的顯示，新增「系統 (System)」維修類型支援。
2. 倉儲管理 (Warehouse Management)：全面優化總覽、庫存、調撥與補貨介面，確保在手機版自動切換為優化的卡片或折疊佈局。
3. 機台庫存 (Machine Inventory)：修正表格寬度與字體大小，提升小螢幕下的閱讀性。
4. 補貨流程 (Replenishment Workflow)：優化一鍵補貨 Modal 與詳情面板的 RWD 表現。
5. 全站佈局：調整 admin.blade.php 與主容器間距，修復部分區域在窄螢幕下的破圖問題。
 2026-04-27 14:24:37 +08:00
sky121113
de538a0162 [FIX] 優化側邊欄縮收介面與維修紀錄多租戶相容性 
1. 優化側邊欄 (Sidebar) 縮收邏輯：新增子選單與文字標籤在縮放時的過渡動畫與顯示控制。
2. 修正維修紀錄 (Maintenance Records) 結構：透過 Migration 將 company_id 設為 nullable，支援系統層級的維修日誌。
3. 新增補貨單狀態更新 Modal：實作智慧補貨流程中的狀態切換確認視窗。
4. 簡化登入紀錄 UI：移除複雜的 Timeline 線條與點狀裝飾，回歸極簡奢華風視覺核心。
 2026-04-27 14:16:53 +08:00
sky121113
8e854841d3 [FIX] 強制更新路由表以解決 Demo 站 RouteNotFound 錯誤 
1. 修改 web.php 觸發部署腳本重新整理路由快取。
2. 確認 admin.warehouses.machine-inventory 路由定義完整性。
 2026-04-24 17:41:10 +08:00
sky121113
9017869d0f [FIX] 修正 Migration 欄位重複導致的 CI/CD 錯誤 
1. 增加防禦性檢查：在新增欄位前先透過 Schema::hasColumn 確認欄位是否已存在。
2. 解決 welcome_gift_enabled 欄位重複定義導致的 SQL 錯誤。
 2026-04-24 17:37:31 +08:00
sky121113
e9dd1a28ef [STYLE] 將 scratch 腳本資料夾加入 .gitignore 2026-04-24 17:35:44 +08:00
sky121113
aa656feecf [STYLE] 統一全站管理介面圖示與 UI 規範 
1. 機台列表：更換管理與日誌圖示為標準鉛筆與眼睛圖示，移除多餘按鈕。
2. 儀表板：優化機台庫存即時顯示邏輯。
3. 商品與廣告管理：優化分頁與表格操作列寬度，提升視覺一致性。
4. 權限管理：修正機台權限指派介面的 RWD 表現與多選組件樣式。
5. 帳號配置：優化表格操作區域與按鈕懸停狀態。
 2026-04-24 17:34:09 +08:00
sky121113
2012c5a321 [FEAT] 優化一鍵補貨 UI 與 RWD 響應式佈局 
1. 實作一鍵補貨智慧重新計算邏輯：切換倉庫或機台時自動更新預覽。
2. 新增多語系支援：補齊繁中、日文、英文語系檔中的庫存/上限、重新計算等關鍵字。
3. 優化 RWD 響應式佈局：在手機版自動切換為卡片式 (Card) 佈局，提升行動裝置操作體驗。
4. 新增刪除功能：預覽清單中每一行貨道皆可獨立移除，並配合唯一辨識碼 (slot_no) 修正 state 殘留 bug。
5. 完善一鍵補貨 Modal 腳底控制項：新增手動「重新計算」按鈕與樣式優化。
6. 完成補貨單管理功能：包含新增、取消、分配人員等後台邏輯與多租戶隔離。
7. 優化庫存轉移 (Transfers) 介面與詳情面板 RWD 表現。
 2026-04-24 17:32:11 +08:00
sky121113
b0e523067f [STYLE] 優化機台設定與倉庫管理介面規範化 
1. 機台管理模組優化：
   - 移除機台設定內部的「機台分布」標籤頁，改為標題旁獨立的極簡白色連結入口。
   - 優化機台列表欄位，將「公司名稱」獨立顯示。
   - 實作機台系統設定非同步更新功能 (update-system-settings)。
2. 倉庫管理模組規範化：
   - 統一庫存分頁的視覺色調，使用一致的青色 (Cyan) 強調色。
   - 優化日期篩選器，支援精確時間 (H:i) 選擇並預設 00:00。
   - 實作自定義 multi-select 組件以解決 Preline 下拉衝突。
   - 確保所有篩選操作觸發立即的 AJAX 資料同步與狀態更新。
3. 系統基礎優化：
   - 更新繁體中文、日文、英文語系檔，確保標籤顯示正確。
   - 清理 Controller 多餘的地圖資料擷取邏輯。
 2026-04-24 10:54:24 +08:00
sky121113
39a246d3c5 [FEAT] 倉儲管理模組標準化與庫存矩陣功能實作 
1. 實作「目前庫存」矩陣化視圖：將商品作為行、倉庫作為列，支援跨倉庫水位分析與自動加總。
2. 優化矩陣 UI：實作固定欄位 (Sticky Columns) 以應對多倉庫場景，並修正深色模式下的背景色對齊問題。
3. 強化倉儲操作驗證：實作調撥與補貨單的 Alpine.js 前端欄位驗證與 AJAX 提交邏輯，提升操作流暢度。
4. 優化機台地址定位：實作結構化地址解析與 Nominatim API 對接，提升經緯度自動獲取的準確性。
5. 標準化 UI 組件：更新 Breadcrumbs、刪除確認彈窗與搜尋下拉選單，確保全站視覺一致性。
6. 完善多語系支援：補全倉儲管理、機台設定與 UI 提示的繁體中文翻譯。
7. 增加 Product Model 的 stocks() 關聯，支援高效率的庫存矩陣查詢。
 2026-04-23 17:34:22 +08:00
sky121113
2f86bb90a2 [FEAT] 標準化廣告管理 AJAX 與公司系統設定功能修復 
1. 修復公司系統設定 Alpine.js 響應式屬性未初始化問題，確保 9 項功能開關可正確儲存。
2. 統一公司列表「啟用功能」標籤顏色為標準青色 (Cyan)，提升視覺一致性。
3. 實作廣告管理模組 AJAX 分頁與搜尋功能，支援無刷新頁面更新。
4. 於廣告管理模組導入極簡奢華風 Loading 載入遮罩，與機台管理模組保持一致。
5. 更新多語系語系檔 (zh_TW, en, ja)，補齊功能開關與載入提示文字。
6. 優化分頁元件 (luxury.blade.php)，修復 ajax:navigate 事件觸發邏輯。
 2026-04-23 12:35:52 +08:00
sky121113
315c226560 [FEAT] 倉儲管理系統模組實作與全站 UI/UX 標準化優化 
1. 實作倉儲管理系統 (Warehouse Management)：包含總覽、庫存、調撥、機台庫存與補貨模組。
2. 建立倉儲相關資料結構：新增 warehouses, warehouse_stocks, stock_in_orders, stock_movements, transfer_orders, replenishment_orders 等資料表。
3. 優化商品管理 (Product Management) 介面：調整商品與類別管理的分頁、搜尋與編輯邏輯，並導入極簡奢華風 UI。
4. 增強遠端機台管理 (Remote Machine Management)：優化機台清單、庫存監控與遠端出貨介面，提升載入效能。
5. 更新全站導覽選單 (Sidebar)：整合倉儲管理入口，並修復側邊欄語法錯誤。
6. 標準化分頁組件 (Pagination)：套用 luxury 奢華風分頁樣式。
7. 補齊多語系語系檔 (i18n)：更新 zh_TW.json，包含倉儲與商品模組相關詞彙。
 2026-04-23 11:51:08 +08:00
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
12591a55f2 cleanup: remove redundant ProcessErrorLog job in favor of existing ProcessMachineError 2026-04-22 16:38:37 +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
fb06497ef3 fix: resolve Blade syntax error in sidebar-menu by removing nested comments 2026-04-22 16:34:18 +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
9114269a7a [FEAT] 完善遠端出貨與庫存異動的併發控制與視覺回饋 
1. 修正 RemoteController 中的 MachineService 注入問題，解決遠端出貨指令失效的 500 錯誤。
2. 在 MachineService 實作貨道鎖定機制 (lockSlot/unlockSlot)，防止重複扣庫存導致的數據不一致。
3. 採用樂觀扣除模式，發送指令時即更新預扣庫存，並在 ProcessCommandAck 實作失敗自動 Rollback。
4. 優化 UI 互動：在操作紀錄詳情顯示庫存變化 (如 6 -> 5)，且針對執行失敗的指令加上刪除線樣式。
5. 完成指令詳情、操作紀錄與庫存歷史的語系對照表同步 (zh_TW, en, ja)。
 2026-04-22 15:02:00 +08:00
sky121113
a8b150cadc [FIX] 移除 CI/CD 中不存在的 emqx_ctl 指令 2026-04-22 13:37:59 +08:00
sky121113
4b8436e6c2 [REFACTOR] 移除 MQTT $SYS 監聽機制並優化 CI/CD 流程 
1. 移除 MQTT Gateway 對 $SYS 系統主題的訂閱與解析邏輯，改由遺囑 (Last Will) 統一處理上下線狀態。
2. 更新 EMQX ACL 設定，移除 Gateway 的系統主題存取權限。
3. 優化 CI/CD 流程 (deploy-demo.yaml)：將 EMQX 重啟改為熱重載 (Reload)，並新增 MQTT Worker 自動重啟。
 2026-04-22 13:33:42 +08:00
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
4027e9eaa2 [STYLE] 重構機台列表欄位並更新多語系支援 
1. 將機台列表中的狀態、溫度與硬體狀態拆分為三個獨立欄位
2. 優化 index.blade.php 的表格結構與間距
3. 於 zh_TW.json、en.json 與 ja.json 新增 Sub / Card / Scan 翻譯鍵值
 2026-04-21 17:09:39 +08:00
sky121113
6603828ddc [FIX] 用中間檔案取代 tar pipe，徹底避開 pipefail 
改為先 tar -cf /tmp/deploy.tar，再 docker exec tar -xf < 檔案。
不使用 pipe = 不受 pipefail 影響。
|| [ $? -le 1 ] 讓 tar exit 1 (warning) 通過，exit 2+ 才失敗。
 2026-04-21 17:02:07 +08:00
sky121113
99463a762e [REFACTOR] 簡化 CI/CD 部署腳本 - 從根本解決 tar 問題 
問題根源：
- tar 的 'file changed as we read it' 是警告 (exit 1)，非錯誤
- 之前用 PIPESTATUS、pipefail toggle、wait_for_container 等 workaround
  處理，導致腳本越來越複雜且脆弱

根本解法：
1. tar --warning=no-file-changed: 讓 tar 忽略此警告並維持 exit 0
2. 三個容器共享同一份 volume，只需同步一次到主容器
3. 移除所有 workaround 程式碼 (PIPESTATUS/pipefail/wait_for_container)

Step 2 從 ~50 行縮減至 ~15 行。
 2026-04-21 16:59:27 +08:00
sky121113
a15eeabde7 [FIX] 修復 pipefail 導致 tar 警告中斷部署腳本 
Gitea Actions 的 bash shell 預設啟用 set -eo pipefail。
tar 的 exit 1 (file changed as we read it) 是警告非錯誤，
但 pipefail 會讓它變成管線失敗，set -e 立即中斷腳本。

修復：在 tar 管線前暫時 set +o pipefail，
手動檢查 PIPESTATUS 後再恢復 set -o pipefail。
 2026-04-21 16:57:03 +08:00
sky121113
d3cb9b4fee [FIX] 根因修復 - 共享 Volume 下不需對每個容器重複同步 
根因：三個容器 (laravel, queue, mqtt-worker) 共享同一份
volume mount (.:/var/www/html)。對 laravel 容器做 tar 同步時，
queue/mqtt-worker 會同時看到檔案變動，導致它們 crash → restart。
接著對 queue 容器做冗餘同步時就會撞上 restarting 狀態。

修復：
1. 只對主容器 (star-cloud-laravel) 同步一次即可
2. 同步完成後等待 worker 容器從短暫重啟中恢復
3. 移除對 queue/mqtt-worker 的冗餘 tar 同步
 2026-04-21 16:54:45 +08:00
sky121113
88741dc5ae [FIX] 修復 CI/CD 部署時序競爭 - 容器重啟導致 docker exec 隨機失敗 
根因：queue/mqtt-worker 容器可能處於 restarting 狀態，
docker exec 在此狀態下會被拒絕 (exit 1)，導致部署隨機失敗。

修復：在 deploy_to 函式中加入 wait_for_container 重試邏輯，
在執行 docker exec 前先等待容器進入 running 狀態 (最多 30 秒)。
 2026-04-21 16:52:45 +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
240667d74f [FIX] 修正 CI/CD Bash PIPESTATUS 重置問題 
1. 將 tar_status 與 docker_status 的賦值合併到同一行，解決 local 指令會重置 PIPESTATUS 導致變數為空的問題。
2. 增加變數非空檢查，預防非預期的語法錯誤。
3. 加強錯誤輸出的 Debug 資訊。
 2026-04-21 16:39:08 +08:00
sky121113
6eb9de4812 [FIX] 強化 CI/CD Step 2 部署腳本與錯誤診斷 
1. 改進 deploy_to 函式，同時驗證 tar 與 docker exec 的結束碼，避免靜默失敗。
2. 增加同步過程的日誌輸出 (tar/docker status)，提升故障排查效率。
3. 確保任一容器同步失敗時立即中斷流程，防止不完整的部署。
 2026-04-21 16:37:50 +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
2bc467bb84 [FIX] 修復 CI/CD 部署時 tar 因檔案變動而報錯的問題 
1. 在 deploy-demo.yaml 的 tar 指令加入 --ignore-failed-read 預防非致命報錯。
2. 排除 storage 與 bootstrap/cache 目錄的上傳，避免與容器內運作中的檔案衝突。
 2026-04-21 15:52:09 +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