🏢 Enterprise ERP System

🚀 A production-ready, cloud-native ERP system built with .NET 10, Domain-Driven Design, and enterprise-grade patterns

Quick Start • Features • Architecture • Deployment • Contributing

---

💡 Why Another ERP?

❌ Most Open-Source ERPs	✅ This Project
Legacy monoliths	15+ Microservices with independent deployment
Outdated tech stacks	.NET 10, Dapr, Kubernetes-ready
Oversimplified demos	Real-world complexity: Event Sourcing, MRP, Multi-tenancy
Vendor lock-in	100% Open Source, MIT Licensed

---

✨ Features

💰 Finance & Accounting ✅ Double-Entry General Ledger ✅ Chart of Accounts (hierarchical) ✅ Trial Balance & Financial Reports ✅ Accounts Payable / Receivable ✅ Auto Journal Entries from Operations ✅ Assets Management & Depreciation	📦 Supply Chain ✅ Multi-Warehouse Inventory ✅ Real-time Stock Reservations ✅ Purchase Order Lifecycle ✅ Goods Receipt & Quality Control ✅ Material Requirements Planning (MRP)
🛒 Sales & CRM ✅ Order-to-Cash Workflow ✅ Customer 360 View & CRM ✅ Opportunity & Pipeline Management ✅ Shipment Tracking ✅ Invoice Generation ✅ Sales Analytics Dashboard	🏭 Manufacturing & Projects ✅ Production Orders & BOM ✅ Work-in-Progress Tracking ✅ Production Efficiency Reports ✅ Project Management & Tasks ✅ Timesheets & Resource Planning ✅ Asset Maintenance
👥 Human Resources ✅ Employee Lifecycle ✅ Organization Structure ✅ Payroll Processing & Payslips ✅ Identity & Access Control (RBAC) ✅ Role-based Permissions	📊 BI & Reporting ✅ Executive Dashboard ✅ Sales Trend Analysis ✅ Inventory Valuation Reports ✅ Financial Summary (P&L) ✅ Production Efficiency Metrics
📈 AI & Real-time Analytics (New!) ✅ Real-time Live Dashboards (SignalR/WebSockets) Live inventory movements Flash sales alerts System health monitoring ✅ AI-Driven Demand Forecasting (ML.NET) Singular Spectrum Analysis (SSA) for seasonality detection Confidence intervals (95%) ✅ High-Performance Time-Series (TimescaleDB) Cash flow trending IoT sensor data ingestion (simulated)

---

🏗️ Architecture

graph TB
    subgraph "🌐 Gateway Layer"
        GW[YARP API Gateway]
    end
    
    subgraph "📊 Core Business Services"
        FIN[💰 Finance]
        INV[📦 Inventory]
        SALES[🛒 Sales]
        PROC[📋 Procurement]
        PROD[🏭 Production]
        CRM[🤝 CRM]
        PROJ[📅 Projects]
    end
    
    subgraph "🔧 Supporting Services"
        HR[👥 HR]
        PAY[💸 Payroll]
        ASSET[🏢 Assets]
        ID[🔐 Identity]
        MD[📁 MasterData]
        MRP[📈 MRP]
        RPT[📊 Reporting]
    end
    
    subgraph "⚙️ Platform Services"
        AUTO[🤖 Automation]
        QUAL[✅ Quality]
        MAINT[🔧 Maintenance]
        SET[⚙️ Settings]
        ANA[📉 Analytics]
    end
    
    subgraph "🛠️ Infrastructure"
        PG[(PostgreSQL)]
        TSDB[(TimescaleDB)]
        REDIS[(Redis)]
        DAPR{Dapr Sidecar}
    end
    
    GW --> FIN & INV & SALES & PROC & PROD & CRM & PROJ
    GW --> HR & PAY & ASSET & ID & MD & MRP & RPT
    GW -.->|SignalR / WebSocket| ANA
    
    FIN & INV & SALES & CRM & PROJ -.->|Event Bus| DAPR
    DAPR -.-> AUTO & ANA
    
    FIN & INV & SALES --> PG
    ANA --> TSDB
    ID --> REDIS

Loading

🎨 Design Patterns

Pattern	Implementation
Event Sourcing	Complete audit trail, temporal queries
CQRS	Separate read/write models with MediatR
Domain-Driven Design	Aggregates, Value Objects, Domain Events
Saga Pattern	Distributed transactions via Dapr
Outbox Pattern	Reliable event publishing with EF Core
Specification Pattern	Reusable query logic
Result Pattern	Railway-oriented error handling

🛡️ Enterprise Building Blocks

Our shared kernel provides production-ready cross-cutting concerns:

ErpSystem.BuildingBlocks/
├── Behaviors/          # MediatR pipeline (Validation, Logging, Idempotency, Audit, Performance)
├── CQRS/               # ICommand, IQuery, Handler abstractions
├── Common/             # Result<T> pattern, Error types
├── Domain/             # Specifications, Domain Event Dispatcher
├── Outbox/             # Transactional Outbox with EF Core
├── MultiTenancy/       # SaaS tenant isolation (query filters + interceptors)
├── Resilience/         # Polly V8 (Retry, Circuit Breaker, Timeout)
├── Caching/            # Distributed cache extensions (GetOrSet)
├── Auditing/           # Automatic audit logging
└── Middleware/         # CorrelationId, RequestLogging, GlobalException

