BIS ERP Web Modular

This is the new Web-based version of BIS ERP, built with modern technologies and a Modular Monolith architecture.

Technology Stack

• Backend: ASP.NET Core 10 (LTS)
• Frontend: Angular 21 (Latest Stable)
• Database: PostgreSQL
• Reporting: QuestPDF
• Testing: Playwright & xUnit
• Logging: Serilog

Architecture

• DDD (Domain-Driven Design): Each module is divided into Domain, Application, Infrastructure, and API layers.
• Modular Monolith: Modules are logically separated within the same codebase, communicating via Integration Events.
• Microservices Ready: MassTransit with RabbitMQ is used for messaging, allowing easy extraction of modules into microservices later.

Structure

• src/Gateway: The main entry point and API host.
• src/Modules: Contains individual business modules (Identity, Finance, Inventory, etc.).
• src/Shared: Shared kernel and common infrastructure components.
• client: The Angular frontend application.
• tests: Automated tests (Unit, Integration, E2E).

Getting Started

1. Install .NET 10 SDK.
2. Install Node.js & Angular CLI.
3. Configure PostgreSQL connection in src/Gateway/BIS_ERP.Web.Api/appsettings.json.
4. Run dotnet restore to install dependencies.
5. Run dotnet run --project src/Gateway/BIS_ERP.Web.Api to start the backend.
6. Run npm install and ng serve in the client folder to start the frontend.