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

250 Commits

Author SHA1 Message Date
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
857198bbba [FEAT] 新增遠端庫存列表視圖與機台管理租戶公司過濾功能 
1. 在遠端管理「庫存與效期」頁面實作列表視圖 (Table View) 與手機版卡片視圖 (Mobile Card View)，並支援點擊 Slot 行/卡片彈出編輯 Modal 進行庫存與效期修改。
2. 調整遠端庫存 Table 的 border、hover 背景色、divide 分隔線顏色與 Expiry 日期格式，使其與庫存概覽列表視圖完美對齊。
3. 在機台管理 (Machine Management) 與報修管理 (Maintenance Management) 等頁面新增僅系統管理員可見的 Company Filter 租戶過濾下拉選單。
4. 更新 zh_TW.json、en.json、ja.json 翻譯檔案與相關說明文件。
 2026-06-05 14:20:35 +08:00
sky121113
e414396b0c [FEAT] 於機台管理與機台設定頁面新增公司篩選功能 
1. 於機台管理 (MachineController 與 index.blade.php) 為系統管理員新增公司篩選下拉選單，並支援分頁參數與 AJAX 查詢。
2. 於機台設定頁面中的機台列表 (tab-machines.blade.php) 與系統設定列表 (tab-system-settings.blade.php) 新增公司篩選器。
3. 在 MachineSettingController 傳遞公司列表資料至視圖，以便支援公司篩選。
4. 修正重置按鈕，使其能正確清除 Preline HSSelect 的選取狀態並重新載入資料。
 2026-06-05 13:01:52 +08:00
sky121113
0964981097 [FEAT] 基本設定的機台管理新增鑰匙編號欄位與位置調整 
1. 於 `MachineSettingController.php` 的 `store` 驗證規則中新增 `key_no` 欄位。
2. 於 `index.blade.php` 的新增機台 Modal 及詳情 Drawer 中，加入「鑰匙編號」欄位與展示。
3. 於機台列表 `tab-machines.blade.php` (桌面表格與行動版卡片) 新增「鑰匙編號」顯示，並同步更新 Detail Drawer 參數。
4. 於 `edit.blade.php` 將「鑰匙編號」欄位移至「基本資訊」區塊並與「客戶公司」並排顯示。
5. 補齊並自動對齊繁中、英文、日文翻譯。
6. 撰寫 `MachineSettingTest.php` 測試案例，驗證基本設定中新增與更新機台鑰匙編號之邏輯。
 2026-06-05 11:50:00 +08:00
sky121113
11eca730f7 [FEAT] 實作自訂品牌樣式設定與專屬登入頁面預覽功能 
1. 實作自訂品牌樣式設定，支援上傳 Logo、登入大背景圖與左側卡片背景圖。
2. 整合 ImageHandler 處理上傳圖片，自動壓縮並轉為優質 webp 格式以提升載入速度。
3. 將品牌設定自 Modal 拆分，新增獨立的 branding.blade.php 設定頁面以優化操作體驗。
4. 於 TenantLoginController 新增登入頁預覽 (preview) 與專屬首頁重導向 (indexRedirect) 路由邏輯。
5. 調整 auth/login.blade.php 以支援動態呈現自訂背景圖、Logo、主副標題，且在預覽模式下阻擋登入並顯示頂部橫條。
6. 修正租戶登入安全性比對，加強 (int) 型態校驗並豐富 Log 警示資訊。
7. 更新並對齊 zh_TW.json、en.json 與 ja.json 三語系檔之品牌客製化相關辭彙。
8. 補充完整 Feature Test (CompanySettingsTest)，全面涵蓋物理刪除、上傳限制、預覽渲染、跳轉與登入安全性限制之測試。
 2026-06-05 08:44:38 +08:00
sky121113
7579a0b5be [FEAT] 調整環境溫度上報文檔順序與機台硬體事件日誌歸類 
1. 文件調整：將 config/api-docs.php 中的「機台環境溫度上報 (mqtt-ambient-temp-report)」MQTT API 區塊位置向上移至「機台硬體事件上報 (mqtt-event)」上方。
2. 日誌歸類：修改 ProcessMachineEvent.php，將機台硬體事件 (event) 日誌寫入資料庫時的 type 從 'status' (機台狀態) 改為 'ambient_temp' (環境溫度回傳)，以直接顯示於「環境溫度回傳」Tab。
 2026-06-04 12:00:54 +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
9de3044e46 [FIX] 修正商品管理分頁排序不唯一導致的重複商品問題 
1. 於 ProductController.php 的商品列表分頁中，將 latest() 改為明確的雙重排序 orderBy('created_at', 'desc')->orderBy('id', 'desc')。
2. 於商品分類列表分頁中，加入 orderBy('id', 'desc') 作為次要排序鍵，確保分頁的唯一性。
3. 於系統操作日誌分頁中，同步加入次要排序鍵優化分頁結果。
 2026-06-02 16:39:30 +08:00
