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
|
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
|
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
|
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
|
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
|
5e63370983
|
[DOCS] 更新 B014 API 技術規格說明與文案調整
1. [DOCS] 更新 SKILL.md 中 B014 介面的認證規範，改為透過 machine 參數識別。
2. [DOCS] 移除 SKILL.md 中關於 B014 的冗餘安全性規範說明。
3. [DOCS] 調整 api-docs.php 中 B014 的描述文案並修正行尾空白。
|
2026-05-06 14:13:02 +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
|
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
|
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 |
|