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

83 Commits

Author SHA1 Message Date
sky121113
17f565bded [REFACTOR] 機台系統設定 settings JSON 化與編輯介面多語系／UI 優化 
1. Machine 模型：新增 settings JSON 的 accessors/mutators（shopping_mode、tax_invoice_enabled、card_terminal_enabled、scan_pay_esun/linepay_enabled、shopping_cart_enabled 等），讀寫統一收斂到 settings 欄位並同步既有資料表欄位。
2. MachineSettingController：system_settings 儲存邏輯補上 pickup_module_enabled（納入 allowedFields，非基礎版模式時強制關閉）。
3. 多語系補完：新增 Edit Machine System Settings、Basic Mode Features、Bill、Coin、Search machine name or code... 等 key（en/ja/zh_TW），並把寫死的「鈔／幣」面額前綴與中文搜尋框 placeholder 改為 __() 翻譯。
4. 編輯 modal UI：各支付區塊「全選／取消全選」移至標題旁；取貨模組新增區塊總開關與全選；購物車／來店禮改為卡片版型、開關靠右移除重複標籤。
5. 基礎版專屬功能以容器外框＋標籤分組，與會員系統／稅務系統／硬體周邊（永遠顯示）做出視覺區隔；「支付方式」全選一併納入取貨模組。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-09 17:34:11 +08:00
sky121113
8f2dd1375e [FEAT] 實作機台報表分析功能與商品報表篩選列優化 
1. 實作 AnalysisController@machineReports 後端邏輯，支援租戶隔離與帳號機台授權過濾。
2. 建立 machine-reports.blade.php 視圖，加入極簡奢華風統計卡片、ApexCharts 趨勢圖與自訂多選支付工具篩選器，並停用圖表縮放優化滾輪滾動體驗。
3. 優化 product-reports.blade.php，新增機台下拉選單過濾，並啟用寬度優化與響應式自動換行，且同步停用圖表縮放。
4. 在 Machine model 全域 Scope 中排除單元測試阻擋，並更新 RoleSeeder 播種機台報表權限。
5. 新增 AnalysisReportsTest 測試，並更新 AnalysisPermissionTest 權限測試，且在 Sail 中驗證為 100% 通過。
6. 同步更新繁中、英文、日文翻譯 JSON 檔案，以 zh_TW 為基準完美對齊、字母排序且還原斜線。
 2026-06-05 16:21:05 +08:00
sky121113
953581db38 [FEAT] 新增環境溫度上限監測與遠端風扇指令控制功能 
1. 資料庫移轉：新增機台環境溫度、環境溫度上限設定，以及是否啟用環境溫度監測等欄位。
2. 後端核心：更新 Machine Model 與 MachineController，實作機台環境溫度設定的更新與歷史日誌 Ajax API。
3. MQTT 佇列：於 ListenMqttQueue 指令與 ProcessAmbientTemp Job 實作機台上報環境溫度的接收與寫入，並加入 Redis 快取防止重複日誌洗版。
4. 遠端指令：擴充 RemoteController 並於指令中心實作 'fanon'、'fanoff'、'fanauto' 與 'ambient_temp_limit' (環境溫度上限) 指令下發。
5. 前端頁面：於機台列表加入「環境溫度上限」微調計數器 UI，並整合 ApexCharts 折線圖展示溫度趨勢；更新遠端控制中心按鈕與歷史篩選器。
6. 多語系：同步更新並完美對齊 'zh_TW.json'、'en.json' 與 'ja.json'，遵循字母 ksort 排序與斜線不逸出規範。
 2026-06-04 11:45:48 +08:00