sky121113
9e3eb8944b [FEAT] 新增溫控感測器離散事件接收處理機制與文件同步 
1. [FEAT] 新增 App/Jobs/Machine/ProcessMachineEvent.php 用以非同步處理 machine/{serial_no}/event 事件，將收到的風扇狀態（fanon/fanoff）記錄在機台狀態日誌中。
2. [FEAT] 修改 ListenMqttQueue.php 支援 event 類型的 MQTT 事件分派路由。
3. [FEAT] 更新 config/api-docs.php 規格文件，將原本在 status 主題的風扇說明移去，並新增獨立的 event (機台硬體事件上報) 主題文件。
4. [FIX] 更新多語系資源檔，新增 fanon 與 fanoff 扁平鍵對譯並進行 ksort 排序與去逸出美化。
 2026-06-02 14:19:48 +08:00
sky121113
fba0dc6bf9 [FIX] 補全下位機 Command(0x02) 狀態代碼與對齊三語系資源檔 
1. 修正 app/Services/Machine/MachineService.php 中的 02xx 系列錯誤對譯表，移除原本殘缺、衝突的舊佔位符，完整補足下位機 0x01 到 0x23 的 28 個狀態代碼與 label 定義。
2. 同步將新增的 28 個狀態標籤繁中翻譯更新至 lang/zh_TW.json。
3. 透過自動對齊與排序腳本，完美同步更新 lang/en.json 與 lang/ja.json，並將三語系檔案依英文字母順序 (ksort) 重新排序且執行反逸出斜線處理。
 2026-06-02 13:37:01 +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
6daeadc452 [FIX] 統計 APK 部署狀態時將尚未執行的預約排程機台也納入準備中統計 2026-05-29 11:08:34 +08:00
sky121113
ba609719cc [FIX] 統計 APK 部署狀態時將 sent (已送出) 納入準備中統計 2026-05-29 11:05:45 +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
d9bf2bbe98 [FEAT] 依廠商規格全面重構 B013 硬體狀態碼並補齊三語系翻譯 
1. 修改 MachineService 中的 0424 代碼標籤為 Purchase successful（購買成功）並改寫成功判定邏輯。
2. 移除 DiscordWebhookService 中重複且過時的 errorCodes 硬編碼對照，統一由 MachineService 作為單一真實來源。
3. 同步更新 MQTT 即時通訊規格文件中有關 0424 的定義與出貨結果判定規則。
4. 新增並以自動對齊腳本完美補齊 en/zh_TW/ja 三語系檔中所有 53 種硬體代碼翻譯，完成排序（ksort）與斜線不逸出處理。
 2026-05-29 09:13:16 +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
c3e60b8746 [FEAT] 新增商品 Excel 批量匯入與模板下載功能 
1. 新增 ProductImportService 服務，實作 Excel 商品檔案解析、欄位驗證、多租戶 company_id 歸屬處理及資料批量寫入/更新邏輯。
2. 在 ProductController 新增 import 與 downloadTemplate 動作，處理檔案接收驗證與匯出，並在匯入後自動重建該公司商品目錄快取。
3. routes/web.php 新增商品下載模板與 Excel 匯入的專用路由。
4. 重構 products/index.blade.php，新增極簡奢華風商品匯入 Modal、檔案拖放/選擇區，並採用 Alpine.js 進行彈窗開啟與非同步上傳 API 交互。
5. 擴充 components/page-header.blade.php，使頁面主標頭支援渲染多個操作按鈕 (actions 插槽)，以配合新增的「匯入商品」按鈕。
6. 同步更新 lang/zh_TW.json 與 lang/en.json，對齊「商品匯入成功」、「請選擇公司」等相關語系翻譯。
7. 微調 AdvertisementController，維持全站 Controller 進度對齊。
 2026-05-28 11:19:00 +08:00
sky121113
dd5e78a9ff [FIX] 修正 APK 版本強制更新開關永遠為開啟的 Bug 
1. 修正 ApkVersionController::store() 中 is_forced 欄位的判斷邏輯
2. 原邏輯使用 $request->has('is_forced') 判斷，但因表單含 hidden input (value=0)，導致 key 永遠存在，has() 永遠回傳 true
3. 改用 $request->boolean('is_forced') 直接讀取欄位值，正確將字串 '0' 轉為 false、'1' 轉為 true
 2026-05-27 17:17:26 +08:00
