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

25 Commits

Author SHA1 Message Date
terrylee
8977e7eb0f feat(pharmacy-pickup): 領藥單模組（後台建單→QR→機台B660掃碼→出貨回報） 
- 機台系統設定：取物單模式(pickup_sheet)下新增「領藥單」開關 pharmacy_pickup_enabled，B014 下發 FunctionSet.PharmacyPickup
- 權限：銷售管理→領藥單 menu.sales.pharmacy-pickup（角色/帳號可勾選授權，租戶模板預設關）
- 資料模型：orders 加 order_type/pricing_slip_no/created_by（領藥單序號=flow_id）、pickup_codes.slot_no 可空
- 後台：PharmacyPickupController + PharmacyPickupService（以商品為單位建單、庫存不預扣）+ 建單/列表/列印頁(QR內嵌,不顯姓名)
- B660：領藥單回多貨道 items[]（保留 slot_no 向後相容）+ 模式 gate + 標記已領
- 出貨回報：finalizePharmacyDispense（獨立於銷售/發票/閉環）+ flow_id 終態冪等 + 庫存只扣一次
- 修正 PickupCode::isValid() 對 null expires_at 的 NPE、status 補入 fillable

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-22 09:54:04 +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
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
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
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
5c66a01261 chore: sync pending model/docs/i18n updates 2026-05-28 15:55:38 +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
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
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
284d56a544 [REFACTOR] 支付方式多語系化與 UI 響應式優化 
1. [REFACTOR] Order 模型：將支付類型標籤改為多語系轉譯，支援繁中、英、日。
2. [FEAT] 補全 lang/*.json 中的支付類型翻譯。
3. [STYLE] layouts/admin.blade.php：優化電腦版與手機版邊距佈局。
4. [STYLE] 銷售紀錄分頁：優化手機版 info grid 響應式顯示。
5. [FIX] 銷售紀錄：恢復手機版完整日期時間格式。
6. [DELETE] 移除 B710 (Timer Sync) 冗餘代碼與路由。
7. [DOCS] 更新 API 文件配置。
 2026-05-11 11:01:48 +08:00
sky121113
938aabc6c1 [FIX] 實作儀表板真實營收統計與多語系修正 
1. 修復儀表板營收統計，將模擬數據替換為從 Order 模型撈取的真實資料。
2. 修正 DashboardController 中的支付狀態篩選邏輯，從字串 'paid' 改為正確的 tinyInteger 狀態碼 1。
3. 在 Order 模型中新增 PAYMENT_STATUS_SUCCESS 與 PAYMENT_STATUS_FAILED 常數。
4. 新增「本月累計營收」的多語系翻譯（中、英、日）。
5. 優化儀表板前端介面，包含動態顯示昨日增長趨勢百分比與顏色標籤。
6. 修正儀表板機台列表中的「今日銷售額」統計邏輯。
 2026-05-06 17:55:18 +08:00
sky121113
fa6406b9ad [FEAT] 優化取貨碼管理介面與功能 
1. 新增取貨碼使用次數上限功能（限制 1-20 次）。
2. 優化取貨碼管理介面，採用極簡奢華風計數器並調整寬度與間距。
3. 整合 Flatpickr 24小時制日期時間選擇器，並實作模式切換時的時間自動帶入邏輯。
4. 取貨碼清單新增「剩餘使用次數 / 總次數」顯示。
5. 完善相關中文化翻譯（如「小時」、「自定義日期」等）。
6. 新增資料庫欄位 migration 並更新相關模型與 Service 邏輯。
7. 更新 API 技術規格文檔以符合最新取貨碼邏輯。
 2026-05-06 16:33:15 +08:00
sky121113
fc93a0fb8c [FEAT] 實作封閉迴圈交易審核與 API 規格標準化 
1. 新增 B680 員工卡驗證 API 並更新相關技術文件 (SKILL.md, api-docs.php)。
2. 重構取貨碼與通行碼之日誌追蹤系統，新增 PickupCodeLog 與 PassCodeLog 模型及資料表遷移。
3. 修正 B660 API 路由方法，統一使用 POST 進行驗證。
4. 優化後台銷售中心介面，將「紀錄」頁籤統一為「使用紀錄」並優化狀態顯示組件。
5. 更新多語系 zh_TW.json 以符合新的 UI 命名規範。
6. 調整 Order 模型與 TransactionService 以支援更精確的封閉迴圈交易審核。
 2026-05-05 17:50:26 +08:00
sky121113
15b975efac [FEAT] 新增員工卡管理模組與 B012 API 文檔完善 
1. 新增員工卡 (staff_cards) 與員工卡感應日誌 (staff_card_logs) 模型與遷移檔。
2. 實作 StaffCardController 與相關管理介面，支援狀態切換與 CRUD。
3. 擴充 routes/web.php 加入員工卡管理路由。
4. 更新 api-docs.php 文檔，補全 B012 (Unified Sync) 的商品同步回應範例。
5. 實作 PaymentTypeSeeder 並整合至 DatabaseSeeder 以標準化支付類型。
6. 優化銷售中心訂單標籤與倉庫機台庫存顯示邏輯。
7. 側邊欄選單加入員工卡管理入口。
8. 重構 TransactionService 以支援員工卡工作階段 (session_token) 驗證。
 2026-05-05 14:06:43 +08:00
sky121113
023f639fb4 [STYLE] 銷售中心 UI 優化與出貨紀錄邏輯校正 
1. 優化「出貨紀錄」介面，重新排列欄位優先級並移除冗餘的機台流水號。
2. 統一出貨紀錄中的商品與貨道樣式，與取貨碼模組視覺語言同步。
3. 修正出貨紀錄搜尋邏輯，支援商品名稱與貨道編號模糊搜尋。
4. 修正「訂單詳情」側滑面板中的金額顯示（修正 price/subtotal 映射）。
5. 補強訂單詳情的出貨狀態 (dispense_status) 標籤顯示邏輯。
6. 將出貨紀錄中的「數量」表頭修正為「金額」，確保與 MQTT 協議回傳資料語意一致。
7. 更新多語系檔，新增搜尋欄位 placeholder 與相關 UI 標籤翻譯。
8. 新增發票資料表 machine_time 欄位遷移檔，以完整記錄機台開立時間。
 2026-05-04 17:20:43 +08:00
sky121113
e779880f9b [FEAT] 整合 MQTT 交易完成 (Finalize) 流程並更新 API 技術規格文件 
1. 整合交易流程：將 B600 (交易紀錄)、B601 (發票紀錄) 與 B602 (出貨紀錄) 整合為單一原子化的 MQTT 'finalize' 操作，確保資料一致性。
2. 實作非同步 Job：新增 ProcessTransactionFinalized Job 負責解析複合式 Payload 並寫入訂單、發票與出貨日誌。
3. 重構交易服務：更新 TransactionService 以支援同時處理訂單與發票資料，並修正產品 ID 驗證邏輯以避免外鍵衝突。
4. 更新技術文件：同步更新 api-docs.php 與 .agents/skills 中的 MQTT 規格，定義詳細的 finalize payload 結構與範例。
5. 優化文件 UI：改善 api-docs.blade.php 的描述渲染，支援換行符號以提升閱讀體驗。
6. 更新監聽指令：在 ListenMqttQueue 中加入 finalize 動作的處理分支並對接至新實作的 Job。
 2026-05-04 10:18:30 +08:00
sky121113
b42695c4b8 [FEAT] 優化通行碼與取貨碼模組、補齊多國語系系統及介面風格調整 
1. 通行碼與取貨碼：新增代碼預覽、重新產生功能與到期時間預覽邏輯。
2. 通行碼：允許天數設為 0 (永久)，並改用搜尋式下拉選單選取機台。
3. 取貨碼：加強表單檢核並整合自訂 Toast 提示。
4. 語系優化：補齊繁中、英文鍵值，並完整建立日文語系目錄 (lang/ja) 與 JSON 檔案。
5. 組件優化：更新 PageHeader 與 TabNav 組件，提升 UI 互動性與一致性。
6. 訪客功能：新增通行碼訪客端查詢介面與控制器。
7. 其他模組：同步調整機台、遠端與倉庫模組視圖以符合極簡奢華風。
 2026-04-29 16:54:21 +08:00
sky121113
6b9b577978 [FEAT] 取貨碼功能強化與 UI 重構 
1. 取貨碼模組新增 Slug 機制與公開憑證頁面，支援外部連結訪問。
2. 狀態篩選下拉選單重構為極簡奢華風組件 (x-searchable-select)，並優化後端空值處理。
3. 機台分佈地圖新增「依型號分類」功能，提升管理便利性。
4. 新增 B660 取貨碼驗證 API 端點供機台通訊使用。
5. 更新多語言語系檔 (zh_TW.json) 確保介面一致性。
 2026-04-29 10:39:35 +08:00
sky121113
78321ad693 [FEAT] 取貨碼功能優化與 QR Code 生成標準化 
1. 修復 PickupCode 與 PassCode 模型中 User 命名空間錯誤。
2. 建立統一的 x-qr-code 組件，取代外部 API 並收斂至系統後端路由。
3. 優化取貨碼管理介面：將機台與商品貨道資訊拆分欄位，並動態顯示關聯商品名稱。
4. 補全 status-badge 組件中已使用、已過期與已取消的狀態樣式。
5. 修復取貨碼產生過程中的 Carbon 型別錯誤與 company_id 缺失問題。
 2026-04-28 17:25:59 +08:00
sky121113
772c7a62e8 [STYLE] 庫存管理響應式 UI 優化與卡片顯示格式修正 
1. 優化「目前庫存」分頁：修復平板模式下卡片展開導致的高度拉伸問題，並確保 Alpine.js 變數 (localCardOpen) 作用域隔離。
2. 優化「異動紀錄」分頁：將時間戳記從獨立行移入 2x2 內容網格，補上「時間」標題並修正字體顏色。
3. 優化「進貨單管理」分頁：卡片日期顯示格式修正為完整時分秒 (Y-m-d H:i:s)。
4. 統一搜尋佈局：將庫存管理各分頁與機台補貨單的「搜尋」與「重置」按鈕群組化，確保在窄螢幕換行時能保持連動。
5. 修正進貨單詳情：優化側邊欄 (Slide-over) 的資料載入邏輯與多語系顯示。
 2026-04-27 15:40:57 +08:00
sky121113
f2147ae6c4 [FEAT] 完善 IoT API 規范化、機台管理介面優化與 B005 改為 GET 
1. 將 B005 (廣告同步) 從 POST 改為 GET，符合 RESTful 規範。
2. 完善 B009 (庫存回報) 回應規格，加入業務代碼 (200 OK)。
3. API 文件 UI 優化：新增 Method Badge (方法標籤)，並修正 JSON 中文/斜線轉義問題。
4. 機台管理介面優化：實作「唯讀庫存與效期」面板，並將日誌圖示改為「👁️」。
5. 標準化 ID 識別邏輯：資料表全面移除對 sku 的依賴，改以 id 為主、barcode 為輔。
6. 新增 Migration：正式移除 sku 欄位並同步 barcode 指向。
7. 更新多語系支援 (zh_TW, en, ja)。
 2026-04-07 14:37:57 +08:00
sky121113
3ce88ed342 [FEAT] 重構機台日誌 UI 與增加多語系支援，並整合 IoT API 核心架構 
- 機台日誌：對齊 Luxury UI 規範，實作整合式佈局與分頁組件。
- 多語系：完成機台日誌繁、英、日三語系翻譯與動態處理。
- UI 規範：更新 SKILL.md 定義「標準列表 Bible」。
- 後端：完善 TenantScoped 隔離邏輯，修復儀表板死循環與 User Model 缺失。
- IoT：擴展機台、會員 Model 並建立交易、商品、狀態等核心表結構。
- 基礎設施：設置台北時區與 Docker 環境變數同步。
 2026-03-16 17:29:15 +08:00