sky121113
c5238ccfbc [FEAT] 實作機台貨道類型與商品容量上限的雙向連動同步機制 
1. 於 app/Models/Product/Product.php 實作更新事件監聽器，當商品的履帶/彈簧上限變更時，自動更新所有關聯貨道之最大容量與類型。
2. 於 app/Models/Machine/Machine.php 實作更新事件監聽器，當機台的彈簧貨道區間設定變更時，自動更新該機台所有貨道之最大容量與類型。
3. 於 app/Services/Machine/MachineService.php 重構貨道同步 (syncSlots) 與類型容量判定邏輯，加入雙向連動同步、貨道類型判斷等輔助方法，並優化庫存異動紀錄 (StockMovement) 的觸發機制，避免無謂的調整日誌。
4. 移除專案根目錄下的 4 月工作報告暫存檔 (Star_Cloud_April_Report.pdf, Star_Cloud_April_Report.pptx)。
 2026-06-03 15:33:49 +08:00
sky121113
5dd3b0a005 [FEAT] 新增多租戶自訂登入、視覺設定與 APK 版本上傳時間 
1. 實作多租戶專屬自訂登入頁面：支援 `/c/{company_code}/login` 特殊入口，自動載入租戶專屬 Logo 網址、名稱與歡迎詞。
2. 支援客製化品牌視覺設定：於客戶管理清單中，提供 SaaS 管理者可自訂租戶 Logo 圖片與歡迎副標題，且系統後台 Header/Sidebar 與登入頁能動態依該配置載入租戶專屬商標。
3. 擴充多語系字典並完成三檔對齊：新增 "Upload Time" 欄位與翻譯，執行 `ksort` 以維持 zh_TW、en 與 ja 語系檔對齊。
4. APK 版本清單增加上傳時間欄位：於 APK 版本表格中呈現上傳時間（created_at），使用 font-mono 奢華風小尺寸樣式呈現。
 2026-06-01 17:07:20 +08:00
sky121113
e01e8077f9 [FEAT] 新增訂單收件人姓名遮罩與商品詞彙通用化調整 
1. 於 Order Model 新增收件人姓名遮罩邏輯 (masked_pickup_recipient)，將 member_barcode 進行去識別化處理以保護隱私，並保留括號/換行等後綴資訊。
2. 新增 OrderPickupRecipientMaskTest 單元測試，驗證中文字元及包含換行/括號的後綴遮罩正確性。
3. 更新後台銷售管理介面 (order-detail-panel.blade.php、tab-orders.blade.php)，將原先顯示明文的 member_barcode 改用遮罩後的屬性展示。
4. 將機器通訊協定與狀態代碼中的「便當 (Bento)」字詞統一調整為「商品 (Product)」，以符合各機型通用語意。
5. 更新相關語系翻譯檔案 (zh_TW.json, en.json, ja.json) 及 MQTT 通訊規範文件中的詞彙對應。
6. 修改 MachineLog 中的翻譯取得邏輯，確保能透過錯誤代碼表對應到最新的商品語意。
 2026-05-29 14:37:28 +08:00
sky121113
8d380e4902 [FEAT] 增加訂單出貨交付狀態(delivery_status)與多語系支援 
1. 新增資料庫遷移：在  資料表增加 （出貨狀態：0 失敗、1 成功、2 部分成功），預設值為 1 並允許 NULL 以完美向下相容舊機台。
2. 升級  Model：加入  到可填充與轉型，並宣告常量與  取得本地化文字的 Accessor。
3. 更新  邏輯：在  中自動解析並記錄 。新增  輔助函式，當 Payload 未指定訂單狀態時，可動態從個別貨道出貨紀錄 ( 陣列) 計算出整筆訂單的出貨交付結果。
4. 銷售紀錄列表 (tab-orders.blade.php) UI 優化：將原先「狀態」欄位重命名為「付款狀態」，並在右側新增「出貨狀態」欄位，使用極簡奢華風的彩色 Badge 呈現出貨結果；桌機版空狀態  修正為 8 防止破版；手機版卡片同步支援。
5. 側邊明細面板 (order-detail-panel.blade.php) UI 優化：將基本狀態卡片升級為 3 欄網格，將付款狀態、支付類型與新增的出貨狀態 Badge 完美並排。
6. 報表匯出功能 (SalesController.php) 整合：在 Excel 及 CSV 匯出中同步修正「付款狀態」欄位標題與轉換標籤，並新增「出貨狀態」欄位以匯出 。
7. 多語系精準對齊：新增 , , ,  及  的繁、英、日翻譯對照，並進行字母升冪排序 (ksort)。
 2026-05-29 12:17:36 +08:00
