oskardudycz/eventsourcing.netcore

This repository is a collection of tutorials, sample projects, and reference material for learning Event Sourcing in .NET. Event Sourcing is a way of storing data where, instead of overwriting a record with its latest state, you keep a log of every change that ever happened. If a shopping cart was created, then an item was added, then a coupon was applied, all three of those steps are saved as separate events in order. You can always reconstruct the current state by replaying the events from the beginning. The README opens with a plain explanation of the core concepts: what an event is (a fact about something that already happened, named in the past tense and never changed once written), what a stream is (a sequence of events for one entity), and how you get back to the current state by reading through the stream. It also explains related ideas like CQRS, which stands for separating the parts of your code that write data from the parts that read it. The sample projects cover a range of scenarios built with .NET. Several use a library called Marten, which turns a regular PostgreSQL database into an event store. Others use EventStoreDB, a database built specifically for this pattern. The samples include things like an e-commerce order flow, a warehouse inventory system, a cinema ticket reservation system, a smart home IoT example, and a demonstration of handling distributed processes that span multiple services. There is also a sample dedicated entirely to versioning events, which is the practical challenge of changing the shape of an event after it has already been stored in production. Beyond the code samples, the repository includes self-paced training exercises, a list of the author's blog posts and conference talks, and a large curated reading list covering topics like projections, snapshots, GDPR handling in event-sourced systems, domain-driven design, and testing strategies. The companion repositories for Java (JVM) and Node.js are also linked. The full README is longer than what was shown.