sky121113
b0848a6bb8
- 修正所有模組 Controller 的 Model 引用路徑 (App\Modules\...) - 更新 ProductionOrder 與 ProductionOrderItem 模型結構以符合新版邏輯 - 修復 resources/js/utils/format.ts 在處理空值時導致 toLocaleString 崩潰的問題 - 清除全域路徑與 Controller 遷移殘留檔案
93 lines
3.3 KiB
Markdown
93 lines
3.3 KiB
Markdown
# 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**| 化妝品 | 成分分析、過敏原管理 |
|