---

🚀 Quick Start

Prerequisites

Tool	Version
.NET SDK	10.0+
Docker	Latest
PostgreSQL	16+

Run Locally

# 1. Clone
git clone https://github.com/Edison0621/erp-microservice.git
cd erp-microservice

# 2. Build & Test
dotnet build src/ErpSystem.sln
dotnet test src/ErpSystem.sln

# 3. Run a service (e.g., Finance)
cd src/Services/Finance/ErpSystem.Finance
dotnet run

Run with Docker

# Build all images
docker build -t erp-system/finance:latest --build-arg SERVICE_NAME=Finance .

# Or use Docker Compose
docker-compose up -d

---

☸️ Deployment

Kubernetes with Helm

# Install the chart
helm install erp-system deploy/helm/erp-system \
  --set postgresql.auth.password=your-secure-password \
  --set ingress.host=erp.yourcompany.com

# Verify
kubectl get pods -n erp-system

Deployment Stack

deploy/
├── k8s/                        # Raw Kubernetes manifests
│   ├── namespace.yaml
│   ├── configmap.yaml
│   ├── secrets.yaml
│   ├── ingress.yaml
│   └── services/*.yaml         # Per-service deployments
└── helm/erp-system/            # Helm Chart
    ├── Chart.yaml
    ├── values.yaml
    └── templates/

📖 Full Guide: docs/deployment.md

---

📁 Project Structure

erp-microservice/
├── src/
│   ├── BuildingBlocks/             # 🧱 Shared kernel (enterprise patterns)
│   ├── Gateways/ErpSystem.Gateway/ # 🌐 YARP reverse proxy
│   ├── Services/
│   │   ├── Finance/                # 💰 General Ledger, AP/AR
│   │   ├── Inventory/              # 📦 Stock management
│   │   ├── Sales/                  # 🛒 Order processing
│   │   ├── Procurement/            # 📋 Purchase orders
│   │   ├── Production/             # 🏭 Manufacturing
│   │   ├── CRM/                    # 🤝 Customer Relationship Management
│   │   ├── Projects/               # 📅 Project Management
│   │   ├── HR/                     # 👥 Employee management
│   │   ├── Payroll/                # 💸 Payroll & Compensation
│   │   ├── Assets/                 # 🏢 Asset Lifecycle Management
│   │   ├── Identity/               # 🔐 Auth & RBAC
│   │   ├── MasterData/             # 📁 Materials, Customers, Suppliers
│   │   ├── Mrp/                    # 📈 Material Requirements Planning
│   │   ├── Reporting/              # 📊 BI Dashboard & Reports
│   │   ├── Quality/                # ✅ QC & Inspection
│   │   ├── Analytics/              # 📉 Time-series analytics
│   │   ├── Automation/             # 🤖 Workflow engine
│   │   ├── Maintenance/            # 🔧 Asset maintenance
│   │   └── Settings/               # ⚙️ System configuration
│   └── Web/ErpSystem.Web/          # 🖥️ React frontend
├── tests/
│   └── ErpSystem.IntegrationTests/ # ✅ 21 passing tests
└── deploy/
    ├── k8s/                        # Kubernetes manifests
    └── helm/erp-system/            # Helm chart

---

🧪 Testing

# Run all tests
dotnet test src/ErpSystem.sln

# Run specific module
dotnet test --filter "GLTests"

# With coverage
dotnet test /p:CollectCoverage=true

Current Status: ✅ 21 tests passing

---

🛣️ Roadmap

Phase	Status	Description
Phase 1	✅ Complete	Core Infrastructure & Event Sourcing
Phase 2	✅ Complete	Finance Module (General Ledger)
Phase 3	✅ Complete	Inventory & Procurement
Phase 4	✅ Complete	MRP (Material Requirements Planning)
Phase 5	✅ Complete	Enterprise BuildingBlocks
Phase 6	✅ Complete	Reporting & BI Dashboard
Phase 7	✅ Complete	Kubernetes & Helm Charts
Phase 8	✅ Complete	CRM & Customer Portal
Phase 9	✅ Complete	Project Management & Timesheets
Phase 10	✅ Complete	Payroll & Compensation
Phase 11	✅ Complete	Asset Lifecycle Management
Phase 12	✅ Complete	Real-time Notifications (SignalR)
Phase 13	✅ Complete	AI-Driven Demand Forecasting (ML.NET)

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

# Fork → Clone → Branch → Code → Test → PR
git checkout -b feature/amazing-feature
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature

---

📄 License

This project is licensed under the MIT License - see LICENSE for details.

---

⭐ Star this repo if you find it useful!

Built with ❤️ using .NET 10, DDD, and modern cloud-native patterns

Report Bug · Request Feature · Discussions