sky121113
fb1bcf49e1 [FEAT] 新增 OTA 預約排程與部署狀態展示，並優化版本排序與 UI 
1. 建立 `ota_schedules` 資料表與 `OtaSchedule` Model，提供 OTA 預約排程基礎儲存結構。
2. 建立 `ota:process-schedules` 背景 Artisan Command 並註冊至 Console Kernel，每分鐘自動執行到期的預約並透過 MQTT 發送。
3. 擴充 `ApkVersionController` index 方法：加入加載列表時自動觸發排程的防呆機制，並在記憶體中快速統計 pending 與 completed 的機台。
4. 擴充 `ApkVersionController` store 與 push 方法，移除已用不到的 `is_forced` (更新模式) 限制，並支援 `scheduled_at` 預約時間的寫入。
5. 調整 `create.blade.php` 頁面，移除「強制更新」的 Switch 欄位，僅保留注意事項防錯提示。
6. 調整 `index.blade.php` 頁面，將「更新模式」改為「部署狀態」一欄，整合系統內建的 `.tooltip` 與原生 `title` 屬性，在加載與刷新時 100% 穩定展示 Hover 機台名單。
7. 優化 `index.blade.php` 彈窗，將原生時間輸入框改為 Flatpickr 樣式，加入日曆圖標並支援動態 locale 語言切換（中/英/日），將標籤統一命名為「選擇更新時間」。
8. 同步更新並對齊中、英、日三語系 `lang/*.json` 語系檔，並完成字母排序與反逸出斜線處理。
 2026-05-29 10:55:23 +08:00
sky121113
5c66a01261 chore: sync pending model/docs/i18n updates 2026-05-28 15:55:38 +08:00
sky121113
acde99e383 [FIX] 修正下位機 Discord 告警發送條件與層級對等 
1. 調整 MachineLog 的 created 監聽器，使 submachine 類型日誌僅在 level 為 warning 或 error 時才派發 Discord 通知任務，避免 info 狀態日誌（如出貨中、平台上升中）洗板告警。
2. 優化 DiscordWebhookService 的下位機異常渲染，根據日誌嚴重程度 (level) 動態調整標題前面的 Emoji 圖示，error 級別顯示 🚨，warning 級別顯示 ⚠️。
 2026-05-28 14:53:06 +08:00
sky121113
7dee52a00a [FEAT] 新增 OTA APK 版本管理與更新部署功能 
1. 新增 `ApkVersion` Model 與對應的資料表遷移檔 (`create_apk_versions_table`)，用以記錄 APK 版本、代碼、風味、更新說明、下載連結與更新模式等欄位。
2. 實作 `ApkVersionController` 控制器，提供 APK 版本之 CRUD（列表、建立、刪除）以及 OTA 推送功能。
3. 移除了 `SpecialPermissionController` 中舊有的 `apkVersions` 占位路由方法，並於 `routes/web.php` 的基本設定 (`basic-settings`) 下新增完整的 APK 版本管理與推送路由。
4. 於 `RoleSeeder.php` 角色種子資料中為 Super Admin 與系統管理員新增 `menu.basic.apk-versions` 權限。
5. 於 `sidebar-menu.blade.php` 基本設定選單中，加入「APK版本管理」之子選單選項，並以對應權限進行防護。
6. 實作 APK 版本列表與上傳頁面 Blade 視圖，採用 Preline UI 與 Alpine.js 提供極簡奢華風的 UI 互動，包含檔案上傳拖曳與 OTA 設備選擇部署彈窗。
7. 更新繁體中文語系檔 `zh_TW.json`，對齊所有新增之 OTA 韌體與版本管理翻譯字詞。
 2026-05-22 16:51:21 +08:00
