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

289 Commits

Author SHA1 Message Date
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
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
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
840052dd5a [STYLE] 銷售中心與 admin header 手機版響應式調整 
1. 銷售中心三個 Tab 容器圓角與內距改為行動優先（rounded-2xl sm:rounded-3xl、p-4 sm:p-6 lg:p-8）。
2. 訂單/發票/出貨三個列表的搜尋欄寬度改為手機滿版、桌面才套 min-w-[280px]（w-full min-w-0 lg:min-w-[280px]）。
3. admin layout：body 加 overflow-x-clip 防止水平溢出；行動版品牌字在窄螢幕隱藏、自動刷新與 logo 區塊調整間距與 shrink-0 避免擠壓。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 11:41:37 +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
ae4c9fb93a [FEAT] 交易訂單與電子發票列表新增可編輯備註欄位 
1. 新增共用元件 x-remark-cell：列表內嵌備註編輯，點擊文字進入編輯，儲存走 AJAX PATCH 並以 toast 提示，不重整頁面；空白時顯示淡色「新增備註」提示。
2. 交易訂單列表（tab-orders）桌面表格於「發票號碼」與「操作」間新增備註欄，手機卡片於操作鈕上方新增備註區塊，接 order.remark，並同步調整空狀態 colspan。
3. 電子發票列表（tab-invoices）桌面表格於「關聯訂單」與「操作」間新增備註欄，手機卡片新增備註區塊，接 invoice.remark，並同步調整空狀態 colspan。
4. 列表與訂單詳情面板共用同一 remark 欄位，任一處編輯皆同步。
5. 新增三語系 key「Add Remark（新增備註）」，zh_TW/en/ja 對齊排序至 2573 鍵。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-18 11:13:41 +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
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
7a90e8c6de [STYLE] 發票操作按鈕配置調整與作廢確認框改用自製 UI 
1. 發票列表「操作」欄：查詢、補開改為 icon 按鈕呈現，與檢視 icon 風格一致；補開改用自製確認框 UI（取代瀏覽器原生 confirm）。
2. 訂單詳情發票區塊：列印、作廢維持文字按鈕樣式（不改 icon）；作廢改接自製確認框 UI，捐贈發票維持隱藏列印並顯示提示。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 14:32:43 +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
07e8a6887c [FIX] 補齊銷售紀錄訂單狀態多語系並調整電子票證顯示 
1. 修正 resources/views/admin/sales/partials/tab-orders.blade.php：兩處 statusMap 補上 failed、abandoned 狀態（含 __() 多語系與徽章配色），解決訂單狀態改版後 failed/abandoned 顯示原始英文字串、未經多語系處理的問題。
2. 修正 resources/views/admin/sales/partials/order-detail-panel.blade.php：statusMap 與 labelMap 同步補上 failed、abandoned 狀態對應。
3. 更新 lang/zh_TW.json、en.json、ja.json：新增 Abandoned（已棄單 / Abandoned / 放棄済み）；依需求將 E-Ticket (EasyCard/iPass) 的繁中顯示由「電子票證 (悠遊卡/一卡通)」改為「電子票證」；並清除 zh_TW.json 重複且無效的 Pending key，三語系完成對齊與字母排序。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 09:41:46 +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
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
7f700df418 [STYLE] 商品多語系欄位標題由「規格」改為「詳情」 
1. 商品建立/編輯頁多語系區塊標題改用 key Details (Multilingual)，顯示為「詳情（多語系）」。
2. 三語系 JSON 以 Details (Multilingual) 取代 Specification (Multilingual)（zh_TW=詳情（多語系）/ en=Details (Multilingual) / ja=詳細（多言語）），維持字母排序與三語對齊。
3. 底層欄位 spec 與 B012 t060v03 不變，僅調整前台顯示標籤。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-15 10:22:20 +08:00
sky121113
a6caf0ded5 [STYLE] 調整顯示語系選中態為淡 cyan 強調 
1. 機台系統設定彈窗「顯示語系」勾選按鈕：選中態由整顆深底反白 (bg-slate-900/dark:bg-white) 改為淡 cyan 強調 (bg-cyan-500/10 + border-cyan-500/40 + text-cyan-600/dark:text-cyan-300)，降低對比、與 toggle 開關同一 cyan 語彙。
2. 商品名稱/規格多語系 Tab 元件 (product-locale-tabs)：選中態比照改為相同淡 cyan 強調。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-15 09:24:30 +08:00
sky121113
1f1eb7714e [FIX] 修正多語系升級導致既有環境商品編輯器只剩繁中 Tab 
1. 新增回填 migration：將既有機台 settings.languages 補為 ["zh_TW","en","ja"]（僅補缺鍵/空值者，已設定者不動，以 DB 更新避免觸發機台事件），使 demo/prod 升級後公司語系聯集維持中英日、商品編輯器照常顯示三 Tab。
2. 商品編輯頁加保險：語系 Tab = 公司機台語系聯集 ∪「此商品已有翻譯的語系」，並依白名單排序，避免日後公司聯集縮減時藏掉既有翻譯而無法編輯。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-15 09:07:41 +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
a5e5390cd1 [DOCS] 補齊 B690 來店禮驗證的錯誤回應文件 
1. SKILL.md B690 章節新增 400 (格式錯誤) 與 429 (已鎖定) 兩種錯誤回應表格，與 verifyWelcomeGift 實際回傳一致。
2. config/api-docs.php B690 條目新增 error_responses 陣列，列出 400 / 404 / 429 錯誤碼與訊息。
3. api-docs.blade.php 新增通用「錯誤回應 (Error Responses)」渲染區塊，其他端點可沿用 error_responses 欄位。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 15:00:50 +08:00
sky121113
6ca3fa8a6b [FIX] 修正取貨碼有效期限固定為 24 小時的問題 
1. 建立取貨碼時，隱藏的「自訂日期」欄位會被預填為明天並隨表單送出，導致後端 expires_at 永遠為 filled，固定套用約 24 小時。
2. 時數模式時 disabled 掉 expires_at 欄位，自訂日期模式時 disabled 掉 expires_hours 欄位，使停用欄位不被提交。
3. 修正後時數滑桿與自訂日期可各自正確生效，取貨碼有效期限依使用者設定產生。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 14:28:03 +08:00
sky121113
2b25c5bebf [FIX] 修正商品分類頁多餘 </div> 導致 Alpine 範圍崩壞 
1. 移除 tab-categories.blade.php 手機版卡片區塊多出的一個 </div>（原本 20 個 <div 卻有 21 個 </div>）。
2. 該多餘結束標籤在 @forelse 迴圈內提前關閉外層容器，連鎖將整個 x-data="productManager" 元件 div 提前關閉。
3. 修正後操作紀錄 (logs) tab、編輯分類 modal (openCategoryModal)、匯入 modal (isImportModalOpen) 重新回到 Alpine 元件範圍內，消除 activeTab/tabLoading/isImportModalOpen is not defined 等錯誤。
4. 後端邏輯未變動，原本操作紀錄已正常寫入資料庫，僅前端因範圍崩壞無法切換 tab 與開啟編輯。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-10 16:11:27 +08:00
sky121113
378332be25 [FEAT] APK 機台風味欄位改為自由輸入並補驗證與三語系 
1. APK 版本建立頁「機台風味」欄位由固定下拉選單 (x-searchable-select) 改為自由輸入 text input，搭配 datalist 提供常用 flavor 建議值，允許填入任意 flavor。
2. 表單送出新增 flavor 必填驗證，未填時跳出 toast 提示。
3. APK 檔名自動解析填入邏輯改為直接寫入 x-model flavor，移除原 Preline HSSelect 實例操作。
4. 新增多語系 key「Please enter machine flavor」並同步 zh_TW / en / ja。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-10 14:10:36 +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
722993a078 [FIX] 訪客取貨/通行頁 QR Code 改用公開路由，修正手機開啟失效 
1. 新增公開路由 qr-code.public（throttle:120,1），不需管理員登入即可產生 QR 圖片，供訪客頁渲染使用。
2. qr-code Blade 元件 dynamic=false 分支改指向 qr-code.public，原本指向需登入的 admin.basic-settings.qr-code，導致手機開連結時因無 session 被導向登入頁、圖片失效。
3. 後台列表頁（dynamic=true，登入狀態）維持原 admin 路由不變。
 2026-06-10 11:15:57 +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
66416b14ed [STYLE] 簡化庫存概覽與庫存效期的商品 ID 標記為 ID 2026-06-05 16:56:48 +08:00
sky121113
eab9b90b88 [STYLE] 統一機台庫存概覽與庫存效期的商品 ID 與效期文字規格 2026-06-05 16:53:27 +08:00
sky121113
d326697417 [STYLE] 統一機台庫存概覽與庫存效期的商品 ID 多語系名稱 
1. 將寫死的「ID:」改為多語系「{{ __('Product ID') }}:」。
2. 修改 zh_TW.json，將 Product ID 的繁體中文翻譯由「商品編號」改為「商品 ID」，與列表上的「效期」在中文語境下完全對齊統一。
 2026-06-05 16:49:16 +08:00
sky121113
6a600bb009 [FEAT] 在機台庫存概覽與庫存效期管理頁面加顯示商品 ID 
1. 修改 resources/views/admin/warehouses/machine-inventory.blade.php，於 Table View、Grid View 和 Mobile Card View 中加顯示商品 ID (ID: {id})。
2. 修改 resources/views/admin/remote/stock.blade.php，於 Table View、Grid View、Mobile Card View 和 Edit Modal 中加顯示商品 ID (ID: {id})。
 2026-06-05 16:36:45 +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