sky121113
62f54499ce [FIX] 移除角色權限設定中已廢棄的特殊權限模組 
1. 修改 PermissionController 中的 activeModules 清單，將已不存在的「特殊權限 (menu.special-permission)」模組移除，修正權限篩選邏輯。
2. 同步修改 role-card.blade.php 與 role-list.blade.php 視圖，將特殊權限從模組列表陣列中剔除，確保角色詳情卡片的權限計數與標籤顯示精確無誤。
 2026-05-27 10:03:14 +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
016cb571c4 feat: 合併 A4 極簡奢華風列印功能與多租戶防護 2026-05-22 10:24:30 +08:00
sky121113
4dad775568 [FIX] 修正台灣地址解析經緯度失敗問題 
1. 新增 cleanFloorInfo 方法，過濾地址末尾的樓層、室、地下室等非門牌雜訊，防範 Nominatim 解析失敗。
2. 重構 parseTaiwanAddress 的路名拆分正則表達式，導入層級感知台灣地址結構，避免含有「巷、弄」的地址被提前截斷。
 2026-05-22 09:51:05 +08:00
sky121113
b6e5b825a5 [STYLE] 將溫度過低告警側邊條顏色調整為警示紅色 2026-05-21 17:09:00 +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
dac00291a7 feat: 實作調撥單與機台補貨單的 A4 極簡奢華風列印功能與多租戶雙重防護 2026-05-21 15:43:43 +08:00
sky121113
205da14e94 [FEAT] 優化溫度告警狀態轉移邏輯與完善機台專屬通知設定 UI 
1. 修正 `ProcessHeartbeat.php` 溫度告警判定邏輯，避免溫度在「高低溫異常狀態」直接轉換時，誤發含有異常溫度的「恢復正常」通知。
2. 實作機台層級自訂通知類型 (`notify_types_mode`) 功能，支援繼承全域設定或獨立指派通知類型（連線、溫度、硬體異常）。
3. 優化前端 UI 邏輯，當選擇自訂通知且包含「溫度告警」時，方才顯示溫度上下限輸入區塊。
4. 修正複製機台設定功能 (copy-machine) 的行為，確保能正確複製 `discord_notify_types` 並重設選擇器狀態。
5. 新增與更新中、英、日語系翻譯字串。
 2026-05-21 14:34:55 +08:00
sky121113
2e3d6e5572 [STYLE] 優化機台型號與通知設定介面並調整溫度為整數告警 
1. 調整 Discord 通知設定介面的間距與對齊，使其與基本設定中的機台設定保持一致。
2. 重構機台型號設定 Modal，將溫度上下限的輸入框改為「極簡奢華風」的加減按鈕元件。
3. 更新機台型號溫度相關的設定與顯示，強制限制與轉換為整數 (移除小數點)。
4. 將機台型號的溫度限制相關介面文字更新為「告警」相關字眼 (預設溫度告警上限、預設溫度告警下限等)。
5. 於中、英、日語系檔案中新增溫度告警相關之翻譯鍵值。
 2026-05-21 13:25:28 +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
1ee57f3e88 feat(auth): 實作後台單一設備登入，並套用 auth.session 中間件 2026-05-19 16:51:43 +08:00
sky121113
1aa5aed72e feat(sales): 升級銷售紀錄高奢翡翠綠導出下拉選單與修復進度條卡死 2026-05-19 12:33:06 +08:00
sky121113
1778d48a00 [FIX] 員工卡匯入時自動清除欄位前後空白字元 
1. 於 `StaffCardImportService` 中，將讀取自 Excel 的員工編號（employee_id）與卡片 UID（card_uid）使用 `trim()` 去除前後空白字元，防止因複製貼上夾帶空格導致後續比對與搜尋失效。
2. 同步將姓名（name）與備註（notes）也進行去空白處理，提升資料的一致性與品質。
 2026-05-19 11:40:59 +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
916d0891f1 [FEAT] 新增分析管理與子項目的角色權限配置 
1. 在 RoleSeeder 中註冊分析管理的 4 個子權限（零錢庫存、機台報表、商品報表、問卷分析），並僅指派「商品報表」權限給租戶管理員模板。
2. 在 PermissionController 與視圖 (role-list, role-card) 的 activeModules 白名單中加入 menu.analysis，使數據分析大項能正常被撈取與顯示。
3. 修改 sidebar-menu.blade.php，用 @can 防護數據分析子選單；修改 web.php 為 4 個分析路由掛載 middleware('can:...') 路由防護。
4. 補全 zh_TW.json、en.json、ja.json 翻譯檔案中關於 4 個新分析權限的金鑰與翻譯文字。
5. 修復 2026_05_11_163543_add_missing_types_to_machine_stock_movements_table.php 歷史 migration 以相容 SQLite 測試。
6. 新增 AnalysisPermissionTest.php 測試案例並於本地測試通過，保證多租戶與 RBAC 架構之權限隔離與防越權機制 100% 正確運作。
 2026-05-18 17:22:45 +08:00