sky121113
f59efc6dc7 [FIX] 補齊與優化來店禮、通行碼、取貨碼之多語系與介面欄位呈現 
1. 移除非必要之 Log 備註：從來店禮使用記錄 (Logs) 的電腦版與行動版畫面中，徹底移除了無業務參考價值的技術備註 (Remark) 欄位，優化排版空間以符合極簡奢華風 UI 設計。
2. 補齊與對齊三語系檔案：補齊來店禮、通行碼與商品領取所缺少的多語系 Key，三個語系 JSON 檔 (zh_TW, en, ja) 的 Key 與行數已 100% 完美對齊 (共 2,255 行) 且完成升冪字母排序 (ksort)。
3. 簡化 Guest 票券大標題：簡化 Guest 端三種票券頁面 (通行碼、取貨碼、來店禮) 的大標題多語系拼接結構，改為單一乾淨的翻譯 Key 呼叫。
4. 口語化翻譯微調：將 Pickup Code 在語系檔中的中文翻譯由「領取碼」微調為更口語、直覺的「取貨碼」。
5. 優化 Guest 頁面欄位：將取貨碼頁面的「機台序號」替換為更具溫度的「機台名稱」；通行碼與來店禮頁面則徹底隱藏機台序號，優化用戶體驗。
 2026-05-22 14:46:26 +08:00
sky121113
95ed1494e2 Merge branch 'feat/discord-notification' into dev 
# Please enter a commit message to explain why this merge is necessary,
# especially if it merges an updated upstream into a topic branch.
#
# Lines starting with '#' will be ignored, and an empty message aborts
# the commit.
 2026-05-21 16:39:32 +08:00
sky121113
14ecfdcc8d feat(warehouse): 實作調撥與補貨單商品快照機制，並修復商品無圖片時的預設圖示 fallback 顯示 2026-05-21 16:25:48 +08:00
sky121113
b3d00a9bef feat: 重構 Discord 雙 Tab 告警設定與機台自適應溫控三層繼承鏈，並導入 Modal 內拉式複製 UX 2026-05-21 10:05:36 +08:00
sky121113
39ea74a52e [FIX] 修正商品軟刪除之出貨歷史關聯與圖片破圖優化 
1. 於 DispenseRecord、OrderItem 及 MachineStockMovement 模型之 product 關聯中加入 withTrashed()，確保被軟刪除商品的歷史快照仍可正常讀取。
2. 將 tab-dispense.blade.php、order-detail-panel.blade.php 及 SalesController 報表導出中的 product->name 統一修改為 product->localized_name ?? __('Unknown Product')，支援多語系切換與翻譯並替換 'Unknown' 為 '未知商品'。
3. 在銷售明細的商品圖片區塊整合 Alpine.js x-on:error 動態破圖防呆機制，一旦偵測到破圖或刪除實體圖，自動無縫退回精緻的 3D 箱子預設占位 SVG，消除破圖小圖標以維護全站極簡奢華風的視覺美感。
 2026-05-19 17:25:10 +08:00
sky121113
433714d9b0 [FEAT] 銷售紀錄新增員工卡交易資訊關聯、搜尋與介面展示 
1. 於 Order 模型中定義 staffCardLog 關係以關聯 StaffCardLog。
2. 於 SalesController 列表查詢（index）與單筆詳情（show）中進行極致效能優化，限定 Eager Loading 僅撈取必要欄位（id, employee_id, name, card_uid），避免 N+1 查詢與記憶體開銷。
3. 擴充 SalesController 的銷售紀錄搜尋過濾邏輯，新增支援員工姓名、工號與感應卡號的模糊搜尋。
4. 修改 tab-orders 桌面版表格與手機版卡片視圖，為員工卡支付的訂單加上精美的員工卡 icon 與「姓名 (工號)」徽章。
5. 修改 order-detail-panel 側滑詳情面板，新增「員工卡資訊」網格區塊，展示員工姓名、工號、卡片 UID 與備註欄位。
6. 更新 zh_TW.json 補齊「員工卡資訊」的繁體中文翻譯，確保全站語言一致。
 2026-05-19 10:54:18 +08:00
