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

65 Commits

Author SHA1 Message Date
twsystem1004
83e1beb7e2 feat(倉庫/銷售): 機台貨道明細匯出 + 出貨失敗補償取貨碼 
1. 倉庫→機台庫存概覽：點進機台後，矩陣/表格視圖旁加「匯出」下拉(CSV/Excel)，
   內容為該機台每個貨道明細(貨道號/商品/庫存/容量/庫存率/效期/批號等)。
2. 銷售紀錄新增「取貨碼」欄位：對「付款成功但出貨失敗/部分」的單顯示「+」，
   點擊確認「是否產生取貨碼(七天內有效)」後，依缺量產生取貨碼(綁機台+商品、
   usage_limit=缺量、冪等 batch_no=COMP{id}、不設 order_id)，顯示碼+「待使用」。
   消費者於機台輸入碼走現成 B660 核銷出貨，app 端不需改。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-13 08:00:50 +00:00
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
terrylee
ce9e52efd9 fix(sales): 批次下載 CSV 連結加 download 屬性，避免觸發全域導航遮罩卡住畫面 
全域連結攔截器(layouts/admin)點 <a href> 會顯示導航載入遮罩，但檔案下載不換頁、
遮罩不會關閉，導致畫面卡在模糊+進度條停在~95%。加 download 屬性即可被攔截器豁免。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 15:27:38 +08:00
terrylee
d4d61461fe fix(pickup): 取貨碼商品下拉 placeholder 改「選擇商品」+ 公開取貨頁正確顯示綁定商品 
1. 取貨碼新增彈窗的商品下拉沿用了貨道設定的 placeholder（顯示「選擇貨道」），
   改為「選擇商品」並補 Search Product... 多語系。
2. 公開取貨憑證頁（/p/{slug}）原本只用 slot_no 對應商品，綁商品的碼 slot_no 為
   null 導致顯示「未知商品」；改為優先用 product_id 綁定的商品，貨道欄無值顯示「—」。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 15:18:40 +08:00
terrylee
179348ad66 feat(sales): 批次產碼數量上限依角色分級（客戶端最多20、管理員最多1000） 
- 平台管理員(isSystemAdmin)：數量上限 1000，快捷 10/50/100/1000
- 客戶端(租戶)：數量上限 20，快捷 10/20，欄位輸入超過自動夾回 20
- 後端 store 以角色動態 max 驗證，防止前端被繞過送出大量產碼
- 取貨碼/通行碼兩表單同步；前端 max 與快捷選項由後端依角色下發

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 14:24:47 +08:00
terrylee
9dbde50f56 fix(sales): 取貨碼新增彈窗「產生數量」改為獨立整列，避免與使用次數上限重疊 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 14:10:13 +08:00
terrylee
6bb08a13ce feat(sales): 取貨碼/通行碼批次新增（最多1000筆）+ 批次清單 CSV 下載 
- 取貨碼沿用「商品版」綁定（product_id，相容舊 slot_no）批次產碼
- 通行碼批次產碼；名稱自動加 #1..#N 流水
- 新增 batch_no 欄位標記同一批，提供批次下載路由與 UTF-8 BOM CSV
- 數量>1 時忽略自訂碼、系統產生不重複隨機碼；單筆行為不變
- 產生後顯示可重複下載清單橫幅；新增 zh_TW/en/ja 翻譯鍵

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-29 14:00:57 +08:00
sky121113
2dd14fd1b4 [FIX] 取貨碼列表改以商品為主、綁商品碼不再顯示空貨道 
1. pickupCodes 查詢補 product eager load，避免 N+1。
2. 列表商品欄改依綁定型態顯示：綁商品碼直接顯示商品名且不顯示貨道；綁貨道碼（舊）維持反查商品名並保留貨道號。
3. 桌面表格標題「商品 / 貨道」改為「商品」，手機卡片同步調整。
 2026-06-26 17:42:21 +08:00