sky121113
154a2e0553 [FEAT] 重構與優化商品利潤統計報表功能 
1. 【後端優化】重構 AnalysisController.php，以高效單次 SQL 統計計算銷量、銷額、總成本與淨利，套用 company_id 進行多租戶隔離，支援超級管理員跨租戶查詢，並解決 MySQL only_full_group_by 嚴格模式的 group by 語法相容問題。
2. 【前端介面】全新實作 product-reports.blade.php 極簡奢華風視圖，整合 Flatpickr 雙向日期區間選擇與「近 7 日、今日、本週、上週、本月、上月」快速切換快捷按鈕。
3. 【圖表自適應】整合 ApexCharts 銷售走勢曲線與圓餅圖，設計 PHP 端走勢數據日補零機制，並導入 ResizeObserver 進行圖表寬度百分之百響應式重繪。
4. 【尊榮數據導出】提供複製 (tsv)、CSV、Excel 與 PDF/列印的多維度導出引擎控制項。
5. 【高級前端分頁】對齊銷售紀錄規格，實作 Alpine.js 純前端高級分頁與 Show 10/25/50/100 筆數選擇器，並修復 select 動態 option 渲染時 ES6 template string 逸出問題。
6. 【細節齊平與遮擋修正】將日期 Input 寬度由 sm:w-56 拓寬至 sm:w-72，將日曆 Icon 左邊距從 pl-3.5 改進為 pl-5，Input 文字內左距調整為 pl-13，達到與 searchable-select 的 100% 齊平對齊，並配置跨卡片遞降 z-index 層級（z-40 -> z-30 -> z-20）徹底解決下拉選單在電腦版被下方走勢圖 Card 遮擋/截斷的 Bug。
7. 【多語系支援】於 zh_TW.json, en.json, ja.json 補強指標中英日翻譯。
8. 【選單整合】於 sidebar-menu.blade.php 的數據分析模組下正式啟用「商品報表」選單項目。
 2026-05-18 14:46:17 +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
e29826a0a6 [STYLE] 優化機台補貨語意，將「一鍵補貨」修正為「自動補貨單」 
1. 修改 lang/zh_TW.json 的翻譯鍵 "Auto Replenishment" 對照值為「自動補貨單」，使其與手動「新增補貨單」在視覺與語意上形成直覺的對比，實事求是，消除「一鍵」但仍需彈窗選倉庫的 UX 誤導。
2. 同步將 app/Http/Controllers/Admin/WarehouseController.php 中的 autoReplenishment PHPDoc 註解替換為「自動補貨單」。
3. 同步修改 resources/views/admin/warehouses/replenishments.blade.php 中的 JS 代碼註解，將「一鍵補貨」修正為「自動補貨單」。
4. 同步更新 resources/views/admin/warehouses/partials/modal-replenishment-auto.blade.php 模板首行的 Blade 註解。
 2026-05-18 13:14:29 +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
1b63ec6c56 feat(profile): increase profile photo upload limit to 5MB and verify webp storage 2026-05-17 13:09:39 +08:00
sky121113
ea438d55d1 [FEAT] 實作系統管理員切換帳號 (Impersonate) 功能 
1. 新增 `ImpersonateController` 處理帳號切換與退出邏輯，並提供公司與使用者的動態下拉選單 API (包含 username 支援)。
2. 於 `admin.blade.php` 的 Header 個人選單中加入「切換帳號」入口，並支援退出切換狀態的顯示。
3. 實作 `modal.blade.php` Alpine.js 彈窗，使用專案規範的 `x-searchable-select` 動態重建模式 (Dynamic Rebuild Pattern) 與 `focus-within:z-[60]` 防護。
4. 註冊相關 Web Routes。
5. 更新 `ui-minimal-luxury/SKILL.md`，新增 Alpine.js Modal 實作規範，並禁止使用 `hs-overlay` 避免層級堆疊問題。
 2026-05-17 11:07:41 +08:00
sky121113
cf2c2f6e39 [FIX] 修正通行碼載入失敗問題，並標準化所有單據模組的日期篩選器 UI 2026-05-16 23:41:23 +08:00
sky121113
c014d7431c [FIX] 修正重啟後產生重複機台日誌的問題並重構邏輯一致性 
1. 修正 ProcessHeartbeat 在快取失效時會誤報韌體與溫度的問題。
2. 引入 Database Fallback 機制：當 Redis 無紀錄時自動比對資料庫現有值。
3. 統一韌體與溫度的偵測邏輯，確保兩者皆為「比對舊值 -> 異動才記 -> 補回快取」。
4. 提升系統對 CI/CD 重啟或快取清理的容錯能力。
 2026-05-16 21:45:18 +08:00
