eShopOnContainersDDD
A fully event-sourced e-commerce microservices example built with DDD, CQRS, and Aggregates.NET patterns.
What is eShopOnContainersDDD?
eShopOnContainersDDD is a fork of Microsoft's eShopOnContainers project, reimplemented as a fully event-sourced e-commerce application using Domain-Driven Design (DDD) and Command Query Responsibility Segregation (CQRS) patterns. It demonstrates how to build a distributed microservices system where all state changes are captured as events, providing a complete audit log and enabling flexible read models for different business needs.
Developers and architects interested in learning or implementing DDD, CQRS, and event sourcing in .NET microservices applications, particularly those building scalable e-commerce or distributed systems.
It offers a practical, open-source example of a production-like event-sourced architecture using Aggregates.NET, making complex distributed systems more understandable and maintainable by separating concerns and providing a single source of truth through event logs.
Overview
Fork of dotnet-architecture/eShopOnContainers in full DDD/CQRS design using my own patterns
Use Cases
Best For
- Learning event sourcing and CQRS patterns in a real-world .NET application
- Building scalable e-commerce platforms with microservices
- Implementing Domain-Driven Design in distributed systems
- Creating audit-friendly applications with complete change histories
- Developing systems where multiple departments need different views of the same data
- Practicing containerized deployment with Docker and microservices
Not Ideal For
- Teams needing rapid prototyping without complex distributed system setup
- Developers on Windows environments due to Linux-only Docker requirements
- Projects avoiding proprietary library licenses like ServiceStack
- Applications where simple CRUD operations suffice, making event sourcing overkill
Pros & Cons
Pros
Demonstrates a fully event-sourced application using Aggregates.NET, providing a practical implementation of DDD and CQRS with clear architecture diagrams.
Strictly implements CQRS to separate commands and queries, improving scalability and maintainability as explained in the logical overview.
Uses event logs to generate tailored read models for different business needs, such as for warehouse and marketing departments, illustrated in the event sourcing diagram.
Employs Docker for containerization, showcasing modern deployment practices in a distributed microservices architecture.
Cons
Admitted by the author as not bug-free and written quickly in free time, so it lacks production readiness and may have unresolved issues.
Requires specific licenses like ServiceStack, Linux environment, and manual IP configuration, making initial deployment cumbersome.
Currently only runs on Linux due to Docker image dependencies, excluding Windows developers without significant workarounds.
Frequently Asked Questions
Related Projects
Modular MonolithFull Modular Monolith application with Domain-Driven Design approach.
eShopOnWebSample ASP.NET Core 8.0 reference application, now community supported: https://github.com/NimblePros/eShopOnWeb
EquinoxProjectWeb Application ASP.NET 9 using Clean Architecture, DDD, CQRS, Event Sourcing and a lot of good practices
Event Sourcing .NETExamples and Tutorials of Event Sourcing in .NET
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.