9a59186cd4 [FEAT] 登入頁面新增防止重複提交與載入動畫效果 
1. 於 `resources/views/auth/login.blade.php` 登入表單引入 Alpine.js 狀態管理，新增 `isSubmitting` 控制。
2. 登入按鈕於提交時自動處於 disabled 狀態，避免使用者重複點擊。
3. 於登入按鈕內新增 Spinner 載入動畫與「登入中」文字狀態提示，提升使用者互動體驗。
 2026-06-05 11:56:22 +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
06d93889b3 [FEAT] 依據環境溫度監測啟用狀態動態顯示日誌 Tab 
1. 在 machines/index.blade.php 的 Alpine x-data 中新增 currentMachineAmbientTempEnabled 屬性。
2. 修改 openLogPanel 方法以傳入機台的環境溫度監測啟用狀態。
3. 於機台列表所有呼叫 openLogPanel 處帶入 ambient_temp_monitoring_enabled。
4. 在「環境溫度回傳」Tab 的按鈕上加入 x-show 與 x-cloak，使該 Tab 僅在機台啟用監測時顯示，避免非必要 Tab 的干擾與界面閃爍。
 2026-06-04 13:13:20 +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
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
b1bebf6ae4 [STYLE] 優化 APK 版本列表更新說明顯示與複製功能 
1. 使用 Alpine.js 實作更新說明點擊切換展開/收起功能，方便檢視完整字數。
2. 增加 title 屬性提供 hover tooltip 顯示完整更新說明。
3. 移除 select-none 樣式，允許使用者反白複製更新說明內容。
 2026-06-01 12:01:46 +08:00
sky121113
5db796bf64 [STYLE] 再度提升後台頁面轉場與登場 Loading 微動畫體驗 
1. 優化 components/loading-screen.blade.php：將 loading 狀態設為預設開啟，並利用 requestAnimationFrame 與延遲在 x-init 中自動淡出，實現更流暢的頁面進場登場動畫。
2. 優化 layouts/admin.blade.php：引入 .admin-content-shell 過渡容器與 .admin-page-transitioning 狀態，在點擊跳轉時使主內容漸變為半透明與微模糊，提供 SPA 級別的跳轉微過渡體驗。
3. 重構 layouts/admin.blade.php 跳轉載入命名：將全螢幕載入整合至頁面登場與內容過渡機制，防止重複點擊並解除事件衝突。
 2026-06-01 10:11:08 +08:00
sky121113
610899d898 [STYLE] 優化後台管理系統側邊欄佈局與全局頁面跳轉載入機制 
1. 優化 layouts/admin.blade.php：引入 CSS 變數動態計算側邊欄寬度與內容偏移量，在 <head> 中即時應用，避免 Alpine.js 載入前的排版跳動 (CLS/FOUC)。
2. 重構 layouts/admin.blade.php 的頁面跳轉載入機制：設計 shouldShowPageLoading 嚴謹過濾 Hash 導航、新分頁、Ctrl+點擊、非同源等情境，僅在站內頁面實際跳轉時觸發 Loading。
3. 優化 components/loading-screen.blade.php：改為監聽 show-global-loading 與 hide-global-loading 全局事件，並新增 x-transition 動畫以實現平滑的淡入淡出體驗。
 2026-06-01 09:49:38 +08:00
sky121113
a5ead47874 [FIX] 修正登入密碼輸入框眼睛圖示大小失效問題 
1. 修正 resources/views/auth/login.blade.php 中密碼切換按鈕的 SVG 圖示大小類名。
2. 將無效的 w-4.5 h-4.5 改為 Tailwind CSS 標準的 w-5 h-5，解決圖示尺寸坍塌導致完全隱形看不到眼睛的問題。
 2026-06-01 08:42:46 +08:00
sky121113
d9e9c5e5db [FEAT] 新增 APK 下載連結複製功能與優化相關 UI 
1. 在 APK 版本管理列表新增「複製下載連結」按鈕，並以 Alpine.js 結合 navigator.clipboard 實作複製成功 toast 通知。
2. 同步更新繁中、英文、日文多語系檔，補上複製下載連結相關語彙。
3. 修正 APK 新增頁面中外部連結按鈕 SVG 圖示閉合不全的問題。
 2026-05-29 17:42:44 +08:00
sky121113
23b3ea16ae [FIX] 修正機台管理頁面的表單提交行為與導向邏輯 
1. 將原本一律攔截的 @submit.prevent 改為動態 @submit。
2. 僅在表單使用 GET 方法進行搜尋過濾時，才執行 $event.preventDefault() 並以非同步方式載入頁面，確保 POST/PUT 等非 GET 類型的表單提交能正常運作。
 2026-05-29 16:54:01 +08:00