sky121113
080412d2b3 [FEAT] 優化遠端管理與庫存歷史紀錄之日期篩選介面 
1. 將單一日期區間選擇器拆分為獨立的「開始時間」與「結束時間」輸入框，提升手機版適應性。
2. 修正後端解析邏輯，移除強制 startOfDay() 以支援使用者選擇的精確分鐘數。
3. 修復庫存管理頁面中「截止日」欄位的 HTML 標籤閉合錯誤 (r">" 亂碼)。
4. 導入 Flatpickr defaultDate 與 position 參數，解決時間選擇器 UI 不對齊與邊緣裁切問題。
5. 更新標籤翻譯為「開始時間」與「結束時間」，並補齊庫存分頁的 Alpine.js 預設日期狀態。
 2026-05-16 21:25:47 +08:00
sky121113
9bf670b951 fix: update low stock warning threshold to 20% of max_stock 
1. 移除硬編碼的門檻值 5。
2. 改用 stock <= (max_stock * 0.2) 進行動態判斷。
3. 增加 max_stock > 0 過濾，避免空貨道產生錯誤警示。
 2026-05-16 20:07:12 +08:00
sky121113
88dde0dd25 fix: remove redundant 4-hour temperature fallback log to reduce noise 2026-05-16 16:49:38 +08:00
sky121113
450e6dbe67 [FEAT] 金流配置優化：公司名稱改為選填並優化列表顯示 
1. 新增資料庫遷移腳本，將 payment_configs 資料表的 company_id 欄位改為可為空 (nullable)。
2. 修改 PaymentConfigController 的驗證邏輯，允許 company_id 為空值。
3. 調整金流配置的新增與編輯頁面，移除公司名稱的必填限制及相關 JavaScript 攔截邏輯。
4. 優化金流配置列表，當配置未綁定公司時，將顯示標籤改為「系統」。
 2026-05-15 17:28:33 +08:00
sky121113
2f550839cc [FEAT] 客戶管理欄位（客戶代號、起始日）非必填化 
1. 新增遷移檔將 companies.code 改為 nullable 並增加長度至 100，解決刪除時字串過長的問題。
2. 修改 CompanyController 驗證邏輯，允許 code 與 start_date 為空。
3. 更新前端公司管理頁面，移除 code 與 start_date 的必填限制與 UI 標記。
 2026-05-15 17:02:59 +08:00
sky121113
239ab7fafd [FIX] 修正新增客戶時初始帳號未標記為管理員的問題 
1. 在 CompanyController 新增客戶時，明確為初始管理員帳號加上 is_admin = true，確保其在各權限管理介面能正確顯示。
 2026-05-15 15:05:43 +08:00
sky121113
143050a5c6 fix: improve advertisement notification feedback and error handling 2026-05-15 14:01:50 +08:00
sky121113
0685c71141 [FIX] 修復廣告圖片上傳失敗與優化錯誤提示 
1. 修正正式環境 Nginx client_max_body_size 限制導致的上傳失敗問題（已於 Host 端同步修正）。
2. 在 AdvertisementController@store 加入 try-catch 區塊與 Log 紀錄，確保圖片處理異常時回傳 JSON 錯誤。
3. 優化前端上傳 AJAX 邏輯，當發生 413 (檔案太大) 或 500 錯誤時提供明確的提示訊息。
 2026-05-15 13:50:33 +08:00
sky121113
752d149940 [FEAT] 支援機台計畫性重啟狀態與語系更新 
1. 修改 ProcessStatus Job，支援處理 'restarting' 狀態，並將其記錄為 INFO 層級而非警告。
2. 更新繁體中文與日文語系檔，新增「重啟中 / 再起動中」的翻譯。
3. 確保計畫性重啟不會觸發異常離線警報。
 2026-05-14 18:07:53 +08:00
sky121113
dd641a2fc1 [STYLE] 優化機台日誌溫度圖表顯示 
1. 修改機台溫度數據 API，改為傳送毫秒級時間戳記，以支援 ApexCharts 時間軸。
2. 將圖表橫軸類型改為 datetime，解決時間標籤重疊擁擠的問題。
3. 隱藏 ApexCharts 預設的無障礙輔助文字。
4. 優化提示框 (Tooltip) 顯示格式，改為顯示完整年月日時分秒，並自定義標題。
5. 關閉圖表動畫以提升側邊欄載入效能。
 2026-05-14 17:56:42 +08:00
