Repository navigation
Releases: reckon-db-org/reckon-codex
Releases · reckon-db-org/reckon-codex
Release list
v0.2.1
v0.2.1 - Pizza geometry correction
Corrects a structural error in the Ch3 Pizza Architecture
figure (and the prose around it) that came to light when
the DisComCo 'Cakes, Onions and Pizzas' deck was identified
as the canonical source for the Pizza name and shape.
What changed since v0.2.0:
figs/pizza-architecture.svg fully rewritten:
- The earlier version drew CMD/PRJ/QRY as three concentric
rings, which is wrong. CMD/PRJ/QRY are sibling deployables,
not nested rings.
- The new version follows the canonical hub-and-spokes
geometry: Event Store hub, 8 spokes (Desks), each spoke
containing four colour-coded actor blocks (Emitter,
Listener, Responder, Requester), Pub/Sub outer ring,
seven external infrastructure boxes (storage, telemetry,
hardware, caching, messaging, internet, event stream).
figs/division-company-model.svg added (new Figure 3.2):
- Sourced from hecate-corpus/assets/cartwheel-company-model.svg
- Relabeled to library vocabulary throughout
(capabilities -> loans, HOPE/FACT -> gRPC/Fact,
Tube Mail -> Event)
- Shows CMD/PRJ/QRY as three sibling Departments in
columns, with frontdesks + backoffice desks per
Department, and tube-mail-style event flow CMD -> PRJ
- The view that the wheel diagram doesn't easily express
Chapter 3 prose:
- Section heading 'The three rings: CMD, PRJ, QRY' renamed
to 'The three Departments: CMD, PRJ, QRY'
- All three 'X is the Y ring' paragraphs rewritten as
'X is the Y Department'
- Figure 3.1 caption rewritten to describe the per-spoke
actor stack
- Figure 3.2 inserted with cross-reference @fig-company
Colophon:
- New acknowledgement crediting DisComCo (discomco.pl)
for the Pizza Architecture name and the canonical
hub-and-spokes-with-four-actors diagram
The book now has two correct, complementary illustrations
of a Division's shape: the wheel (Figure 3.1, slicing
emphasis) and the company (Figure 3.2, departmental
emphasis).
v0.2.0
v0.2.0 - Illustrated, polished
Cumulative rework relative to v0.1.0:
- Em-dashes: 320 -> 0 across 16 files (parens for pairs,
semicolons for pivots).
- Rule-of-three: six surgical rewrites breaking parallel
sentence triples; factual triples (CMD/PRJ/QRY, etc.)
kept where the architecture genuinely names three.
- Voice polish: ~9 'load-bearing' occurrences trimmed
from formulaic uses (22 -> 13), 'soul' / 'TODO-list'
word triggers eliminated.
New figures:
- figs/pizza-architecture.svg (rewritten from scratch
with proper 3-ring CMD/PRJ/QRY structure + 8 Desk
wedges + crust + Event Store hub)
- figs/reckon-cycle.svg (derived from corpus template,
8 stages on rim + Orchestration at hub)
- figs/cqrs-separated.svg (CMD -> store -> projections
-> QRY, embedded in Ch1)
- figs/dossier-metaphor.svg (3-Desk loan-application
Dossier flow, embedded in Ch2)
Build: workflow now installs librsvg2-bin so Quarto's
PDF backend can rasterise SVGs for the LaTeX pipeline.
v0.1.0
v0.1.0 - The Reckon Codex, first cut The book is fully drafted in first-cut form: 13 chapters, front matter (preface, how-to-read), back matter (colophon), ~55,000 words, alphabetised glossary with cross-references, clinical antipatterns catalogue. Part I (Pattern): 1. Why event sourcing 2. The D5 model 3. Pizza Architecture 4. Names that scream 5. Dossiers and Decisions 6. Pipelines and Process Managers 7. The Reckon Cycle Part II (Stack): 8. reckon-db 9. evoq 10. reckon-gateway and reckon-proto 11. Worked example: a lending library Part III (Reference): 12. Antipatterns 13. Glossary Build: Quarto -> PDF + HTML via GitHub Actions on the codeberg-to-github push-mirror. Licence: CC-BY-SA 4.0 for prose, Apache-2.0 for code samples. Open work: illustrations (Figure 3.1 Pizza diagram and Figure 7.1 Wheel diagram still placeholders), external review, possible companion worked-example repository.