sky121113
17c7a26ef4 [FIX] 修復員工識別卡最後使用狀態更新、刪除頁面顯示 JSON 與語系遺漏問題 
1. 在 StaffCardLog 模型中實作 booted() 事件監聽器，於刷卡日誌建立後自動更新關聯員工識別卡的「最後使用時間」與「最後使用機台」，並使用 withoutGlobalScopes 確保寫入安全。
2. 修正 StaffCardController 刪除方法（destroy），判斷 AJAX 請求以回傳 JSON，其餘一般表單刪除後則正常重導向回列表頁，解決刪除時跳轉至 JSON 純文字的問題。
3. 補齊多語系語系檔（zh_TW.json, en.json, ja.json）中有關「刪除員工識別卡」的翻譯對照，確保 UI 刪除警告在不同語言環境下均能完美呈現。
 2026-05-18 13:37:21 +08:00
sky121113
86e895a4ae [FEAT] 實作智慧型機台登入異常告警與自動自我修復機制 
1. [Models] 修改 Machine.php，增加 has_login_warning 動態屬性，設定未解決之登入失敗日誌須達 3 筆以上才亮起「登入異常」警報。
2. [Models] 重構 scopeHasAnyAlert 查詢，確保當未解決之登入失敗日誌未達 3 筆時，不會計入儀表板的「待處理告警 (Alerts Pending)」統計。
3. [API] 修改 MachineAuthController.php，在 B000 登入成功時加入自動自我修復 (Self-healing) 邏輯，一鍵將先前該機台的所有未解決登入失敗日誌標記為已解決 (is_resolved = true)。
4. [Views] 修改 admin.dashboard 及 admin.machines.index，新增登入異常警告 (Login Alert) 的琥珀色徽章與動態提示，並將儀表板上的機台卡片標題改為點擊可跳轉至對應機台之篩選列表。
5. [Lang] 更新 zh_TW.json、en.json 與 ja.json，新增多語系翻譯對照詞彙。
 2026-05-18 09:50:51 +08:00
sky121113
3d1ddd5b91 [FEAT] 實作機台智慧連線監控與儀表板告警同步優化 
1. [Machine Model] 實作智慧抖動偵測邏輯 (Jitter Detection)，判定 1 小時內斷線 3 次以上為不穩定機台。
2. [Machine Model] 優化 calculated_status，機台在線時自動忽略歷史斷線警告，並修正 scopeHasAnyAlert 排除連線類告警。
3. [ProcessStatus Job] 實作自動消警機制 (Auto-resolve)，機台恢復連線時自動處理舊的斷線告警。
4. [Dashboard] 同步儀表板「待處理告警」統計，確保與機台列表狀態一致。
5. [UI] 於機台列表與儀表板同步新增琥珀色閃電圖示 (⚡) 與不穩定提示 Tooltip。
6. [i18n] 新增連線不穩定相關之繁體中文翻譯詞條。
 2026-05-14 16:20:59 +08:00
sky121113
87c4c281a1 [FEAT] 新增廣告狀態切換功能與優化商品操作紀錄介面 
1. 新增廣告管理狀態切換 (Toggle Status) 功能，包含後端 API、路由與前端 UI 實作。
2. 優化商品操作紀錄 (Audit Logs) 的過濾介面，統一使用 x-searchable-select 並修正搜尋圖示樣式。
3. 擴充 SystemOperationLog 模型，支援自動解析操作目標名稱 (含 code 欄位備援)。
4. 優化商品操作紀錄查詢效能，預載入 (Eager Load) target 關聯資料。
5. 更新多語系檔案 (zh_TW, en, ja)，新增廣告狀態切換相關文字。
 2026-05-14 13:02:08 +08:00
sky121113
256d996918 [STYLE] 商品管理介面多語系標準化與側邊欄 UI 優化 
1. 完成商品詳細資訊側邊欄 (Slide-over) 的全面多語系化，修復部分標題顯示英文的問題。
2. 重構 Alpine.js 的 getCategoryName 函式，優先顯示 localized_name。
3. 更新 zh_TW.json 補齊缺失的翻譯鍵值 (包含同步指令提示、側邊欄區塊標題等)。
4. 優化分頁與分頁大小切換邏輯，支援新增的日誌 (Logs) 分頁。
5. 調整同步指令錯誤訊息為通用語氣，提升不同角色下的使用者體驗。
 2026-05-14 11:25:43 +08:00