sky121113
a16b0363a8 [FEAT] 新增機台日誌溫度趨勢圖與同步指令日誌補全 
1. 修改 ProcessCommandAck.php，將「同步商品」與「同步廣告」指令加入日誌紀錄白名單，確保同步結果正確寫入機台日誌。
2. 在 MachineController 新增 temperatureAjax API，從機台日誌中提取歷史溫度數據供圖表使用。
3. 在 web.php 註冊溫度數據 AJAX 查詢路由。
4. 在機台管理頁面 (index.blade.php) 的日誌面板中整合 ApexCharts，並於「機台狀態」分頁內嵌入溫度趨勢曲線圖。
5. 更新 Alpine.js 邏輯，實現圖表與日期篩選的同步連動，並優化面板展開時的圖表渲染。
6. 新增繁體中文、英文、日文的「溫度趨勢」翻譯標籤，並修復語言檔中的重複 key 與翻譯內容。
 2026-05-14 17:17:55 +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
11671f3a2b [REFACTOR] 修改員工識別卡匯入邏輯：改以員工編號作為比對基準 
1. 修改 StaffCardImportService，將 updateOrCreate 的比對欄位從 card_uid 改為 employee_id。
2. 這樣當員工補發新卡時，透過 Excel 匯入相同的員工編號即可直接更新其卡號。
 2026-05-14 14:33:07 +08:00
sky121113
cc03572dd9 [FEAT] 實作員工識別卡 Excel 批量匯入功能與範例下載 
1. 新增 StaffCardImportService，整合 OpenSpout 5.x 處理解析與批量更新邏輯。
2. 在 StaffCardController 加入匯入與範例下載 API 端點。
3. 更新員工識別卡 index 視圖，新增「匯入 Excel」按鈕與 Alpine.js 異步匯入彈窗。
4. 註冊相關 Web 路由。
5. 補全繁中、日文、英文多語系翻譯，並修復重複鍵值。
6. 修復 OpenSpout 5.x 相容性問題 (Row::getCells -> Row::toArray)。
 2026-05-14 14:26:35 +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
b87fae8eb1 [FEAT] 優化商品操作紀錄清單與多語系支援，並修復全域快取錯誤 
1. 修復 ProductCatalogService 在處理全域商品（company_id 為 null）時引發的型別錯誤
2. 在操作紀錄清單新增「操作人員」欄位，並優化手機版顯示
3. 將「MODULE / 目標」欄位更名為更直覺的「操作目標」
4. 於 status-badge 元件加入操作紀錄（CREATE, UPDATE, DELETE）的專屬顏色與多語系對應
5. 補齊 zh_TW.json 缺漏的機台權限、操作動作與商品相關欄位多語系翻譯
 2026-05-14 11:52:01 +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
9ff9abef89 [FEAT] 實作「同步到所有機台」功能與商品資料同步機制 
1. 在商品管理介面新增「同步到所有機台」按鈕與 Alpine.js 確認彈窗。
2. 實作後端 syncToAllMachines 控制器邏輯，並加入同一公司 1 分鐘內禁止重複發送的限制。
3. 建立 SyncProductsToMachinesJob 與 SendProductSyncCommandJob 非同步隊列任務，支援舊指令覆蓋機制。
4. 補全繁體中文、英文與日文的多語系翻譯字串。
5. 更新遠端指令日誌視圖，支援展示商品同步指令及其備註。
6. 更新 MQTT 通訊規範與 API 技術規格文檔，納入 update_products 指令。
7. 整合 update_ads 與 update_products 指令至 config/api-docs.php 的系統指令規格中。
 2026-05-14 09:33: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
f9d3217099 [FEAT] 優化廣告素材上傳體驗與進度顯示 
1. 在廣告建立與編輯彈窗中實作基於 XMLHttpRequest 的 AJAX 上傳機制。
2. 新增即時上傳進度條顯示，並整合全域頂部載入條。
3. 實作上傳期間禁用提交按鈕與顯示「上傳中...」狀態，提升使用者反饋感。
4. 更新 AdvertisementController 確保 JSON 回應後能正確快閃成功訊息至 Session。
 2026-05-13 17:37:18 +08:00
sky121113
69e825aeb3 [STYLE] 調整 IoT API 回應格式與程式碼風格 
1. 移除 B005, B012, B014, B017 回應中的 message 欄位，以相容機台端的解析邏輯。
2. 統一 MachineController 內的型別轉換格式與程式碼縮排。
3. 同步更新 api-docs.php 文件範例，移除多餘的 message 欄位。
 2026-05-13 14:17:24 +08:00
sky121113
0e6f5b703c [FIX] 標準化 IoT API 回應格式 (B005, B012, B014, B017) 
1. 修正 B005 (廣告同步) API，將數值欄位轉為整數並補齊 message 欄位，以符合 Java APP 預期格式。
2. 標準化 B012, B014, B017 等 IoT 端點回應結構，統一加入 "message": "OK" 欄位。
 2026-05-13 14:11:26 +08:00
