BrewUpErp

BrewUpErp is an end‑to‑end sample ERP for a brewery, built to demonstrate:

• Domain‑Driven Design (DDD) and a modular / bounded‑context architecture
• CQRS and event sourcing with Muflone
• Functional‑style domain modelling and clean, testable application layers
• An agentic AI layer: one MCP server per module, an A2A agent, and a coordinator that orchestrates them
• .NET Aspire for local orchestration and observability of every service

The solution is intentionally realistic but still small enough to study. It consists of:

• BrewApi – backend HTTP API, domain, MCP servers and the Knowledge agent (ASP.NET Core, .NET 10)
• BrewSpa – Blazor web front‑end
• BrewApp – .NET MAUI mobile application

Note: this repository is a work in progress. Expect breaking changes and incomplete features, especially in less‑used flows.

---

Architecture at a glance

The backend is a modular monolith (BrewUp.Rest) surrounded by independently deployable MCP servers — one per module — plus a standalone A2A agent for the Knowledge module. The MCP servers never talk to the monolith: each one reads its own module’s read model directly, so the AI surface of a module ships and scales on its own.

Two consumers use that surface:

• the Mother coordinator inside BrewUp.Rest, which drives Azure OpenAI function calling over the pooled tool catalog of all four MCP servers, and delegates knowledge questions to the Knowledge agent over A2A;
• any external MCP client (VS Code, Claude Code, …), since every server speaks plain MCP over HTTP at /mcp.

The whole set is started by the Aspire AppHost, which injects configuration and points every service at the Aspire dashboard over OTLP.

---

Solution Structure

src/
├── BrewApi/          # Backend API, domain, MCP servers, Knowledge agent, Aspire AppHost
├── BrewSpa/          # Blazor web front-end
└── BrewApp/          # .NET MAUI mobile app
BrewDocs/             # Bruno API contracts & example payloads
docker/               # Backing services (KurrentDB, MongoDB, RabbitMQ)
infra/
├── Bicep/            # Azure Container Apps deployment
└── Docker/           # MCP + agent compose files, .env template
docs/images/          # Architecture diagrams

BrewApi

The backend solution is src/BrewApi/BrewUp.slnx.

Orchestration & cross‑cutting projects