A cloud-native microservices example built on .NET Aspire with multi-agent AI orchestration, demonstrating enterprise architecture patterns including DDD, CQRS, Event Sourcing, and Saga.
BookWorm is a cloud-native full-stack reference application built on .NET Aspire, comprising 9 microservices (Catalog, Ordering, Basket, Rating, Chat, Finance, Notification, Scheduler, McpTools) across 4 business domains with 67 messages in an event-driven architecture.
Backend Architecture
The project adopts DDD + Vertical Slice Architecture (VSA) + CQRS, using Mediator.SourceGenerator (source-generated) for CQRS implementation rather than MediatR. Data consistency is ensured through Outbox/Inbox patterns and Saga patterns (both orchestration and choreography styles), with Event Sourcing for storing domain events. Inter-service communication uses gRPC, while event-driven messaging leverages MassTransit + Kafka. Each microservice has its own PostgreSQL database with snake_case naming and UUID v7 primary keys. Authentication and authorization are handled by Keycloak, supporting Authorization Code Flow with PKCE and Token Exchange, with Presidio integrated for PII detection and redaction.
AI Capabilities
The project integrates text-embedding-3-large for embeddings and gpt-4o-mini for chat, implements multi-agent orchestration via Agent Framework, and introduces MCP (Model Context Protocol) for standardized tool calling, A2A Protocol for agent-to-agent communication, and AG-UI Protocol for agent-to-UI interaction, along with generative AI evaluation and agent governance mechanisms.
Frontend & Testing
The frontend uses a Turborepo-driven monorepo with Next.js 16 for the customer storefront and admin backoffice, supporting WCAG 2.1 AA accessibility standards. Testing strategies cover service unit tests, snapshot tests, architecture tests, k6 load tests, frontend unit and component tests, and BDD end-to-end tests.
Documentation
Includes OpenAPI (REST specs), AsyncAPI (event specs), EventCatalog (centralized architecture docs recording 4 domains, 67 messages, 1 business process), Docusaurus (detailed architecture docs), and arc42 standards. The project uses Just for development workflow management and supports one-click deployment to Azure Container Apps via Aspire CLI.
Quick Start
git clone git@github.com:foxminchan/BookWorm.git
cd BookWorm
just prepare
just run
Prerequisites: .NET 10.0 SDK, Node.js, Docker, Bun, Pnpm, Just, Buf CLI, Aspire CLI, Azure CLI, OpenAI API Key (required for AI features).
⚠️ The project explicitly states it is for demo purposes only and is not production-ready. Specific business domain (likely an online bookstore/e-commerce platform), detailed AI Agent orchestration use cases, A2A/AG-UI protocol implementation depth, and .NET version consistency (README mentions 10.0 SDK but latest Release is 9.0) require further confirmation from source code.