sky121113
ce87f453a2 [FEAT] 優化廣告同步與指令中心 UI 
1. 廣告管理：將原生 confirm 替換為極簡奢華風 Alpine.js 彈窗，並新增「操作備註」欄位與「目標機台」顯示。
2. 指令中心：在指令確認彈窗中新增「目標機台」顯示，並優化 UI 佈局。
3. 多語系支援：新增 Sync Ads (同步廣告) 至 zh_TW, en, ja 語系檔，並應用於指令中心與篩選列。
4. 後端邏輯：更新 AdvertisementController，將操作備註正確存入 RemoteCommand 的 remark 欄位。
5. 指令規範：同步更新 MQTT 通訊規範 (SKILL.md) 與 API 文件 (api-docs.php)，加入 update_ads 指令說明。
 2026-05-13 13:51:24 +08:00
sky121113
7d3e25d090 [FIX] 優化庫存輸入邏輯與數值處理 
1. 在 MachineController 中加入庫存數值強制轉型邏輯，確保後端驗證前已處理字串數值（如 "01" 轉為 1）。
2. 在遠端庫存調整介面中，為 Alpine.js 的 x-model 加入 .number 修飾符，強化前端資料類型一致性。
 2026-05-13 10:25:21 +08:00
sky121113
2fd6419129 [FEAT] 商品圖片尺寸標準化與自動裁切功能實作 
1. 增強 ImageHandler trait，支援居中裁切（Center Crop）與指定尺寸縮放功能。
2. 更新 ProductController 的 store 與 update 方法，強制將商品圖片處理為 320x320 像素之 WebP 格式。
3. 優化 create 與 edit 商品頁面，新增 320x320 建議尺寸與自動裁切之提示文字。
4. 新增繁體中文、英文與日文的多語系翻譯對應。
 2026-05-13 09:46:24 +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
ad921011f0 [STYLE] 優化機台日誌顯示與多語系支援 
1. 將員工卡與取貨碼驗證失敗的日誌層級由 WARNING 調降為 INFO。
2. 將日誌訊息字串改為支援多語系翻譯的佔位符格式。
3. 新增員工卡與取貨碼驗證失敗的繁中、英文、日文翻譯。
 2026-05-12 16:00:40 +08:00
sky121113
a290d5b306 [FIX] 優化 MQTT 錯誤代碼翻譯與交易核銷邏輯 
1. 更新 MQTT 錯誤代碼 0205 的標籤為 Slot sensor blocked，並將繁體中文翻譯修正為「貨道口有物」，同步更新多語系檔 (zh_TW, en, ja)。
2. 修改 TransactionService，移除遠端出貨 (payment_type: 100) 在交易結案時的 code_id 自動核銷邏輯。
3. 更新 SKILL.md 與 api-docs.php 規格文件，將「通行碼 (5)」納入 code_id 核銷範圍，並移除遠端出貨的說明。
 2026-05-12 14:27:00 +08:00
sky121113
2cf33cfbb4 [FIX] 優化遠端指令鎖定機制與補全 API 文件 
1. 實作庫存更新 (reload_stock) 的「直接覆蓋 (Supersede)」模式，允許管理員即時覆寫待執行指令，提升操作流暢度。
2. 為遠端出貨 (dispense) 增加 1 分鐘自動逾時機制，解決因未收到 ACK 導致貨道永久鎖定的問題。
3. 拆分庫存更新與遠端出貨的併行檢查邏輯，確保兩者互不干擾。
4. 更新 API 技術文件，補全遠端出貨 (payment_type: 100) 與閉環勾稽參數 (code_id) 的規格說明。
 2026-05-12 10:17:51 +08:00
sky121113
3bb5d8cfcc [FIX] 修正遠端出貨指令逾時處理機制與補全多語系支援 
1. 建立資料庫遷移，於 remote_commands 的 status ENUM 中新增 timeout 狀態，修復 Data truncated 錯誤。
2. 更新 MachineService::dispatchDispense 邏輯，當指令超過 1 分鐘未回報時自動標記為 timeout 並記錄原因。
3. 於 zh_TW.json 與 en.json 補全 timeout、superseded 狀態及相關備註的翻譯。
4. 更新 status-badge 元件預設值，支援遠端指令相關狀態（sent, success, failed, timeout, superseded）並套用視覺樣式。
 2026-05-12 08:57:27 +08:00
sky121113
53ced5ca5b [FEAT] 遠端出貨指令支援 1 分鐘逾時覆蓋機制 
1. 修改 MachineService::dispatchDispense：若同貨道有 pending 指令，超過 1 分鐘未回報則視為逾時，自動將舊指令標記為 timeout 並允許新指令覆蓋下發。
2. 1 分鐘內仍有 pending 指令則維持拒絕，防止短時間重複出貨。
 2026-05-11 18:04:42 +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