sky121113
0c29cdae97 [FEAT] 取貨碼改綁「商品」而非「貨道」 
1. 新增 migration 為 pickup_codes 增加 product_id 欄位（nullable + index），既有綁貨道碼向後相容。
2. PickupCode Model 補上 product_id fillable 與 product() 關聯。
3. 產碼 storePickupCode 改收 product_id（與 slot_no 二擇一，required_without），並驗證商品屬於機台所屬公司；機台未上架仍可產碼。
4. 新增 pickupCompanyProducts AJAX 端點與路由，回傳公司商品清單與機台已上架 product_id，供前端標示「此機台未上架」提示。
5. B660 刷碼驗證新增綁商品擋關：機台無此商品貨道時回 409 並寫 PickupCodeLog；回傳資料補上 product_id 供 App 自挑貨道。
6. 產碼介面（pickup-codes/index）由「選擇貨道」改為「選擇商品」，加入未上架警告提示。
7. 多語系同步新增 4 組詞彙（zh_TW/en/ja 對齊排序）。
 2026-06-26 17:31:22 +08: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
sky121113
16a8ee7986 [FEAT] 合併機台日誌層級篩選與銷售紀錄付款/出貨狀態篩選 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 17:07:05 +08:00
sky121113
f571f99084 [FEAT] 機台日誌層級篩選與銷售紀錄付款/出貨狀態篩選 
1. 機台日誌新增「層級」篩選下拉（所有層級/Info/Warning/Error），採 x-searchable-select 元件，選擇即時重撈，清除篩選一併重置
2. 銷售紀錄訂單分頁新增「付款狀態」篩選（對應 status 欄）
3. 銷售紀錄訂單分頁新增「出貨狀態」篩選（delivery_status），比照列表顯示邏輯限定 completed/paid 訂單，避免未出貨單因預設值誤篩
4. 補齊三語系 key：All Payment Statuses、All Dispense Statuses、Paid，並對齊排序

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 17:05:45 +08:00
sky121113
7044d4cefd [FIX] 合併取貨碼/通行碼/來店禮租戶機台授權修復 2026-06-24 15:40:33 +08:00
sky121113
38f5071975 [FIX] 取貨碼/通行碼/來店禮：客戶帳號跨未授權機台導致頁面崩潰與越權 
1. 列表與操作紀錄查詢加上 whereHas('machine')，依 machine_user 授權過濾，客戶帳號只看得到可存取機台的資料（系統管理員不受影響）
2. pickup_code_logs.machine_id 可為 null，該紀錄查詢改為「machine_id 為 null 或機台可存取」以保留非機台紀錄
3. destroyPickupCode/destroyPassCode/destroyWelcomeGift 加上機台授權守衛，非系統管理員越權刪除回傳 403
4. tab-list blade 將 $x->machine->name 等改為 null-safe，作為縱深防禦

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 15:39:41 +08:00
twsystem1004
f8c6da3acc [FIX] 領藥單建立頁批價單號欄位攔截 Enter 
1. 批價單號 input 加上 @keydown.enter.prevent，避免掃碼器掃完批價單 QR 後自動送出的 Enter 誤觸「建立並產生 QR」、跳出「請至少勾選一項藥品並填寫數量」提示。
2. 單號仍正常自動帶入，攔截僅作用於此欄位，不影響其他欄位與按鈕送出。
 2026-06-24 03:11:19 +00: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
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
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
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
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
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
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
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
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
da11241f72 sales: localize pickup recipient wording for payment_type 42 2026-05-28 16:14:02 +08:00
sky121113
7d8b342a85 sales: unify pickup recipient wording for payment_type 42 2026-05-28 16:08:35 +08:00
sky121113
ea8c277ee9 sales: show member_barcode for payment_type 42 in records UI 2026-05-28 15:54:53 +08:00
sky121113
47b553ae8c [FIX] 修正來店禮使用紀錄頁面中難以辨識的怪異禮物盒圖標 
1. 修正 resources/views/admin/sales/welcome-gifts/partials/tab-logs.blade.php 的桌面表格、無資料狀態、手機卡片中的來店禮圖示，全面替換為標準且極具質感的 Gift 禮物盒圖標。
 2026-05-22 15:30:24 +08:00
sky121113
5c970f4134 [FIX] 修正通行碼與來店禮主列表搜尋放大鏡與來店禮手機卡片圖示 
1. 修正 resources/views/admin/sales/pass-codes/partials/tab-list.blade.php 的搜尋框放大鏡 SVG 圖示，使其完美置中不被裁切。
2. 修正 resources/views/admin/sales/welcome-gifts/partials/tab-list.blade.php 的搜尋框放大鏡 SVG 圖示。
3. 替換 resources/views/admin/sales/welcome-gifts/partials/tab-list.blade.php 手機版卡片中的來店禮圖示為標準且高辨識度的 Gift 禮物盒圖標，提升 UI 質感與一致性。
 2026-05-22 15:29:56 +08:00
