star-cloud/app/Http/Controllers/Admin
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
..
BasicSettings [FEAT] 商品與機台多語系架構,並補上系統設定同步操作 2026-06-15 09:00:10 +08:00
Machine [FEAT] 倉儲管理系統模組實作與全站 UI/UX 標準化優化 2026-04-23 11:51:08 +08:00
AdminController.php feat: 實作機台日誌核心功能與 IoT 高併發處理架構 2026-03-09 09:43:51 +08:00
AdvertisementController.php [FEAT] 新增商品 Excel 批量匯入與模板下載功能 2026-05-28 11:19:00 +08:00
AnalysisController.php [FIX] 修正商品與機台報表因 order_items 與 dispense_records 聯結產生笛卡爾積導致件數重複加總的問題 2026-06-05 21:56:41 +08:00
AppConfigController.php fix: 修正模型重構後遺漏的命名空間引用 (PointRule, Member, etc.) 2026-03-09 09:57:41 +08:00
AuditController.php feat: 實作後台導航選單系統與狀態持久化 2025-12-16 23:21:11 +08:00
CompanyController.php [FEAT] 實作自訂品牌樣式設定與專屬登入頁面預覽功能 2026-06-05 08:44:38 +08:00
DashboardController.php [FEAT] 實作機台智慧連線監控與儀表板告警同步優化 2026-05-14 16:20:59 +08:00
DataConfigController.php [FEAT] 移除「商品狀態」冗餘模組、優化麵包屑導航與完善帳號角色過濾邏輯 2026-03-27 16:53:43 +08:00
DepositBonusRuleController.php fix: 修正模型重構後遺漏的命名空間引用 (PointRule, Member, etc.) 2026-03-09 09:57:41 +08:00
GeocodingController.php [FIX] 修正台灣地址解析經緯度失敗問題 2026-05-22 09:51:05 +08:00
GiftDefinitionController.php fix: 修正模型重構後遺漏的命名空間引用 (PointRule, Member, etc.) 2026-03-09 09:57:41 +08:00
ImpersonateController.php [FEAT] 實作系統管理員切換帳號 (Impersonate) 功能 2026-05-17 11:07:41 +08:00
LineController.php feat: 實作後台導航選單系統與狀態持久化 2025-12-16 23:21:11 +08:00
MachineController.php [FEAT] 於機台管理與機台設定頁面新增公司篩選功能 2026-06-05 13:01:52 +08:00
MaintenanceController.php [FEAT] 新增遠端庫存列表視圖與機台管理租戶公司過濾功能 2026-06-05 14:20:35 +08:00
MembershipTierController.php fix: 修正模型重構後遺漏的命名空間引用 (PointRule, Member, etc.) 2026-03-09 09:57:41 +08:00
PermissionController.php [FIX] 移除角色權限設定中已廢棄的特殊權限模組 2026-05-27 10:03:14 +08:00
PointRuleController.php fix: 修正模型重構後遺漏的命名空間引用 (PointRule, Member, etc.) 2026-03-09 09:57:41 +08:00
ProductCategoryController.php [STYLE] 商品管理介面多語系標準化與側邊欄 UI 優化 2026-05-14 11:25:43 +08:00
ProductController.php [FEAT] 商品詳情支援多行排版並原樣下發 APP 2026-06-15 11:42:06 +08:00
QrCodeController.php [FEAT] 優化機台 API 通訊識別、補齊前端必填驗證、並配置 Demo 站隊列自動化部署 🦾🚀 2026-03-26 13:09:48 +08:00
RemoteController.php [FEAT] 新增環境溫度上限監測與遠端風扇指令控制功能 2026-06-04 11:45:48 +08:00
ReservationController.php feat: 實作後台導航選單系統與狀態持久化 2025-12-16 23:21:11 +08:00
SalesController.php [FEAT] 電子發票後台開立、對帳、補開與作廢流程 2026-06-15 16:18:33 +08:00
SpecialPermissionController.php [FEAT] 新增 OTA APK 版本管理與更新部署功能 2026-05-22 16:51:21 +08:00
StaffCardController.php [FIX] 修復員工識別卡最後使用狀態更新、刪除頁面顯示 JSON 與語系遺漏問題 2026-05-18 13:37:21 +08:00
ThemeController.php first commit 2025-11-21 17:15:27 +08:00
WarehouseController.php [FIX] 補貨單完成邏輯與機台庫存去耦,防範重複累加 Bug 2026-06-09 11:11:09 +08:00