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

276 Commits

Author SHA1 Message Date
twsystem1004
1d745c5722 feat(商品管理): 新增商品匯出(CSV/Excel) 
資料設定→商品管理新增「匯出」下拉(CSV/Excel)，套用當前篩選(搜尋/分類/公司)，
欄位順序對齊匯入範本方便回匯入。匯入鈕與匯出下拉移至查詢/重設右邊。
匯出連結加 download 屬性，避免觸發全域導覽遮罩導致下載後畫面卡霧面。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-10 02:04:11 +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
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
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
5e0bfeb544 [FIX] 銷售紀錄機台權限隔離：訂單/發票/出貨清單依使用者可存取機台過濾 
1. SalesController index 先前 orders/invoices/dispense 查詢只靠 TenantScoped 做 company 隔離，未依機台授權過濾；導致無該機台權限的子帳號仍能看到其交易訂單（機台名稱因 machine_access scope 顯示 unknown，但訂單仍列出）
2. 修正：非系統管理員時，三個查詢一律限制 machine_id 在「可存取機台集合」（沿用 Machine 的 machine_access 全域 scope，與機台下拉清單一致）；export 共用同一 query 亦一併涵蓋
3. 新增 SalesMachineAccessTest（3 案，Admin 套件 58 測試 0 回歸）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 20:03:57 +08:00
sky121113
146dac4493 [PROMOTE] dev -> demo: 帳號與角色多層級隔離 + 機台日誌/銷售篩選 
1. 帳號與角色多層級隔離：主/子帳號樹狀 (parent_id/level)、主帳號唯一性 (is_admin 補位/禁刪最後主帳號)、角色權限與機台授權子集把關、角色層級隔離 (created_by)。含 3 支 migration（is_company_admin / parent_id+level / created_by，皆具 backfill，部署後須跑 migrate）
2. 機台日誌層級篩選 + 銷售紀錄付款/出貨狀態篩選 + TransactionService 金額修正

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 17:11:31 +08:00
sky121113
697c52eba3 [FEAT] 合併帳號與角色多層級隔離 (feat/account-hierarchy-rbac) 
主/子帳號樹狀層級、角色權限與機台授權子集把關、角色層級隔離。
詳見 feature 分支 commit 2016637。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 17:04:40 +08:00
sky121113
201663741d [FEAT] 帳號與角色多層級隔離（主/子帳號樹狀 + 角色權限/機台授權子集把關） 
1. 主帳號不變量：storeAccount 的 is_admin 改補位（每家公司恰一主帳號）、destroyAccount 禁刪最後主帳號、roles 新增 is_company_admin 旗標保護公司管理員角色不被刪除
2. 帳號樹狀層級：users 新增 parent_id/level（主帳號 level 0、子帳號最多兩層），新增 visibleTo/canManageAccount，帳號清單與管理端點（accounts/update/destroy/toggle、機台授權選帳號、補貨指派）一律套層級可見範圍與越權防護
3. 角色指派子集：storeAccount/updateAccount 指派角色與帳號 Modal 下拉一律限制為「權限為操作者子集」，杜絕權限提升
4. 機台授權子集：MachinePermissionController 僅允許在操作者本身可授權機台範圍內增刪，保留範圍外既有授權，並修正 machine_access 全域 scope 對讀寫的干擾
5. 角色層級隔離：roles 新增 created_by，子帳號只看/只管/只能指派自己建立的角色（主帳號看全公司），edit/update/destroy 加 canBeManagedBy 守衛
6. 補強：MachineSetting 機台權限人員清單補租戶隔離、修正角色下拉 N+1、三語系新增提示字串
7. 測試：新增 AccountHierarchyTest/AccountSubsetGuardTest/RoleHierarchyTest，Admin 套件 55 測試 0 回歸

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 17:03:43 +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
twsystem1004
7ba6d9ebe6 [FEAT] 副櫃系統(格子櫃功能)授權開關 
機台設定-基礎版新增「副櫃系統/格子櫃功能」開關，存 settings.subcabinet_enabled(僅basic)；B014 FunctionSet 新增 Subcabinet 下發給 app 控制副櫃分頁/鎖控板設定顯示；啟用功能摘要列出副櫃系統。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-25 08:11:36 +00: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
06d68a2783 [FEAT] 合併機台日誌層級篩選與銷售紀錄付款/出貨狀態篩選 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 17:06:42 +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
de2f098309 [FIX] 取貨碼無法刪除：status 未列入 fillable 導致取消無效 
1. PickupCode $fillable 補上 status，原本 destroyPickupCode 的 update(['status'=>'cancelled']) 因 mass-assignment 保護被靜默忽略，導致取貨碼按刪除（取消）後狀態不變、永遠刪不掉（超級管理員亦然）
2. PassCode/WelcomeGift 的 fillable 本就含 status 不受影響，故僅取貨碼有此問題

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 16:03:01 +08:00
sky121113
7044d4cefd [FIX] 合併取貨碼/通行碼/來店禮租戶機台授權修復 2026-06-24 15:40:33 +08:00
sky121113
a65f4cd45c [FIX] 合併取貨碼/通行碼/來店禮租戶機台授權修復 2026-06-24 15:40:26 +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
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
twsystem1004
aecb2f17d1 [PROMOTE] dev → demo：領藥單核銷與批價單號掃碼修正晉升驗收 
1. 領藥單核銷流程：改由出貨 finalize 處理，B660 回傳批價單號(pricing_slip_no)。
2. 領藥單建立頁批價單號欄位攔截 Enter，避免掃碼器掃完 QR 自動送出誤觸建立。
 2026-06-24 03:13:24 +00:00
twsystem1004
9a6036d184 [FIX] 領藥單：核銷改由出貨finalize、B660回傳批價單號 
- handlePickupVerify：移除掃碼驗證當下核銷領藥碼(usage_count++/used)，
  改由實際出貨 MQTT finalize 核銷；未取貨(逾時/取消)時領藥碼維持 active 可再掃，
  修正「掃了未確定取貨、再掃顯示已領」問題。
- B660 回應新增 pricing_slip_no(批價單號)，供機台確認領藥畫面備註欄顯示。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 03:11:19 +00: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
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
0da3887aa6 [FIX] backport 至 dev:補貨單歸屬改以機台所綁公司為準 2026-06-23 15:34:22 +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
5a501eb199 [FIX] backport 至 dev:遠端強制重啟 APP 指令 2026-06-23 14:13:56 +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