Files

sky121113 b0848a6bb8 chore: 完善模組化架構遷移與修復前端顯示錯誤

- 修正所有模組 Controller 的 Model 引用路徑 (App\Modules\...)
- 更新 ProductionOrder 與 ProductionOrderItem 模型結構以符合新版邏輯
- 修復 resources/js/utils/format.ts 在處理空值時導致 toLocaleString 崩潰的問題
- 清除全域路徑與 Controller 遷移殘留檔案

2026-01-26 10:37:47 +08:00

3.3 KiB

Raw Blame History

Star ERP 模組化單體架構 (Modular Monolith)

本文件記錄 Star ERP 的模組化架構現狀、模組邊界定義以及各模組包含之詳細功能。

1. 架構概觀

系統採用 模組化單體 (Modular Monolith) 架構。

後端：依據業務領域 (Domain) 拆分為獨立模組，位於 app/Modules/{ModuleName}。
前端：維持統一的 Inertia/React 架構，位於 resources/js。
通訊：模組間優先透過 Service Class 溝通，但允許在同一資料庫內進行關聯查詢 (Eloquent Relationships)。

2. 模組列表與功能 (Modules Manifest)

✅ Inventory (庫存模組)

定位：處理所有與「商品」及「實體庫存」相關的業務。通用於所有產業。

Namespace: App\Modules\Inventory
狀態: 🟢 已遷移 (Migrated)
功能細項:
- 商品基礎資料:
  - 商品管理 (CRUD、多規格)
  - 商品分類 (Category)
  - 計量單位 (Unit, 支援大小單位換算)
- 倉庫管理:
  - 多倉庫設定 (Warehouse)
  - 庫存查詢 (Inventory Lookup)
  - 庫存異動歷史 (Transaction History)
- 庫存作業:
  - 手動庫存調整 (Adjustments)
  - 庫存調撥 (Transfer Orders)
  - 批號追蹤 (Batch Tracking, 基礎版)
- 監控:
  - 安全庫存設定 (Safety Stock)

✅ Core (系統核心模組)

定位：系統基礎設施，處理帳號、權限與租戶管理。

Namespace: App\Modules\Core
狀態: 🟢 已遷移 (Migrated)
功能細項:
- 身分驗證: 登入/登出 (Auth)
- 使用者管理: User CRUD
- 權限控制: 角色與權限 (RBAC)
- 多租戶: 租戶管理 (Tenancy)
- 系統監控: 操作紀錄 (Activity Log)
- 個人化: 個人設定 (Profile)

✅ Procurement (採購模組)

定位：供應鏈管理，處理進貨源頭。

Namespace: App\Modules\Procurement
狀態: 🟢 已遷移 (Migrated)
功能細項:
- 供應商管理: 廠商資料 (Vendor)、供貨商品清單
- 採購作業: 採購單 (Purchase Order)、進貨驗收

✅ Production (生產模組)

定位：製造與加工，食品業/製造業核心。

Namespace: App\Modules\Production
狀態: 🟢 已遷移 (Migrated)
功能細項:
- 工單管理: 生產工單 (Production Order)
- 配方管理: (規劃中) Recipe
- 領料與耗用: 原料扣庫

✅ Finance (財務模組)

定位：經營分析與帳務。

Namespace: App\Modules\Finance
狀態: 🟢 已遷移 (Migrated)
功能細項:
- 費用管理: 公共事業費 (Utility Fee)
- 報表: 會計報表 (Accounting Reports)
- 成本分析: (規劃中) Costing

3. 未來擴充模組 (Future Verticals)

針對特定產業的垂直擴充模組（可插拔）：

模組名稱	適用產業	關鍵功能
Logistics	物流/零售	路徑規劃、裝車單、司機派送
Food	食品/餐飲	嚴格效期控管 (FEFO)、雙向溯源、營養成分標示
Retail	零售/電商	全通路訂單整合、促銷引擎 (Promotion)、POS 介接
Cosmetics	化妝品	成分分析、過敏原管理

3.3 KiB Raw Blame History