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

75 Commits

Author SHA1 Message Date
twsystem1004
be73e7c7a0 feat(sales): 現金支付面額明細（收各面額張數+找零）回傳並於銷售紀錄顯示 
- orders 新增 cash_detail JSON 欄（migration）
- Order model fillable/casts + cash_received_summary accessor
  （顯示「收：總額（只列有收到幣別明細）　找：x」）
- TransactionService create/transition 兩處寫入 cash_detail
- 銷售列表 blade 桌機/手機各加一列現金明細

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-03 04:35:15 +00:00
terrylee
dc9421e482 取貨碼/通行碼/銷售紀錄 後台功能 
- 取貨碼使用紀錄記實際出貨貨道(PickupCodeLog.raw_data.slot)
- 銷售紀錄訂單列(支付金額欄)顯示取貨碼序號(member_barcode)
- 遠端指令中心「遠端出貨」→「遠端開櫃」(zh_TW.json Remote Dispense)
- 訂單品項記消費者選的貨道(order_items.slot_no + migration)，失敗交易也看得到；
  訂單明細顯示 Slot；OrderItem/TransactionService 對應
- 通行碼「只能使用一次」：pass_codes.usage_limit/usage_count + migration；
  建立表單加勾選；B670(verifyPassCode)驗證時消耗、達上限標 used；PassCode.isValid 判斷

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-02 03:11:24 +00:00
sky121113
8a92e1c1ff [FEAT] 銷售紀錄手動補單功能（機台斷線/漏報時人工補登） 
1. 新增 TransactionService::createManualOrder()：複用既有 recordDispense()（扣庫存）與 recordInvoice()+IssueInvoiceJob（後台開發票），訂單標記 order_type=manual、created_by 操作者，flow_id 以 MAN 前綴與機台上報區隔並天然避開唯一鍵衝突。
2. Order 新增 TYPE_MANUAL 常數與 is_manual 存取器；created_at/machine_time 對齊實際發生時間，使銷售報表落在正確日期。
3. SalesController 新增 storeManualOrder()（建單）與 manualMachineSlots()（機台貨道 AJAX）；發票類型支援統編/手機條碼/自然人憑證/捐贈/一般 B2C，並寫入 SystemOperationLog 審計留痕。
4. 權限：整個補單功能限系統管理員（按鈕、彈窗、AJAX、store 四處把關）；開立電子發票受機台 tax_invoice_enabled 閘門限制，前端隱藏選項 + 後端再驗一次。
5. 新增路由 admin.sales.manual.store 與 admin.sales.manual.machine-slots。
6. 前端：銷售訂單頁籤新增「手動補單」按鈕（僅系統管理員），slide 彈窗全面採用站內元件樣式——下拉用搜尋式 x-searchable-select（機台/貨道/付款/發票類型）、價格與數量改用「新增取貨碼」同款 +/- 計數器、去除原生 number spinner。
7. 訂單列表（桌面與行動卡片）為手動補單顯示「手動」標籤。
8. 三語系（zh_TW/en/ja）補齊 35 組字串並對齊排序、斜線不逸出。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 16:17:54 +08:00
terrylee
41e9b0d57c [PROMOTE] dev -> demo: 副櫃系統授權開關 + 交易total_amount修正(含dev累積變更) 2026-06-25 08:24:05 +00:00
twsystem1004
ee22ff9e6d [FIX] finalize 轉移未更新 total_amount 導致銷售金額顯示0 
transitionOrder(pending→completed) 原只更新 pay_amount，補上 total_amount/original_amount/discount_amount，避免後台銷售紀錄金額停在建立時的0。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 08:11:36 +00:00
sky121113
7044d4cefd [FIX] 合併取貨碼/通行碼/來店禮租戶機台授權修復 2026-06-24 15:40:33 +08:00
sky121113
3007bfb254 Merge branch 'feat/slot-lock-expiry-bidirectional-sync' into demo 2026-06-24 14:25:51 +08:00
sky121113
af78c48d8e [FEAT] 貨道效期+鎖定 App↔後台雙向同步（LWW） 
1. machine_slots 新增 is_locked / last_app_lock_rev / last_app_expiry_rev（migration）；MachineSlot model fillable+casts。
2. syncSlots(B009)：新增 per-field 常態 LWW（App rev 較大才採用）；換商品(product_id 變更)時清空舊 expiry/batch 安全網；空值一律歸一化為 null。
3. updateSlot：下行 update_inventory 一律帶 is_locked + lock_rev + expiry_rev，後台編輯只更新「帶上的欄位」（鎖定切換不會清效期），對應 rev +1 成為權威值。
4. 新增 admin slots/lock endpoint（toggleSlotLock）+ route；remote/stock.blade.php 貨道編輯彈窗加「販售狀態/鎖定·解鎖」toggle。
5. 不含 app_uuid/重灌/B017 概念（精簡版）；既有現場鎖定靠 App 端升級遷移(lock_rev=1)走常態 LWW 上雲。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 14:25:33 +08:00
sky121113
1a1518c611 [FIX] 合併 feat/inventory-mqtt-resend：庫存效期 MQTT 逾時自動解鎖 + timeout 多語系 2026-06-24 09:06:32 +08:00
sky121113
fcff9a0fc6 [FIX] 合併 feat/inventory-mqtt-resend：庫存效期管理 MQTT 下發逾時自動解鎖 
1. slotsAjax 的 is_pending 僅計入 1 分鐘內的 pending reload_stock，逾時自動解鎖
2. updateSlot 重新下發時逾時舊指令標記 timeout、否則 superseded
 2026-06-24 08:58:20 +08:00
