客製化 ERP
ERP 系統

graph TB
  EC1["電商平台 A"] --> ORDER
  EC2["電商平台 B"] --> ORDER
  EC3["電商平台 C"] --> ORDER

  PDA["📱 iOS PDA
揀貨 · 出貨 · 盤點"] -->|JWT API| WMS

  subgraph ERP["客製化 ERP"]
    ORDER["📦 訂單管理"]
    WMS["🏭 倉儲管理 WMS"]
    SCM["📊 進銷存"]
    HR["👥 HR 人資系統"]
    MAT["🧪 物料 & 供應商"]
    SIGN["✍️ 電子簽核"]
    ADMIN["⚙️ 管理後台"]
  end

  ORDER --> WMS
  SCM --> WMS
  HR --> SIGN
  SCM --> SIGN

  ERP --- INFRA["☁️ Redis · AWS S3"]

  classDef ext fill:#1a365d,stroke:#4299e1,color:#bee3f8
  classDef pda fill:#553c9a,stroke:#9f7aea,color:#e9d8fd
  classDef infra fill:#1c4532,stroke:#48bb78,color:#c6f6d5

  class EC1,EC2,EC3 ext
  class PDA pda
  class INFRA infra
      

多平台訂單匯入

系統為每個電商平台設有獨立的訂單 Model 與 Filament Resource，分別對應各平台的訂單格式與金流方式。每個平台有專屬的 Enum 定義付款方式與物流商，支援信用卡、分期付款、行動支付（LINE Pay / Apple Pay / Google Pay）、ATM 轉帳、超商付款等 10+ 種金流方式。

匯入後統一轉換為內部 SalesOrder + SalesOrderItem + SalesOrderSubItem 三層訂單結構，進入後續揀貨出貨流程。

倉儲管理系統 (WMS)

倉儲以 Warehouse → Location → Lot 三層架構管理庫位。揀貨流程由 PickingOrder 啟動，系統根據訂單明細自動鎖定庫存（StockLockDetail），揀貨完成後生成 ShippingOrder 出貨單。

系統支援分批出貨，同一訂單可依庫存狀況或客戶需求拆為多筆出貨單分次寄出，每筆出貨單獨立追蹤物流狀態。出貨單支援自動產出 條碼標籤（PHP Barcode Generator）與出貨明細 PDF（DomPDF + TCPDF 雙引擎）。物流支援宅配、7-11 超取、全家超取、郵寄與自取五種方式。REST API 以 JWT 認證提供行動裝置揀貨掃描與出貨操作介面。

進銷存流程

採購流程遵循 PurchaseRequisition（請購）→ PurchaseOrder（採購單）→ GoodsReceipt（進貨驗收）→ Stock（庫存入庫）的標準 ERP 採購鏈。每筆庫存變動都記錄於 StockTransaction，支援追溯完整異動歷程。

庫存調撥以 TransferOrder + TransferOrderItem 管理跨倉/跨庫位移動；報廢以 ScrapOrder + ScrapOrderItem 記錄淘汰品項。每種單據皆有獨立的 Key Generator 自動產出流水編號。

物料與供應商管理

物料以 Material + MaterialCategory（Closure Table 階層分類）管理，支援組合物料（CombinedMaterial）定義 BOM 結構。供應商資料包含 Supplier、SupplierContact、SupplierBank 三層，客戶端同樣以 Customer、CustomerContact、CustomerContactPeople、CustomerBank 多層管理。供應商資料支援 Excel 批量匯入（Maatwebsite/Laravel-Excel）。

HR 人資系統

完整人資模組涵蓋從員工入職到日常管理的全流程。員工資料設定包含基本資料、薪資結構（底薪 + 津貼，支援留職停薪等特殊狀態）、勞健保級距（依政府每年公告自動更新投保薪資級距與扣款金額）、銀行帳戶（薪資轉帳用），以及審核人員指派（設定請假/加班/補卡/班表調整的各級簽核主管）。

排班管理——以 WorkSchedule 建立工作時間表範本（上下班時間、午休時數、遲到/早退容忍範圍），搭配 Holiday 設定國定假日與公司特殊假日。班表支援單筆建立（臨時調整）與批量建立（選擇日期範圍 + 員工 + 套用範本），ScheduleAdjustment 處理班表調整申請（需主管審核），ServiceScheduleConflictChecker 自動偵測排班衝突。

出勤系統——打卡以 Attendance 記錄，支援 Excel 批次匯入/匯出（必填：員工編號、打卡時間、類型）。忘記打卡或打卡異常時透過 ClockAdjustment 提出補卡申請（限 3 天內）。系統以 ServiceAttendanceSmartDetection 智慧偵測異常出勤（遲到/早退/缺卡），CalculatorDailyAttendance 計算每日出勤狀態。打卡總表彙整班表時間、實際打卡、出勤狀態、請假記錄與加班記錄，可依日期範圍與員工篩選後匯出。

假勤管理——LeaveRequest 管理請假申請，支援特休、病假、事假、補休、婚假、喪假等假別，系統根據班表時間自動計算請假時數並扣除休息時間；LeaveQuotaTransaction 追蹤假別額度異動（含手動調整與原因記錄）。OvertimeRequest 管理加班申請（需在加班前提出），經主管審核核准後打卡，系統自動計算加班時數與倍率，員工可選擇補休或加班費；OvertimeApprovalLog 記錄逐級簽核歷程。

薪資系統——PayrollRun 執行整批薪資計算，Payslip + PayslipItem 產出明細。薪資以 SalaryGrade（級距）、SalaryItem（加/扣項）、SalaryTaxRule（稅務規則）自動計算，並考量 Dependent（眷屬）與 DependentInsurance（眷屬保險）扣除、勞健保自動扣款。薪資條以 PDF 產出供員工下載。所有操作皆保留完整歷史記錄，支援溯源查詢。

訂單狀態機

訂單管理採用 Eloquent State Machine（asantibanez/laravel-eloquent-state-machines）定義嚴格的狀態流轉規則。從「待處理」→「揀貨中」→「已出貨」→「已完成」→「已取消/退貨」等狀態，每次轉換皆由 State Machine 驗證合法性，確保訂單不會因人為操作跳過必要步驟。

iOS PDA 行動揀貨系統

倉儲現場人員使用 iOS 裝置作為 PDA（Personal Digital Assistant）手持終端，透過行動瀏覽器連接 ERP 系統的 JWT REST API，執行揀貨、出貨與庫存盤點等倉儲作業。

揀貨作業——掃描揀貨單條碼後，系統顯示待揀品項清單與庫位指引，倉儲人員逐一掃描商品條碼確認揀貨，即時更新 PickingOrder 狀態與庫存鎖定。出貨確認——揀貨完成後掃描出貨單，核對包裹內容並確認出貨，系統自動更新 ShippingOrder 狀態與物流追蹤資訊。庫存盤點——支援以 PDA 逐一掃描庫位與商品條碼進行現場盤點，盤點結果即時比對系統庫存，差異項目自動標記待覆核。

電子簽核 & 權限

以 SigningTemplate + SigningStage 建構多階段簽核工作流，支援請購、請假、加班等表單的逐級審批。權限層以 Filament Shield（基於 Spatie Permission）實現細粒度 RBAC，不同部門與角色可存取不同的 Filament Resource。所有操作以 Spatie Activity Log + Authentication Log 完整記錄稽核軌跡。

部署 & 基礎設施

檔案存儲使用 AWS S3，快取與佇列以 Redis 處理。圖片處理以 Intervention Image 進行裁切壓縮。API 文件以 Scribe 自動生成。系統設有 ControlFlag 功能旗標，可動態啟停特定模組。