# 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**| 化妝品 | 成分分析、過敏原管理 |