sky121113
2c8a2de81c [FEAT] 實作商品主檔 B012 Redis 快取機制 (Phase 1) 
1. 新增 ProductCatalogService 負責商品清單轉換與 Redis 快取邏輯。
2. 新增 WarmProductsCacheCommand (artisan products:warm-cache) 用於預熱快取。
3. 修改 ProductController 在商品異動時自動重建快取。
4. 修改 MachineController@getProducts (B012) 改為 Cache-First 讀取。
5. 在 Company 模型補上 products 關聯以支援暖機指令。
 2026-05-13 18:51:35 +08:00
sky121113
426253b1c3 [FEAT] 強化遠端指令中心的操作備註功能 
1. 新增 remote_commands 資料表的 remark 欄位以儲存操作備註。
2. 更新 RemoteCommand 模型，將 note 與 remark 加入可批量賦值名單。
3. 更新 MachineService 的 dispatchDispense 函式，支援接收與記錄操作備註。
4. 更新 RemoteController 的 storeCommand 邏輯，將前端輸入的備註存入 remark 並支援遠端出貨指令。
5. 優化操作紀錄搜尋邏輯，支援搜尋備註欄位。
6. 重構指令中心操作紀錄介面，桌面版新增「操作備註」欄位，並優化手機版卡片顯示。
7. 調整表格欄位寬度與標頭樣式，解決「指令類型」寬度過大的問題。
 2026-05-12 17:15:53 +08:00
sky121113
34f1e823f0 [FIX] 修正庫存異動類型缺失與統一交易扣庫邏輯 
1. 補全 machine_stock_movements 資料表 type 欄位缺失的 sale 與 decommission 列舉值，修復 SQL 寫入失敗問題。
2. 重構 TransactionService：移除過時的 remote_dispense 判斷，將所有經由交易流程（含支付代碼 100）的出貨統一記錄為 sale 異動。
3. 更新 MachineService：將 B009 貨道同步時的移除動作類型由 adjustment 改為正確的 decommission。
4. 語系更新：於 zh_TW.json 與 en.json 補全硬體狀態碼 0205 (貨道有物) 的翻譯。
 2026-05-11 17:13:41 +08:00