sky121113
145c515292 [FIX] 修正行銷使用紀錄搜尋框放大鏡 SVG 參數，並更換來店禮圖示以提升辨識度 
1. 修正「來店禮」、「通行碼」與「取貨碼」使用紀錄搜尋框內 SVG 放大鏡缺少 y1="21" 導致圖示被截斷且偏左上角的顯示 Bug。
2. 汰換來店禮使用紀錄（Logs 表格與卡片）中原先難以辨識且怪異的圓圈十字圖示，更換為精緻高辨識度的標準 Heroicons Gift 禮物盒圖示。
 2026-05-22 15:28:23 +08:00
sky121113
9b439814bd [STYLE] 優化行銷促銷模組視覺體驗、語系對齊與修復下拉選單重置 Bug 
1. 簡化「來店禮」於繁中與日文語系檔的顯示文字，避免後台介面過長擠壓。
2. 修復來店禮、通行碼、取貨碼列表重置按鈕之時序競態 Bug，確保下拉選單確實清空後方送出 Ajax。
3. 來店禮與通行碼使用紀錄的類型選單新增 OnChange 自動 AJAX 提交，提升篩選操作體驗。
4. 補齊取貨碼使用紀錄的狀態篩選選單，並支援重置按鈕一鍵清空。
5. 移除通行碼與取貨碼使用紀錄中的「操作人員」欄位，配合極簡奢華風微調時間欄位靠右對齊，並修正表格空狀態的 colspan 為 5。
 2026-05-22 15:20:19 +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
1678fd1775 [FIX] 修正銷售紀錄與出貨紀錄 Flatpickr 初始化中 Blade 大括號內不必要的反斜線轉義以防 PHP 解析錯誤 2026-05-20 14:19:32 +08:00
sky121113
775d7bc967 fix(views): 全站 Flatpickr 日期時間選擇器在行動端統一啟用 disableMobile 確保 24 小時制與極簡奢華風 UI 一致 2026-05-20 13:02:34 +08:00
sky121113
be127bab76 [FIX] 修復行動端時間篩選器強制轉為 12 小時制的問題 
1. 修正取貨碼使用紀錄篩選器 (tab-logs.blade.php)：為 Flatpickr 開始/結束時間初始化配置補上 disableMobile: true，避免手機系統 12 小時制覆蓋。
2. 修正遠端指令歷史紀錄篩選器 (tab-history-index.blade.php)：為 Flatpickr 起迄時間初始化配置補上 disableMobile: true，防止行動端原生選擇器轉換。
3. 修正遠端庫存操作紀錄篩選器 (tab-history.blade.php)：為 Flatpickr 起迄時間初始化配置補上 disableMobile: true，確保與電腦版一致維持 24 小時制顯示。
 2026-05-20 11:52:14 +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
1aa5aed72e feat(sales): 升級銷售紀錄高奢翡翠綠導出下拉選單與修復進度條卡死 2026-05-19 12:33:06 +08:00
sky121113
6cddc5b1b8 [STYLE] 簡化銷售紀錄搜尋框提示詞，優化版面潔淨度 
1. 修改 tab-orders.blade.php，將搜尋提示詞簡化為「Search Order No / Cards & Codes...」，移除冗長且非核心的流水號與發票提示。
2. 更新 zh_TW.json 翻譯，對應為「搜尋 訂單號 / 卡號與代碼...」，兼顧未來的通行碼與取貨碼擴充性。
 2026-05-19 11:03:47 +08:00
sky121113
d9423a3fb1 [STYLE] 更新銷售紀錄搜尋框提示詞，支援員工資訊提示 
1. 修改 tab-orders.blade.php，將搜尋框提示詞更新為「Search Order No / Flow ID / Invoice / Staff Info...」。
2. 更新 zh_TW.json 翻譯，對應為「搜尋 訂單號 / 流水號 / 發票號碼 / 員工資訊...」。
 2026-05-19 11:01:27 +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
cf2c2f6e39 [FIX] 修正通行碼載入失敗問題，並標準化所有單據模組的日期篩選器 UI 2026-05-16 23:41:23 +08:00