Repository navigation

Add event sourcing to the book and tutorial, and enforce wallet ownership in the sample - #19

Merged

ancongui merged 25 commits into

mainfrom

docs/eventsourcing-book

Oct 13, 2026

Merged

Add event sourcing to the book and tutorial, and enforce wallet ownership in the sample#19
ancongui merged 25 commits into
mainfrom
docs/eventsourcing-book

Commits on Oct 13, 2026
- feat(lumen): add an event-sourced, snapshot-aware Loan aggregate with its three #[EventType] events
  Andres Contreras
  committed
  da56def
- test(lumen): store loans in the database event store, replay them from history and snapshots, refuse a stale writer
  Andres Contreras
  committed
  b3dbaa7
- feat(lumen): grant and repay loans through the bus, appending events and moving money in one transaction
  Andres Contreras
  committed
  def8309
- feat(lumen): project loan events into a checkpointed loan book that the projection commands run, list and rebuild
  Andres Contreras
  committed
  c73d8bd
- feat(lumen): upcast loan.repaid v1 to v2 on read, so the repository and the loan book agree on the renamed field
  Andres Contreras
  committed
  2794636
- test(lumen): publish loan events through the database outbox in the append's transaction, and roll them back with it
  Andres Contreras
  committed
  dc7e956
- test(lumen): run the payout saga on the event-sourced orchestration store and rebuild its read model from the streams
  Andres Contreras
  committed
  748806d
- test(lumen): run the event-sourced loan and the event-sourced payout on every integration lane
  Andres Contreras
  committed
  6f2e12a
- test(lumen): keep the integration trait's setUp and resolveApplicationConfiguration adjacent, as Chapter 12 quotes them
  Andres Contreras
  committed
  cca8624
- docs(lumen): describe the event-sourced loan, its projection, upcaster and outbox publication in the sample README
  Andres Contreras
  committed
  9e281d3
- test(docs): boot the tutorial's event-sourced greeting journal and its projection as the reader's own files
  Andres Contreras
  committed
  e58ca52
- docs(book): add Chapter 9B, Lumen's event-sourced loans with snapshots, a checkpointed projection, an upcaster and outbox publication, in both editions
  Andres Contreras
  committed
  1a0eb7c
- docs(book): the preface, Chapter 9A, Appendix A and the glossary name what W3 shipped, in both editions
  Andres Contreras
  committed
  1091cb4
- docs(tutorial): Step 14 records greetings as events and projects them into a read model; What's Next becomes Step 15, in both languages
  Andres Contreras
  committed
  216171d
- docs: the front pages name event sourcing and point at Chapter 9B and Tutorial Step 14
  Andres Contreras
  committed
  6af21a8
- docs(changelog): record the D2 event-sourcing chapter, tutorial step and Lumen sample work under [Unreleased]
  Andres Contreras
  committed
  2947582
- fix(lumen): debit a wallet only for its owner or an admin, through a WalletPermissionEvaluator behind hasPermission(#command, 'debit')
  Andres Contreras
  committed
  98e46fb
- docs(book): Chapter 10 checks wallet ownership with hasPermission and WalletPermissionEvaluator, and Chapters 4, 6, 9A, 9B and the README follow, in both editions
  Andres Contreras
  committed
  8487269
- docs(changelog): record the Lumen wallet-ownership fix under [Unreleased]
  Andres Contreras
  committed
  2acfaf6
- fix(lumen): guard TransferHandler with the wallet-ownership rule, so only the source wallet's owner or an admin can move money out of it
  Andres Contreras
  committed
  58f9827
- docs(book): TransferHandler carries the ownership guard in Chapters 6, 9 and 10 and the README, and Chapter 10's exercise 2 now guards a read instead, in both editions
  Andres Contreras
  committed
  93f0592
- fix(cqrs): CommandProcessingException and QueryProcessingException carry the cause's RFC 9457 extension members and title, so a refused command publishes requiredAuthorities like a refused controll…
  Andres Contreras
  committed
  52212f6
- docs: the CQRS wrappers carry the cause's extension members, so Chapters 4, 7 and 10 and the cqrs and security module guides say a refused command keeps requiredAuthorities, in both editions
  Andres Contreras
  committed
  3fd6151
- docs(changelog): record the Lumen transfer guard and the CQRS wrappers' extension members under [Unreleased]
  Andres Contreras
  committed
  d080ae2
- test(lumen): clear the security context only for a booted lane, so a skipped lane no longer reaches for an absent application
  Andres Contreras
  committed
  d618cc4

Commits

Commits on Oct 13, 2026