sky121113
3293a76c91 [FIX] 庫存效期管理補上 MQTT 下發逾時自動解鎖 
1. slotsAjax 的 is_pending 僅計入 1 分鐘內的 pending reload_stock 指令，超過視為逾時自動解鎖，避免機台未回 ACK 時介面永久卡住
2. updateSlot 重新下發時，逾時舊指令標記為 timeout、未逾時標記為 superseded，與 dispense 逾時邏輯一致

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 08:57:56 +08:00
sky121113
d1c7940db9 [PROMOTE] feat/expiry-clear-on-sellout → demo：售完清效期測試驗收 
1. recordDispense 售完（stock=0）即清空貨道 expiry_date 與 batch_no，避免舊批效期殘留誤鎖新批貨
2. 新增 ExpiryClearOnSelloutMysqlTest 驗收測試
3. 同步併入 main 既有提交：每機台商品定價 + 補貨單/機台列表 RWD 修正（fcd0588、c5a3f99）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

# Conflicts:
#	app/Services/Transaction/TransactionService.php
 2026-06-23 17:24:12 +08:00
sky121113
e0532a539f [FEAT] 售完即清空貨道效期與批號 
1. recordDispense 扣庫存後，若 stock 歸 0 則一併清空 expiry_date 與 batch_no，避免舊批效期殘留：日後僅補 stock 未改效期時，update_inventory 不會把過期日下發、誤將新批貨鎖成「暫不販售」，與機台端「賣完清效期」對稱
2. 新增 ExpiryClearOnSelloutMysqlTest 驗證售完清效期行為

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 17:23:02 +08:00
sky121113
94a941e100 [FIX] backport 至 dev:每機台商品定價 + 機台列表 RWD + 多語系對齊 2026-06-23 16:43:46 +08:00
sky121113
5621cad1bf [PROMOTE] feat/per-machine-product-pricing → demo:每機台商品定價 (WIP) 上 demo 測試 2026-06-23 15:55:14 +08:00
sky121113
1685b858f9 [FEAT] 每機台商品定價 WIP 暫存 
1. 新增 MachineProductPrice 模型與 machine_product_prices 資料表 migration
2. 機台設定頁新增定價分頁 pricing.blade.php
3. 調整 ProductCatalogService、MachineController、Machine 模型支援每機台價格
4. 補貨單修正前的進度暫存，待後續完成

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 15:38:14 +08:00
root
003ba9b1ad [FEAT] 新增領藥單（Pharmacy Pickup / Rx）功能並強化出貨防呆 
1. 領藥單後台：新增 PharmacyPickupController 與 PharmacyPickupService，提供領藥單列表／建立／作廢／列印 QR；routes/web.php 新增受 menu.sales.pharmacy-pickup 權限控管的路由群組，RoleSeeder 補該權限、sidebar 新增選單。
2. 訂單模型：Order 新增 order_type(sale/pharmacy_pickup)、pricing_slip_no、created_by 欄位與 AWAITING_PICKUP 狀態，新增 sales/pharmacyPickup scope 及 creator/pickupCode 關聯。
3. 機台設定：系統設定新增「領藥單」開關，僅在取物單(pickup_sheet)模式下可啟用、其他模式強制關閉；含後端防呆、toggle UI 與啟用功能標籤顯示。
4. 機台 API：getSettings FunctionSet 增加 PharmacyPickup 旗標；B660 取貨核銷擴充領藥單多貨道出貨清單回傳，庫存不足／無可用貨道時嚴格擋關且不消耗領藥碼。
5. 出貨流程：TransactionService finalizeTransaction 以 order_no(RX) 對應預建領藥單，走 finalizePharmacyDispense 獨立冪等出貨流程，並標記領藥碼已領與核銷日誌。
6. 防呆修正：recordDispense 庫存<=0 時不再扣減以避免負庫存；syncSlots 上報清單為空時不執行全量刪除，避免誤清貨道。
7. 資料庫：新增 2 個 migration（orders 增領藥單欄位、pickup_codes 之 slot_no 改 nullable）；PickupCode 開放 status 可填、isValid 容許 null expires_at。
8. 多語系／文件：zh_TW/en/ja 三語系對齊補齊領藥單相關詞彙（27 個）；config/api-docs.php 補 PharmacyPickup 旗標說明。
 2026-06-23 02:19:17 +00:00
