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

241 Commits

Author SHA1 Message Date
sky121113
5621cad1bf [PROMOTE] feat/per-machine-product-pricing → demo:每機台商品定價 (WIP) 上 demo 測試 2026-06-23 15:55:14 +08:00
sky121113
3a793978b4 [REFACTOR] 每機台定價改置於機台主模組（自基本設定移出） 
1. 路由 /{machine}/pricing、/{machine}/pricing (POST) 由 BasicSettings\MachineSettingController 移至 MachineController
2. pricing / updatePricing 方法搬遷至 Admin\MachineController
3. 視圖由 basic-settings/machines/pricing.blade.php 移至 machines/pricing.blade.php
4. 機台列表頁 index.blade.php 新增定價入口；移除基本設定 tab-machines.blade.php 內的舊入口

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 15:54:16 +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
sky121113
8e0a30eb98 [PROMOTE] fix/replenishment-company-by-machine → demo:補貨單歸屬改以機台所綁公司為準 2026-06-23 15:34:14 +08:00
sky121113
62d3242db5 [FIX] 補貨單歸屬改以機台所綁公司為準 
1. storeReplenishment / autoReplenishment 建單時 company_id 由「建立者」改為「機台的 company_id」
2. 修正系統管理員為他公司機台建單時 company_id 被寫成 null，導致篩選列選公司及租戶帳號登入皆看不到補貨單
3. 新增 migration 依機台回填既有舊單據的 company_id

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 15:27:31 +08:00
sky121113
ecfbc904a7 [PROMOTE] fix/remote-dispense → demo:遠端強制重啟 APP 指令上 demo 測試 2026-06-23 14:06:07 +08:00
sky121113
871b223440 [FEAT] 遠端控制新增「強制重啟 APP」(reboot_force) 指令 
1. RemoteController storeCommand 驗證白名單新增 reboot_force
2. ProcessCommandAck 將 reboot_force 納入維護類指令日誌記錄
3. 遠端控制頁新增強制重啟按鈕(琥珀色,提示卡死時使用,無視忙碌狀態)
4. 指令歷史篩選與庫存頁指令名稱對應補上 reboot_force
5. 三語系新增 Machine Force Reboot / command.reboot_force / 忙碌狀態提示,並 ksort 對齊

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 14:05:52 +08:00
sky121113
f5cb9a8f7d [FEAT] 領藥單頁面改套極簡奢華風 UI（對齊取貨碼）並修正麵包屑 
1. 重寫 pharmacy-pickup/index.blade.php：改用 x-page-header、Alpine 建立彈窗、x-searchable-select 機台下拉、每項藥品 +/- 數量計數器、桌面表格＋手機卡片、x-confirm-modal 取消確認、luxury 分頁，全面對齊取貨碼 UI。
2. PharmacyPickupController 新增 productsAjax()：依機台 AJAX 回傳可領藥品清單（對齊取貨碼 slots-ajax 模式），並維持取物單模式＋領藥開關雙閘驗證。
3. routes/web.php 新增 pharmacy-pickup/{machine}/products-ajax 路由（受 menu.sales.pharmacy-pickup 權限控管）。
4. breadcrumbs.blade.php 補上 pharmacy-pickup 對照，修正麵包屑斷層，正確顯示「領藥單」層級。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 13:33:44 +08:00
sky121113
eb5b75cf78 [FEAT] 機台報表付款類型新增「手機支付」標籤 
1. AnalysisController::machineReports 付款類型對照表新增代碼 10 = Mobile Pay（NFC 手機感應）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 13:33:31 +08:00
sky121113
f415e138da [FIX] backport hotfix 至 dev：員工卡編輯回填公司 + company_id 寫入保護 2026-06-23 11:27:01 +08:00
sky121113
99debbf259 [FIX] 員工卡編輯彈窗未回填所屬公司，並防止儲存時洗掉 company_id 
1. 修正系統管理員開啟「編輯員工識別卡」時，所屬公司下拉顯示為「選擇公司」空值的問題：Preline 的 option value 為字串，原本直接以數字型別的 company_id 呼叫 setValue，嚴格比對失配導致無法回填，現統一轉為字串 (對齊 ads / welcome-gifts / pickup-codes 既有寫法)。
2. 強化 StaffCardController@update 的寫入安全 (RBAC 1.3)：非系統管理員一律強制綁定自身 company_id；系統管理員若未帶入公司則保留原本歸屬，避免在上述空值狀態按下儲存時把 company_id 洗成 null，造成機台刷卡「查無此員工卡」的孤兒卡。
3. 影響範圍：資料設定 → 員工識別管理之新增/編輯彈窗 (resources/views/admin/data-config/staff-cards/index.blade.php) 與 App\Http\Controllers\Admin\StaffCardController；僅前端回填與後端寫入保護，不更動資料表結構與既有正常卡片資料。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 11:18:13 +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
ae4556584f [FEAT] 銷售紀錄流水號顯示剝除機台序號前綴 
1. 新增 HasDisplayFlowId trait,提供 display_flow_id accessor:僅顯示時剝除 flow_id 開頭的機台序號前綴,DB 仍存完整 serial+flow_id 唯一值供去重/冪等/對帳判斷。
2. Order 與 Invoice 兩 Model 套用此 trait。
3. 訂單詳情面板 (order-detail-panel) 與發票匯出 (SalesController) 改顯示 display_flow_id,呈現乾淨易讀的機台流水號。
4. accessor 具防禦性:機台關聯為 null 或舊的未前綴資料皆原樣顯示,不誤剝。
5. 新增測試驗證 display_flow_id 正確剝除序號前綴且 DB 值維持完整。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-19 09:16:13 +08:00
sky121113
b7e8401a99 [FIX] 銷售紀錄未付款單顯示:已棄單改未支付、未出貨顯示 -- 
1. 付款狀態「已棄單(abandoned)」顯示文字改為「未支付」；新增 Unpaid 語系、移除孤兒 Abandoned key，三語系(zh_TW/en/ja)對齊排序。
2. 出貨狀態:非付款成功(未完成 pending／支付失敗 failed／未支付 abandoned)的單從未出貨，一律顯示「--」，避免 delivery_status 欄位 DB 預設值 1 誤顯示為「出貨成功」。
3. 判斷邏輯收斂至 Order::hasDeliveryOutcome()，桌機表格、手機卡片、明細面板與匯出 delivery_status_label accessor 共用同一基準。
4. 補齊匯出訂單狀態對照表原本缺漏的 failed/abandoned 標籤。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 17:14:29 +08: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
fd954c80a0 [FEAT] 刷卡機狀態顯示限基礎版啟用機台，並加機台日誌查詢索引 
1. Machine 新增 show_card_terminal 取值器：僅 shopping_mode=basic 且 card_terminal_enabled 的機台才呈現刷卡機燈號與日誌分頁（購物車模式或未啟用刷卡機者隱藏）。
2. 機台列表頁：刷卡機狀態燈號與「刷卡機日誌」分頁改以 show_card_terminal 控制顯示；openLogPanel 多帶 cardTerminalEnabled 參數，分頁不可見時自動退回機台狀態分頁。
3. 列表狀態欄文案調整：欄位標頭由「Sub-machine Status」改為「Hardware Status」，下位機燈號標籤改顯示「Sub-machine」，與新增的刷卡機燈號並列更清楚。
4. 新增 migration：machine_logs 加複合索引 (machine_id, type, is_resolved, level)，加速列表頁逐台的狀態未解決日誌查詢（正式環境資料量大，建議離峰執行）。
5. CardTerminalStatusTest 新增 show_card_terminal 顯示條件測試（基礎版啟用才顯示、未啟用或非基礎版皆不顯示）。
6. 新增三語系 key（Hardware Status、Sub-machine），zh_TW/en/ja 對齊並 ksort 排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 13:44:22 +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
69a1d02fc7 [FIX] 電子發票列印限縮為僅統編發票，避免載具/捐贈列印失敗 
1. 釐清綠界規則：InvoicePrint 僅能列印開立時 Print=1 的發票；本系統開立邏輯為「有統編才 Print=1」，故載具、捐贈、一般無統編 B2C 皆 Print=0，列印會回「取得發票列印網址失敗」。
2. 後端 printInvoice() 守衛改為檢查 metadata['business_tax_id']，非統編發票直接回「Only invoices with a tax ID can be printed」，取代原本僅擋捐贈(love_code)的舊邏輯。
3. 訂單詳情面板列印鈕顯示條件改為 business_tax_id 有值才顯示，非統編發票改顯示「此發票無可列印紙本」。
4. 新增三語系 key（Only invoices with a tax ID can be printed、This invoice has no printable copy），zh_TW/en/ja 對齊排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 11:41:26 +08:00
sky121113
4766ec6939 [FEAT] 電子發票作廢權限控管、交易訂單與發票備註、作廢發票差異顯示 
1. 發票作廢改為僅限平台系統管理員：voidInvoice() 加 isSystemAdmin() 403 守衛，訂單詳情面板與 tab-invoices 手機卡片作廢按鈕同步加 isSystemAdmin 顯示條件（列印鈕維持所有人可用）。
2. 新增 orders、invoices 各自獨立的 remark 欄位（migration + Model fillable），供管理者編輯內部備註。
3. 新增 updateOrderRemark / updateInvoiceRemark 端點與 PATCH 路由，AJAX 回傳 JSON、租戶隔離沿用 TenantScoped。
4. 訂單詳情面板加入訂單與發票備註的 Alpine 內嵌編輯（fetch + toast，不重整頁面），所有可進銷售中心者皆可編輯。
5. confirm-modal 加可選 slot；作廢確認視窗加備註輸入框，submitInvoiceAction() 送出前注入隱藏 remark，寫入 invoice.remark（不影響送綠界的 void_reason）。
6. 訂單列表（桌面與手機）已作廢發票改以灰色刪除線加「已作廢」標記顯示，index eager load 補載 invoice.status。
7. 新增 5 組三語系 key（Voided、Enter remark (optional)、Remark updated、No remark、Only system administrators can void invoices），zh_TW/en/ja 對齊排序至 2572 鍵。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 10:48:04 +08:00
sky121113
bfaf0e7317 [FIX] OTA 更新進度 ACK 不應視為指令終態 
1. ProcessCommandAck 新增 OTA 例外處理：當 command_type 為 update_app 且 result 為 "progress" 時，視為過程回報而非終態。
2. 進度訊息（如「Downloading 45%」「Installing...」）僅寫入 note 供後台檢視，指令維持 pending 狀態。
3. 避免 APK 下載/安裝長時程作業在「剛開始下載」即被誤標為完成，與機台實際版本不符。
4. 保留等待最終 success/failed ACK 的判定流程，並補上對應的 Log 記錄。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 19:59:15 +08:00
sky121113
63219a31fb [FIX] 遠端管理歷史紀錄套用機台授權過濾，修復租戶帳號 500 
1. RemoteController index() 與 stock() 的歷史查詢加上 whereHas('machine')，透過 Machine 的 machine_access 全域作用域，使租戶僅能看到自己被授權機台的指令／補貨紀錄；系統管理員不受限制仍可看全部，符合 RBAC 機台以帳號授權原則。
2. 修復根因：先前重構將 Blade 改為對 machine 關聯直接呼叫 only()，租戶遇到未授權機台時 machine 為 null 導致整頁 500。
3. tab-history 與 tab-history-index 三處 $item->machine->only() 改為 null-safe（?->...?? null）作為防禦，避免未來其他查詢路徑漏過濾再次崩潰。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 11:15: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
f1115825b2 [REFACTOR] 商品匯入改為全背景處理避免請求逾時 
1. 新增 ProcessProductImportJob：背景一條龍處理解壓圖片、匯入商品（含圖片轉 WebP 入庫）、重建目錄快取、寫入結果摘要日誌並清除暫存。
2. ProductController::import 改為僅存檔（xlsx／圖片 zip）後派發背景 Job 並立即回應 202，避免大批匯入受 Cloudflare 100 秒等請求逾時限制。
3. 移除 AttachProductImagesJob，邏輯折入單一 ProcessProductImportJob。
4. 匯入 Modal 改為提示「已排入背景處理，完成後重新整理列表查看」，匯入結果改寫入操作日誌查詢。
5. 三語系新增背景處理提示文案並對齊排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 13:58:13 +08:00
sky121113
5875fe380e [FIX] 銷售掃碼支付方式細分與訂單詳情發票操作調整 
1. AnalysisController 與 Order 將付款方式 3 由「掃碼支付」細分為「掃碼支付-玉山」，並新增 11「掃碼支付-TayPay」。
2. 訂單詳情面板（order-detail-panel）發票操作按鈕（列印／作廢／勾稽／補開）改為一致的圖示按鈕樣式，並補上捐贈發票不可列印提示。
3. 銷售列表（sales/index）與發票分頁（tab-invoices）配合調整顯示。
4. 三語系新增 QR Code Payment - E.SUN／TayPay 文案並對齊排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 13:41:51 +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
02e4e99308 [FIX] 捐贈發票排除列印並補上不可列印提示 
1. 訂單詳情發票區塊：新增可列印判斷（love_code 為空才可列印），捐贈發票不顯示列印按鈕，改顯示「捐贈發票無法列印」提示。
2. SalesController::printInvoice() 加入後端守衛，捐贈發票直接回傳明確錯誤訊息，防偽造 POST 呼叫綠界 InvoicePrint 取得查無資料。
3. 三語系新增 key「Donation invoices cannot be printed」，完成 zh_TW/en/ja 對齊排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 11:41:17 +08:00
sky121113
e81756833c [FEAT] 綠界電子發票設定整組選填一旦啟用即全欄必填 
1. PaymentConfigController 的 store/update 新增 ecpay_invoice 群組條件式驗證：四欄全空時整組選填，只要填寫任一欄（store_id/hash_key/hash_iv/email）即透過 required_with 強制其餘全部必填。
2. email 欄位加上格式驗證，從源頭避免空值導致綠界開立失敗（綠界規定 CustomerPhone 與 CustomerEmail 至少擇一，本系統 email 為唯一來源）。
3. 新增三語系驗證訊息與表單提示 key（zh_TW/en/ja），維持字母排序與斜線不逸出。
4. create/edit 表單加入動態必填提示：填入任一欄時 label 顯示紅色星號，並於各欄下方顯示 @error 驗證訊息。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 10:30:06 +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
3d35218d6b [FEAT] 新增手機支付與 LINE Pay 官方直連支付類型 
1. Order.php getPaymentTypeLabels() 新增支付碼 10（手機支付/NFC 行動支付，走信用卡軌道）與 70（LINE Pay 官方直連，非 TapPay 底下的 30）。
2. config/api-docs.php B600 order.payment_type 說明字串補上 10 與 70 兩碼定義。
3. api-technical-specs SKILL.md Appendix A 支付類型對照表同步補上 10、70，並將 30 備註明確為「TapPay 底下的 LINE Pay」以區分兩條 LINE Pay 路線。
4. 三語系 (zh_TW/en/ja) 新增 "Mobile Pay"、"LINE Pay (Official)" 詞條，並重新 ksort 對齊字母排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 13:55:08 +08:00
sky121113
9511ebe71f [FEAT] 商品詳情支援多行排版並原樣下發 APP 
1. 多語系輸入元件 product-locale-tabs 新增 multiline 參數，啟用時改用 textarea（保留換行、可垂直拖曳），名稱欄位維持單行 input。
2. 商品新增/編輯頁的「詳情」欄位改為多行輸入。
3. ProductController store/update 將 specs.* 與 spec 驗證上限由 255 放寬至 2000。
4. 新增 migration 將 products.spec 由 VARCHAR(255) 改為 TEXT，避免較長 zh_TW 詳情被截斷（translations.value 本即 TEXT）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 11:42:06 +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
231cff9574 [FEAT] 新增 B016 機台系統設定回寫端點與文件 
1. MachineController 新增 updateSettings (B016)：機台主控台系統設定由系統方編輯後回寫雲端，僅系統管理員可操作，白名單布林開關合併進 machines.settings JSON 與 is_spring_slot_* 實體欄位，記錄 updater_id
2. routes/api.php 新增 PATCH /api/app/machine/setting/B016 路由，採 auth:sanctum (B000 User Token) 與 throttle:60,1
3. api-technical-specs SKILL.md 新增 §3.8 B016 規格：認證、白名單鍵、403/404/422 錯誤碼，並標注與 B014 下載的 PascalCase 命名方向不對稱
4. config/api-docs.php 新增 B016 條目，對齊既有 entry 格式

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-11 11:21:17 +08:00
sky121113
339b33d09b [FEAT] B000 登入回應新增 identity 身分欄位 
1. MachineAuthController loginB000 於 RBAC 判斷時記錄登入者身分,成功回應加入 identity 欄位 (system/company/staff)
2. 未授權與帳密錯誤回應維持不含 identity,避免洩漏身分
3. 同步更新 api-technical-specs SKILL.md 與 config/api-docs.php 回應參數文件
4. 新增 MachineAuthB000Test 涵蓋三身分成功與 401/403 失敗共 5 案例

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 10:09:44 +08:00
sky121113
ed79a6ab32 [FEAT] 金流配置與機台系統設定整合進 B014，補完機台端設定下發 
1. 金流配置表單語意分組與多語系：綠界發票／玉山掃碼／Line官方支付／Tappay 四區 label 改用無歧義 key 並補齊 en/ja/zh_TW，發票區新增「發票通知 Email」欄位。
2. B014 密鑰讀取對齊金流配置巢狀結構（esun_scan／tappay／ecpay_invoice），發票改讀 payment_configs（不再讀 companies 表），統一以 data_get 安全取值。
3. B014 機台系統設定全面改以機台端 *Set + PascalCase 風格下發：DevSet／CashSet／FunctionSet／ShoppingMode／OperationSet（運作參數）／HardwareSet（硬體與貨道），移除原始 key 雜燴的 MachineSettings 物件。
4. 釐清 LINE Pay 兩條路線：DevLinePay 對應「Line官方支付」官方直連（scan_pay_linepay_enabled）、TapPay30 對應 TapPay 底下 LINE Pay（tappay_linepay）。
5. 機台系統設定 modal 新增「Line官方支付」開關（置於掃碼支付下方），並納入支付方式全選；機台清單「啟用功能」同步顯示。
6. 移除卡片支付子項（悠遊卡／一卡通／icash），卡片支付開啟即視為全支援。
7. 編輯機台頁移除「會員與外部系統」區塊與「發票開立狀態」欄位（會員／來店禮改由機台系統設定管理）。
8. 同步更新 API 文件（api-technical-specs SKILL.md 與 config/api-docs.php），逐項標註回應參數對應來源與機台既有／新定義結構。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-10 13:01:52 +08:00
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
f34a7bf9bc [FIX] 補貨單完成邏輯與機台庫存去耦，防範重複累加 Bug 
1. 移除補貨單狀態進入已完成 (STATUS_COMPLETED) 時自動對機台貨道庫存進行累加的舊邏輯。
2. 移除伴隨上述更新所產生的機台補貨流水帳紀錄 (MachineStockMovement)。
3. 使機台實體庫存回歸以機台端上報 (B009/B018) 及手動貨道校正為唯一事實來源，防範因先上報後結案產生的重複累加及時間差空轉售罄客訴風險。
 2026-06-09 11:11:09 +08:00
sky121113
b6c7142677 [FIX] 修正商品與機台報表因 order_items 與 dispense_records 聯結產生笛卡爾積導致件數重複加總的問題 2026-06-05 21:56:41 +08:00
sky121113
e29a01f611 [FIX] 修正機台報表因 joinSub 漏掉無付費營業額機台出貨數量的問題 2026-06-05 21:50:23 +08:00
sky121113
6173851920 [FEAT] 重構商品與機台報表統計邏輯，對齊實際出貨成功件數 2026-06-05 17:34:55 +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
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