For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /learn/index.md.

Learn the architecture

Start with the decisions the platform must protect: who a Party is, which source owns a Project, which memberships have been observed, and what evidence permits an operation. Then follow those decisions through persistence and delivery.

Learning path

  1. Strategic DDD: language, ownership and bounded contexts.
  2. Tactical DDD: entities, values, aggregates and invariants.
  3. Hexagonal architecture: ports, adaptors and composition.
  4. CQRS: commands, queries and revision-aware views.
  5. Event-driven architecture: facts, contracts and reactions.
  6. Consistency and delivery: transactions, receipts, outboxes and recovery.
  7. Event sourcing: choosing the authoritative persistence model.
  8. Testing and exercises: evidence for each architectural claim.

The theory is adapted from the multilingual architecture reference; see attribution and source revision. Code excerpts are extracted at build time from this checkout. The examples use Party Governance and Project from the reviewed integration/current baseline. They illustrate specific boundaries and preserve the contexts' documented limitations.

For implementation rules, consult DDD.md, ARCHITECTURE.md and the owning context README.

Page source

Source snapshot ยท Revision f928834c8.