sky121113
284d56a544 [REFACTOR] 支付方式多語系化與 UI 響應式優化 
1. [REFACTOR] Order 模型：將支付類型標籤改為多語系轉譯，支援繁中、英、日。
2. [FEAT] 補全 lang/*.json 中的支付類型翻譯。
3. [STYLE] layouts/admin.blade.php：優化電腦版與手機版邊距佈局。
4. [STYLE] 銷售紀錄分頁：優化手機版 info grid 響應式顯示。
5. [FIX] 銷售紀錄：恢復手機版完整日期時間格式。
6. [DELETE] 移除 B710 (Timer Sync) 冗餘代碼與路由。
7. [DOCS] 更新 API 文件配置。
 2026-05-11 11:01:48 +08:00
sky121113
6decba6cb6 [FIX] 優化 B009 同步機制、庫存排序與修正管理後台 UI 遮擋問題 
1. 實作 B009 貨道全量同步與拆除 (decommission) 紀錄機制。
2. 優化機台庫存概覽排序邏輯，優先顯示低填充率 (需補貨) 之機台。
3. 修正新增機台 Modal 的 z-index 層級與 overflow 限制，解決下拉選單被蓋住的問題。
4. 修復機台庫存分頁中的 JS 語法錯誤並新增貨道拆除狀態標籤。
 2026-05-07 15:08:01 +08:00
sky121113
eb55a25ca8 [FEAT] B009 改為全量同步模式，硬刪除不在清單的貨道 
1. 修改 MachineService@syncSlots 實作 B009 全量同步邏輯：同步完成後，找出資料庫中不在 B009 回報清單的舊貨道，先記流水帳再硬刪除，確保後台狀態與機台實體完全一致。
2. 新增 MachineStockMovement::TYPE_DECOMMISSION 常數，用於標識因 B009 全量同步而移除的貨道異動紀錄。
3. 新增多語系翻譯 key（zh_TW / en / ja）：movement.note.slot_decommissioned_by_b009、movement.note.initial_sync_report、movement.note.product_changed_and_adjusted 與 movement.type.decommission。
 2026-05-07 14:28:07 +08:00
sky121113
c52cf2900f [FIX] 統一搜尋欄位命名、更新語系檔與 IoT 規範文件 
1. 修改 ProductController.php，將搜尋參數統一改為 search 以匹配前端表單欄位。
2. 更新 lang/zh_TW.json 語系檔，修正部分翻譯詞彙 (如 Inactive, Standby, Confirm Status Change)。
3. 更新 .agents/skills/mqtt-communication-specs/SKILL.md 規範文件。
4. 包含 Machine Model 與 MachineService 的優化變更。
 2026-05-07 11:54:47 +08:00
sky121113
938aabc6c1 [FIX] 實作儀表板真實營收統計與多語系修正 
1. 修復儀表板營收統計，將模擬數據替換為從 Order 模型撈取的真實資料。
2. 修正 DashboardController 中的支付狀態篩選邏輯，從字串 'paid' 改為正確的 tinyInteger 狀態碼 1。
3. 在 Order 模型中新增 PAYMENT_STATUS_SUCCESS 與 PAYMENT_STATUS_FAILED 常數。
4. 新增「本月累計營收」的多語系翻譯（中、英、日）。
5. 優化儀表板前端介面，包含動態顯示昨日增長趨勢百分比與顏色標籤。
6. 修正儀表板機台列表中的「今日銷售額」統計邏輯。
 2026-05-06 17:55:18 +08:00
sky121113
fa6406b9ad [FEAT] 優化取貨碼管理介面與功能 
1. 新增取貨碼使用次數上限功能（限制 1-20 次）。
2. 優化取貨碼管理介面，採用極簡奢華風計數器並調整寬度與間距。
3. 整合 Flatpickr 24小時制日期時間選擇器，並實作模式切換時的時間自動帶入邏輯。
4. 取貨碼清單新增「剩餘使用次數 / 總次數」顯示。
5. 完善相關中文化翻譯（如「小時」、「自定義日期」等）。
6. 新增資料庫欄位 migration 並更新相關模型與 Service 邏輯。
7. 更新 API 技術規格文檔以符合最新取貨碼邏輯。
 2026-05-06 16:33:15 +08:00
sky121113
d740fc5ab8 [FEAT] 實作機台物理刪除功能與資料庫結構優化 
1. 於機台設定頁面新增刪除功能，並限制僅系統管理員 (Super Admin) 可操作。
2. 移除機台模型 (Machine) 的 SoftDeletes Trait，將刪除邏輯改為物理刪除。
3. 建立並執行 Migration 移除 machines 資料表的 deleted_at 欄位。
4. 清除資料庫中原有的 51 筆機台軟刪除紀錄。
5. 更新繁中、英文、日文語系檔，加入機台刪除成功與確認視窗之翻譯。
6. 更新 B000 管理員登入 API 之回應格式，統一包含 success 與 code 欄位。
7. 同步更新 API 技術規格文件 (SKILL.md) 與 api-docs.php 配置。
8. 微調商品新增/編輯頁面之 UI 元件 z-index 層級。
 2026-05-06 15:47:58 +08:00
sky121113
ad80fa8121 [FEAT] 整合員工識別紀錄與訂單關聯並優化 UI 顯示 
1. [FEAT] 在 StaffCardLog 模型中新增 order 關聯，並在 StaffCardController 預載此關聯。
2. [STYLE] 優化員工識別使用紀錄的 UI 佈局，採用更具質感的顯示方式並使用 status-badge 組件。
3. [STYLE] 擴充 status-badge 組件，支援 verified 與 completed 狀態標籤。
4. [DOCS] 更新 zh_TW.json 語系檔，新增 Staff、Verified、Verified Only 等翻譯。
 2026-05-06 13:10:25 +08:00
sky121113
fc93a0fb8c [FEAT] 實作封閉迴圈交易審核與 API 規格標準化 
1. 新增 B680 員工卡驗證 API 並更新相關技術文件 (SKILL.md, api-docs.php)。
2. 重構取貨碼與通行碼之日誌追蹤系統，新增 PickupCodeLog 與 PassCodeLog 模型及資料表遷移。
3. 修正 B660 API 路由方法，統一使用 POST 進行驗證。
4. 優化後台銷售中心介面，將「紀錄」頁籤統一為「使用紀錄」並優化狀態顯示組件。
5. 更新多語系 zh_TW.json 以符合新的 UI 命名規範。
6. 調整 Order 模型與 TransactionService 以支援更精確的封閉迴圈交易審核。
 2026-05-05 17:50:26 +08:00
sky121113
15b975efac [FEAT] 新增員工卡管理模組與 B012 API 文檔完善 
1. 新增員工卡 (staff_cards) 與員工卡感應日誌 (staff_card_logs) 模型與遷移檔。
2. 實作 StaffCardController 與相關管理介面，支援狀態切換與 CRUD。
3. 擴充 routes/web.php 加入員工卡管理路由。
4. 更新 api-docs.php 文檔，補全 B012 (Unified Sync) 的商品同步回應範例。
5. 實作 PaymentTypeSeeder 並整合至 DatabaseSeeder 以標準化支付類型。
6. 優化銷售中心訂單標籤與倉庫機台庫存顯示邏輯。
7. 側邊欄選單加入員工卡管理入口。
8. 重構 TransactionService 以支援員工卡工作階段 (session_token) 驗證。
 2026-05-05 14:06:43 +08:00
sky121113
023f639fb4 [STYLE] 銷售中心 UI 優化與出貨紀錄邏輯校正 
1. 優化「出貨紀錄」介面，重新排列欄位優先級並移除冗餘的機台流水號。
2. 統一出貨紀錄中的商品與貨道樣式，與取貨碼模組視覺語言同步。
3. 修正出貨紀錄搜尋邏輯，支援商品名稱與貨道編號模糊搜尋。
4. 修正「訂單詳情」側滑面板中的金額顯示（修正 price/subtotal 映射）。
5. 補強訂單詳情的出貨狀態 (dispense_status) 標籤顯示邏輯。
6. 將出貨紀錄中的「數量」表頭修正為「金額」，確保與 MQTT 協議回傳資料語意一致。
7. 更新多語系檔，新增搜尋欄位 placeholder 與相關 UI 標籤翻譯。
8. 新增發票資料表 machine_time 欄位遷移檔，以完整記錄機台開立時間。
 2026-05-04 17:20:43 +08:00
sky121113
e779880f9b [FEAT] 整合 MQTT 交易完成 (Finalize) 流程並更新 API 技術規格文件 
1. 整合交易流程：將 B600 (交易紀錄)、B601 (發票紀錄) 與 B602 (出貨紀錄) 整合為單一原子化的 MQTT 'finalize' 操作，確保資料一致性。
2. 實作非同步 Job：新增 ProcessTransactionFinalized Job 負責解析複合式 Payload 並寫入訂單、發票與出貨日誌。
3. 重構交易服務：更新 TransactionService 以支援同時處理訂單與發票資料，並修正產品 ID 驗證邏輯以避免外鍵衝突。
4. 更新技術文件：同步更新 api-docs.php 與 .agents/skills 中的 MQTT 規格，定義詳細的 finalize payload 結構與範例。
5. 優化文件 UI：改善 api-docs.blade.php 的描述渲染，支援換行符號以提升閱讀體驗。
6. 更新監聽指令：在 ListenMqttQueue 中加入 finalize 動作的處理分支並對接至新實作的 Job。
 2026-05-04 10:18:30 +08:00
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
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
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
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
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
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
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