Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/NilavPatel/Todo.CQRS
CQRS and Event Sourcing sample application and architecture
https://github.com/NilavPatel/Todo.CQRS
aggregate asp-net-core checkpoint cqrs cqrs-framework csharp ddd-architecture ddd-cqrs domain-driven-design event-driven event-sourcing eventstore eventstoredb repository-pattern snapshot
Last synced: 3 months ago
JSON representation
CQRS and Event Sourcing sample application and architecture
- Host: GitHub
- URL: https://github.com/NilavPatel/Todo.CQRS
- Owner: NilavPatel
- License: mit
- Created: 2021-04-07T14:07:26.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-05-20T13:53:25.000Z (over 2 years ago)
- Last Synced: 2024-07-01T02:01:03.528Z (4 months ago)
- Topics: aggregate, asp-net-core, checkpoint, cqrs, cqrs-framework, csharp, ddd-architecture, ddd-cqrs, domain-driven-design, event-driven, event-sourcing, eventstore, eventstoredb, repository-pattern, snapshot
- Language: C#
- Homepage:
- Size: 558 KB
- Stars: 15
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CQRS + ES + DDD + .NET 5.0
`CQRS` stands for **Command and Query Responsibility Segregation**
`ES` stands for **Event Sourcing**
`DDD` stands for **Domain Driven Design**
## Features
- Commands and handlers
- Domain models (Aggregates)
- Aggregate repository
- Event sourcing using [EventStore](https://www.eventstore.com/)
- Domain events and handlers (Projections)
- Integration events and handlers (Cross module projections)
- Read models
- Query controllers
- Unit of work, Read repository, Write repository
- Auto registration of commands, events and their handlers
- Unit of work for multiple aggregates
- Snapshots, Snapshot repository, Snapshot storage in eventstore db
- Checkpoint, Checkpoint repository, Checkpoint storage in eventstore db
- Class for sequential GUIDs
- Entity tracking for write repository and no tracking for read repository
## Notes:
- Inherit domain model with `AggregateRoot` or `SnapshotAggregateRoot`.
- Domain model must have a parameterless constructor with a `private` access modifier.
- Set all setters with `private` modifier to all properties in the domain model.
- `Domain` layer has no dependencies except `Contracts` layer.
- All business logic and validation should be written in domain models.
- `Contracts` contain Command and Event classes, no business logic should be written in `Contracts`.
- All database updates are done from `EventHandler` only.
- Use `IReadRepository` for query controllers.
- Use sequential Guids `CombGuid.NewGuid()` instead of `Guid.NewGuid()`.
- Use `IUnitOfWork` to update data in event handlers.
- Start background processor before starting web app
- AggregateVersion start from 1, where in EventStore event version start from 0.
## [How to configure Eventstore?](https://github.com/NilavPatel/Todo.CQRS/blob/main/Docs/EventStore_Config.md)
## Diagrams:
