CustomERP - 企業資源規劃系統

一個基於 MVP（最小可行產品）策略的企業進銷存管理系統，採用前後端分離架構。

第二版UI POC

專案概述

CustomERP 是一套全面的企業資源規劃系統，專為中小型企業設計，提供完整的進銷存管理功能。系統採用動態 Tab 方式呈現使用介面，確保使用者操作便利性和效率。

主要功能模組

• 訂單採購管理 - 報價單、訂單、採購單等完整流程
• 進銷存管理 - 銷貨單、進貨單、調整單、盤點等功能
• 拆組裝管理 - 商品組合關係、組合單、拆解單
• 帳款收付 - 收款單、付款單、其他收支
• 資金帳務 - 銀行存提款、內部轉帳、信用卡入帳
• 物流系統 - 託運單、物流商 API 整合
• 基本資料 - 客戶、廠商、商品資料管理
• 共用設定 - 公司、用戶、權限設定
• 期初開帳 - Excel 匯入、應收應付開帳
• 報表系統 - 全面的業務、財務和庫存報表

技術架構

前端 (Frontend)

• 核心框架: React.js + typescript
• UI 組件: Material-UI
• 狀態管理: Redux + Context API
• 路由管理: React Router
• API Client: RTK Query
• 應用類型: 單頁應用 (SPA)
• 其他功能:
  • Lazy Loading 支援
  • 動態組件掛載
  • 動態 Tab 頁面管理

後端 (Backend)

• 核心框架: ASP.NET Core (C#)
• API 類型: RESTful API
• API 文檔: Swagger
• ORM 框架: Entity Framework Core
• 認證機制: JWT Token

資料庫

• DBMS: Microsoft SQL Server
• 資料庫管理: EF Core Migrations

安裝與設置

先決條件

• Node.js v14+ 和 npm
• .NET 7 SDK
• Microsoft SQL Server 2019+

前端設置

# 進入前端目錄
cd frontend

# 安裝依賴
npm install

# 啟動開發服務器
npm start

後端設置

# 進入後端目錄
cd backend

# 還原 NuGet 包
dotnet restore

# 應用資料庫遷移
dotnet ef database update

# 啟動 API 服務
dotnet run

開發與部署

開發環境

• Visual Studio Code 或 Visual Studio 2022
• SQL Server Management Studio
• Git 版本控制

部署

• 前端可部署至靜態網頁服務器或 CDN
• 後端部署至 IIS 或 Azure App Service
• 資料庫部署至 SQL Server 實體或雲端服務

專案結構

CustomERP/
├── frontend/                  # 前端 React 專案
│   ├── public/                # 靜態資源
│   └── src/
│       ├── components/        # 共用組件
│       ├── modules/           # 業務模組
│       ├── services/          # API 服務
│       ├── store/             # Redux 狀態
│       └── utils/             # 工具函數
│
├── backend/                   # 後端 .NET Core 專案
│   ├── API/                   # API 控制器
│   ├── Core/                  # 領域模型和業務邏輯
│   ├── Infrastructure/        # 資料庫和外部服務
│   └── Tests/                 # 單元測試
│
└── docs/                      # 文檔資料夾
    ├── architecture/          # 架構文檔
    └── images/                # 圖片資源

授權與聯繫

© 2025 CustomERP Team. 保留所有權利。

---

此文檔將隨專案發展持續更新。