ee47f65523 [FEAT] 優化機台重啟狀態處理邏輯 
1. 在 ProcessStatus Job 中新增對 restarting 狀態的判斷。
2. 若機台處於計畫性重啟狀態，則不寫入狀態變更日誌，避免後台誤報。
 2026-05-11 14:15:26 +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
f06353d542 feat: change default machine inventory sorting to stock fill rate (ascending) 2026-05-07 14:40:48 +08:00
sky121113
053c41d642 feat: optimize B009 stock sync with full-sync logic and historical slot filtering 2026-05-07 14:38:19 +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
e735e5a8c5 [REFACTOR] 優化 B009 庫存同步比對邏輯 
1. 優化 MachineService@syncSlots，加入庫存與商品 ID 的實質變動檢查。
2. 解決在庫存與商品皆無變動時，仍會執行資料庫更新並產生冗餘流水帳的問題。
3. 強化商品變更判斷，確保更換商品時能正確記錄流水帳與對應備註。
 2026-05-07 14:12:42 +08:00
sky121113
9c6f5923f3 [FIX] 規格對齊與 B009 庫存同步邏輯優化 
1. 更新 B009 (貨道庫存回報) API 規格文件與 config/api-docs.php，對齊參數型別 (tid: String, num: Integer) 並移除 legacy status 欄位。
2. 修正 MachineController 接收參數時的強製型別轉型，防止因 APP 傳入字串格式導致的庫存異動判斷錯誤。
3. 優化 MachineService@syncSlots 邏輯，確保庫存變動比對準確，並補齊新建立貨道時的初始庫存流水帳紀錄。
4. 移除 B009 回應中的 status 欄位，統一使用 success 進行成功判定。
 2026-05-07 14:07:26 +08:00
sky121113
bb955fa3de [STYLE] 現代化機台稼動率儀表板與語系優化 
1. 更新機台稼動率頁面日期選擇器為專案標準 Luxury UI，並整合 Flatpickr 新增「今日」與「清除」按鈕。
2. 修正稼動率頁面中因字串換行與多餘空格導致的語系翻譯失效問題。
3. 更新稼動率副標題，移除過時的 OEE 描述並修正為「全機台即時狀態與營收監控」。
4. 同步更新 zh_TW, en, ja 語系 JSON 檔以包含最新的介面文字翻譯。
5. 重構 MachineService.php 移除冗餘的計算邏輯，提升稼動率數據查詢效能。
6. 更新 API 技術規格文件以反映最新的通訊協議規範。
 2026-05-07 13:34:22 +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
4bf53db3be [FIX] 優化機台連線規範與上線日誌邏輯 
1. 更新 SKILL.md 與 Java 範例，將 MQTT Client ID 格式由隨機後綴改為固定格式 SC_{serial_no}，以確保單機連線唯一性。
2. 同步更新 config/api-docs.php，在 API 文件中加入 MQTT 連線參數規範說明。
3. 修正 ProcessHeartbeat.php 邏輯，當機台狀態從 offline 轉為 online 時，自動寫入「Machine is online」日誌，完善連線紀錄回溯。
 2026-05-07 10:16:29 +08:00
sky121113
09bbd61c89 [FIX] 導正 MQTT LWT 遺囑訊息架構與文件規範 
1. 修改 SKILL.md 規範，將 LWT (遺囑訊息) Topic 從 heartbeat 改為 status，並移除過時的  訂閱說明。
2. 更新 SKILL.md 內 Android Java 範例，同步改用 status Topic。
3. 移除 SKILL.md 中關於 Client ID 解析邏輯的舊文件說明。
4. 重構 ProcessStatus.php，移除過時的 SC_ 前綴與隨機碼解析邏輯，直接使用傳入的純淨機台編號。
5. 更新 ProcessHeartbeat.php 註解，反映連線狀態改由 LWT 機制與 status Topic 處理。
 2026-05-07 09:22:09 +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
4348a88697 [DOCS] 規範化 B000 認證機制並移除冗餘 API 
1. [DOCS] 更新 B000 登入 API 規格，統一參數名為 Su_Account/Su_Password 並要求帶入機台 API Token。
2. [REFACTOR] 將 B000 路由移入 iot.auth 中間件，強化 API 安全性。
3. [DOCS] 移除廢棄的 B710 (時間同步) API 說明。
4. [DOCS] 調整 B014 認證與安全規範描述，使其符合現行機台引導流程。
 2026-05-06 14:25:40 +08:00
sky121113
41c75b16e8 [FEAT] 實作機台序號變更自動重新產生 API 金鑰 
1. 於 MachineSettingController@update 實作序號變更偵測，若序號有變動則自動重新產生 api_token。
2. 更新編輯成功的通知訊息，明確提示使用者金鑰已因序號變動而更新。
3. 補齊中、英、日三語系之通知訊息翻譯字串。
 2026-05-06 13:56:56 +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