Initial DDD and event sourcing review patterns

Covers:
- Aggregate design (boundaries, invariants, identity)
- Event sourcing (immutability, naming, content)
- Domain vs integration events
- Eventual consistency
- Projections and read models
- Snapshotting (when and how)
- Process managers / sagas
- Value objects
- Common anti-patterns

Focus on subtle mistakes models make, not textbook definitions.
This commit is contained in:
Aaron Weiker
2026-05-11 00:25:29 -07:00
commit d68d1697aa
2 changed files with 204 additions and 0 deletions
+39
View File
@@ -0,0 +1,39 @@
# DDD & Event Sourcing Patterns
Review guidance for domain-driven design and event sourcing. Focus on subtle mistakes models make and patterns they get wrong.
## Contents
- `DDD-CHECKLIST.md` - The review checklist covering:
- Aggregate Design (boundaries, invariants, identity)
- Event Sourcing (immutability, naming, content, reconstruction)
- Domain vs Integration Events
- Eventual Consistency
- Projections (read models)
- Snapshotting
- Process Managers / Sagas
- Value Objects
- Anti-Patterns to Flag
## Why This Exists
Models know the textbook definitions but often get the nuances wrong:
- Making aggregates too large (data grouping vs consistency boundary)
- Suggesting "fixes" to immutable events
- Mixing domain and integration events
- Expecting synchronous read model updates
- Snapshotting prematurely
This checklist catches those mistakes.
## Integration
```yaml
# In your review workflow
patterns-repo: rodin/ddd-patterns
patterns-files: '.'
```
## License
MIT