sky121113
ddac862cee [FEAT] 交易結算冪等性強化與 flow_id 跨機台命名空間 
1. finalizeTransaction 將 flow_id 前綴機台序號(serial+rawFlowId)使其全域唯一，解決跨機台單機 flow_id 撞號問題；ACK 仍回傳原始 flow_id，App/outbox 對帳無感。
2. 終態冪等檢查移入 DB transaction 並對既有 order 加 lockForUpdate 排他鎖，防止兩個 worker 同時穿透 pending 而重複出貨/扣庫存/核銷。
3. 取貨碼(PickupCode)與來店禮(WelcomeGift)核銷加排他鎖，防並發 lost-update 使 usage_count 突破 usage_limit。
4. recordInvoice 的 RelateNumber 推導改為直接取用已前綴序號的 flow_id，與線上既有 serial+rawFlowId 逐字等價，不重複加序號。
5. 新增 FinalizeIdempotencyTest、FinalizeStockMysqlTest 與 phpunit.mysql.xml(MySQL-only DDL 測試設定)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 17:14:19 +08:00
sky121113
df3c72e927 [FEAT] 機台刷卡機 (Nexsys 終端機) 健康狀態燈號與失敗日誌 
1. 刷卡機共用判定：信用卡(1)、電子票證(2)、手機支付(10) 走同一台實體刷卡機，以交易結果維護燈號（刷卡機無斷線心跳）。
2. ProcessTransactionFinalized 新增 syncCardTerminalStatus：成功交易自動消除該機台未解決的 card_terminal 警告；失敗交易解析 payment_response 的 "| code=XXXX" 回應碼，寫一筆 type='card_terminal' 的 warning 日誌（warning 級不觸發 Discord）。
3. MachineService 新增 CARD_TERMINAL_CODE_MAP（NCCC/聯卡中心回應碼對照，值為英文翻譯鍵）；MachineLog 依 card_code 重組多語可讀失敗原因。
4. Machine 模型新增 card_terminal_status 與 latest_card_terminal_log_time 取值器；MachineController 列表以 withCount + 相關子查詢預載彙總，避免 N+1。
5. 機台列表頁新增「刷卡機」狀態燈號（綠/琥珀/紅 + 最近異常時間）與「刷卡機日誌」分頁。
6. 文件更新：config/api-docs.php 與 api-technical-specs SKILL.md 補充 payment_type 說明（2/10 與 1 共用同一台刷卡機、補列 42 取物單與 100 遠端出貨）。
7. 既有 migration change_products_spec_to_text 加 sqlite 守衛，讓測試環境可跑（VARCHAR/TEXT 在 sqlite 等價且不支援 MODIFY）。
8. 新增 CardTerminalStatusTest 功能測試（18 斷言通過，涵蓋成功消警、失敗寫日誌、掃碼排除、多語訊息、N+1 預載路徑）。
9. 新增 25 組三語系 key（刷卡機狀態與回應碼），zh_TW/en/ja 對齊並 ksort 排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 13:09:05 +08:00
sky121113
cbc4ae3749 [FIX] 開立電子發票前檢查機台電子發票開關 
1. finalizeTransaction() 開立發票條件改為「機台 tax_invoice_enabled 開啟 AND 上報帶 invoice」，兩者皆成立才開立。
2. 機台關閉電子發票時：不建發票、不送綠界 IssueInvoiceJob，僅記 warning log（machine_id / flow_id / order_id）供追查。
3. 修正原本只判斷上報是否帶 invoice、完全忽略機台開關而可能誤開發票的問題。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 16:30:17 +08:00
sky121113
4a86be6cbf [FEAT] 商品匯入支援圖片：Excel 圖片檔名欄 + 圖片壓縮檔背景處理 
1. ProductImportService 新增 deferImages 模式與第 18 欄「圖片檔名」，匯入時收集 pending_images 供背景處理，並保留同步轉檔路徑。
2. 新增 AttachProductImagesJob：背景逐筆將圖片轉為 WebP 入庫、更新時刪除舊圖、重建目錄快取、清除暫存資料夾並寫入操作日誌。
3. ProductController::import 新增圖片 zip 上傳（上限 60MB）與安全解壓 extractImageZip：副檔名白名單、getimagesize 內容驗證、basename 防路徑穿越、項目數與單檔及總量上限防 zip bomb，解壓後派發背景 Job。
4. 匯入 Modal 新增選填的圖片 .zip 上傳欄位與背景處理提示文字。
5. config/queue.php 的 redis retry_after 提高至 1830（可由 REDIS_QUEUE_RETRY_AFTER 覆寫），避免長時間圖片任務未完成即被重複派發造成重複處理。
6. 三語系新增圖片匯入相關文案並對齊排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 13:41:22 +08:00
sky121113
d3e455fc82 [FIX] 修正訂單詳情發票狀態勾稽與列印作廢按鈕 
1. 訂單詳情發票徽章改為動態讀取 invoice->status，依 pending/issued/failed/void 顯示對應狀態與顏色，不再寫死「有效」。
2. 移除不存在的 invoice_time 欄位引用，開立時間改以 invoice_date 格式化顯示。
3. 作廢按鈕接上既有 admin.sales.invoices.void 路由，僅於 issued 狀態顯示並加上確認對話框。
4. 新增列印發票功能：EcpayInvoiceService::invoicePrint() 呼叫綠界 B2CInvoice/InvoicePrint 取得列印頁網址，SalesController::printInvoice() 加守衛後 302 導向，並新增 admin.sales.invoices.print 路由，按鈕以新分頁開啟。
5. 補齊三語系 key（Failed to get invoice print URL、Only issued invoices can be printed），完成 zh_TW/en/ja 對齊排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 09:57:37 +08:00
sky121113
b506d64dd3 [FEAT] 實作訂單 pending 狀態轉移與逾時交易自動清除機制 
1. 修改 app/Models/Transaction/Order.php：新增訂單生命週期狀態常數與 TERMINAL_STATUSES 終態定義。
2. 修改 app/Services/Transaction/TransactionService.php：優化 processTransaction 與 finalizeTransaction 的冪等性邏輯，支援 pending 狀態訂單的狀態轉移，並拆分輔助函式 transitionOrder 與 createOrderItems。
3. 新增 app/Console/Commands/SweepAbandonedOrdersCommand.php：建立 orders:sweep-abandoned 指令，將停留在 pending 狀態超過 15 分鐘的逾時訂單標記為 abandoned。
4. 修改 app/Console/Kernel.php：將 orders:sweep-abandoned 定期清理指令註冊至 Schedule 排程中，設定每 5 分鐘執行一次。
 2026-06-16 08:32:06 +08:00
sky121113
d9edeb0d5d [FEAT] 電子發票後台開立、對帳、補開與作廢流程 
1. 新增發票狀態機（pending/issued/failed/void）與冪等鍵 relate_number，並補上 last_checked_at、retry_count、voided_at、void_reason 欄位（migration 全欄位 nullable/有預設，對既有資料零影響並回填既有狀態）。
2. finalize 帶入發票輸入時改為先建 pending 發票，commit 後派發 IssueInvoiceJob 非同步向綠界開立，避免在交易內等待 ECPay 造成長交易。
3. 新增 EcpayInvoiceService 封裝綠界 B2C API（GetIssue 查詢、Issue 補開、Invalid 作廢），金鑰仍取自各機台 payment_configs。
4. 新增 invoices:reconcile 排程指令，每 5 分鐘對 pending 發票以 RelateNumber 向綠界 GetIssue 查證，補登 issued 或標記 failed 待補開。
5. SalesController 新增 reconcileInvoice/reissueInvoice/voidInvoice 三個後台操作端點與對應路由。
6. 發票列表改以 created_at 篩選（pending/failed 尚無 invoice_date 也能顯示），新增狀態過濾器與查詢/補開/作廢操作按鈕，狀態徽章改以狀態機顯示。
7. recordInvoice 改以 flow_id updateOrCreate 收斂，避免重送產生重複發票列；查詢機台/訂單時加上 withoutGlobalScopes。
8. 同步新增相關三語系字串並加入 ecpay_invoice base_url 設定。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 16:18:33 +08:00
sky121113
779c59138f [FEAT] 商品與機台多語系架構，並補上系統設定同步操作 
1. 新增 config/locales.php：定義 11 種系統支援語系白名單（原文＋中文註記）、每台機台上限 5 種與 fallback (zh_TW)。
2. Company 新增 activeLocalesFor()／activeLocales()：計算公司所有機台已開語系的聯集（去重、依白名單排序、保底 zh_TW），加快取與 forgetActiveLocales() 失效機制。
3. products 新增 spec_dictionary_key 欄位（migration）；Product 新增 localized_spec accessor 與 specTranslations 關聯，商品規格比照名稱支援多語系。
4. ProductController 商品建立/更新改收 names 與 specs 物件，寫入 translations（group=product／product_spec），既有商品首次編輯補建 spec key，刪除時一併清除規格翻譯。
5. ProductCatalogService（B012）保留既有 t060v01_en/_jp 欄位，新增 t060v01_i18n／t060v03_i18n locale map，依公司語系聯集輸出並回退 zh_TW，確保線上舊 App 相容。
6. 機台系統設定（updateSystemSettings）新增 languages 顯示語系驗證與寫入（最多 5 種、白名單、去重，僅系統管理員），異動時失效語系聯集快取並重建商品目錄。
7. B014（getSettings）新增 LangSet 下發機台顯示語系（Languages 有序清單＋Default 預設）。
8. 商品建立/編輯頁名稱與規格改為多語系 Tab（讀公司機台語系聯集、完成度標記），新增共用元件 product-locale-tabs；機台系統設定彈窗新增顯示語系勾選 UI（限 5 選、預設標記）。
9. 三語系 JSON（zh_TW/en/ja）新增 5 組對齊鍵並維持字母排序。
10. 同步更新文件：docs/API/product_multilingual_spec.md（規格書）、api-technical-specs SKILL.md（B012 i18n／B014 LangSet）、config/api-docs.php（B012/B014 範例與欄位）。
11. 系統設定同步：新增 sync-settings 路由與 update_settings 指令類型，ProcessCommandAck 與遠端指令歷史（remote index／tab-history）支援 update_settings 標籤，機台系統設定頁新增「同步設定」操作按鈕，並補 B016 回寫測試。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-15 09:00:10 +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
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
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
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
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
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
b6e5b825a5 [STYLE] 將溫度過低告警側邊條顏色調整為警示紅色 2026-05-21 17:09:00 +08:00
sky121113
b3d00a9bef feat: 重構 Discord 雙 Tab 告警設定與機台自適應溫控三層繼承鏈，並導入 Modal 內拉式複製 UX 2026-05-21 10:05:36 +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
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
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
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
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
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
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