# ddd_cqrs_es

> A lightweight, infrastructure-light DDD, CQRS, and Event Sourcing framework for Rust.

## Docs

- [PRD](https://ddd-cqrs-es.mintlify.app/PRD.md)
- [ddd CLI](https://ddd-cqrs-es.mintlify.app/cli.md): Scaffold, extend, validate, and run ddd_cqrs_es applications from a Laravel-style CLI.
- [4.3. Putting It All Together](https://ddd-cqrs-es.mintlify.app/config-app/assembly.md): Assemble your write repository and read projection into a working test application.
- [4.1. An Event Store](https://ddd-cqrs-es.mintlify.app/config-app/event-store.md): Configure an in-memory event store for local testing.
- [4.2. A Simple Query](https://ddd-cqrs-es.mintlify.app/config-app/simple-query.md): Build a queryable view by projecting committed events in real-time.
- [Getting Started with ddd_cqrs_es](https://ddd-cqrs-es.mintlify.app/index.md): Welcome to the lightweight, infrastructure-light Domain-Driven Design (DDD), CQRS, and Event Sourcing framework for Rust.
- [5.8. Integration with Web Frameworks (Axum)](https://ddd-cqrs-es.mintlify.app/production/axum-integration.md): Build a production-grade, asynchronous REST API on top of your event-sourced domain using Axum.
- [5.4. Database Query Patterns](https://ddd-cqrs-es.mintlify.app/production/db-query-patterns.md): Design event-store, checkpoint, snapshot, and read-model queries without accidental scans or misleading consistency claims.
- [5.1. Error Handling and Transport Mapping](https://ddd-cqrs-es.mintlify.app/production/error-handling.md): Preserve typed domain and infrastructure errors, then map them safely to REST, Leptos server functions, Spin gRPC, and tracing.
- [5.0. Production Guarantees](https://ddd-cqrs-es.mintlify.app/production/guarantees.md): Understand which ddd_cqrs_es APIs are portable, which are transaction-aware, and where applications must provide their own delivery guarantees.
- [5.6. Including Metadata](https://ddd-cqrs-es.mintlify.app/production/metadata.md): Attach correlation, causation, actor, and tenancy tracking headers to your event ledger.
- [5.2. Persisted Event Store](https://ddd-cqrs-es.mintlify.app/production/persisted-store.md): Setup a persistent SQLite or PostgreSQL event store with Optimistic Concurrency Control.
- [5.3. Queries with Persisted Views](https://ddd-cqrs-es.mintlify.app/production/persisted-views.md): Scale your read models reliably using sequence checkpoint offsets.
- [5.5. Redis Event Store and Realtime](https://ddd-cqrs-es.mintlify.app/production/redis.md): Experimental async Redis persistence and notification support.
- [5.9. Troubleshooting & Driver Pitfalls](https://ddd-cqrs-es.mintlify.app/production/troubleshooting.md): Common integration issues, database driver quirks, and serialization pitfalls when deploying to WebAssembly runtimes.
- [5.7. Event Upcasters](https://ddd-cqrs-es.mintlify.app/production/upcasters.md): Handle event schema evolution over time without mutating historical records.
- [3.1. Domain Testing](https://ddd-cqrs-es.mintlify.app/testing/complex-logic.md): Run fast, deterministic unit tests for your business invariants.
- [1.2. CQRS](https://ddd-cqrs-es.mintlify.app/theory/cqrs.md): Command-Query Responsibility Segregation separates read and write models.
- [1.1. Domain-Driven Design](https://ddd-cqrs-es.mintlify.app/theory/ddd.md): Center your software around a highly refined model of your business domain.
- [1.5. Event Sourcing](https://ddd-cqrs-es.mintlify.app/theory/event-sourcing.md): Represent application state as an immutable log of historical facts.
- [1.4. Queries](https://ddd-cqrs-es.mintlify.app/theory/queries.md): Satisfy fast user queries using denormalized read model views.
- [1.3. Making Changes to State](https://ddd-cqrs-es.mintlify.app/theory/state-changes.md): Learn how commands are validated and events are applied to transition state.
- [2.4. Add an Aggregate](https://ddd-cqrs-es.mintlify.app/tutorial/aggregate.md): Implement the Aggregate trait to bind commands, events, errors, and state.
- [2.1. Add Commands](https://ddd-cqrs-es.mintlify.app/tutorial/commands.md): Define commands to represent user intents and transactions.
- [2.3. Add an Error and Service](https://ddd-cqrs-es.mintlify.app/tutorial/errors.md): Define domain-specific validation errors and services to model business rules.
- [2.2. Add Domain Events](https://ddd-cqrs-es.mintlify.app/tutorial/events.md): Define domain events to represent past-tense historical facts.
- [Leptos WASM SSR + Spin CQRS](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr.md): Production-grade guide for building a Leptos WASM SSR application with ddd_cqrs_es, WASI, Spin, CQRS, projections, and multiple backend options.
- [Architecture Payoff](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-architecture-payoff.md): Summarize how the DDD and CQRS split keeps domain logic independent from infrastructure and runtime choices.
- [Domain Modeling and Pure Domain](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-domain.md): Model the counter aggregate, commands, events, and pure Rust domain logic for the Leptos WASM SSR CQRS example.
- [Execution and Testing Playbook](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-execution.md): Run the counter app under Wasmtime and Fermyon Spin across supported database and realtime backends.
- [Projections and Checkpointing](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-projections.md): Build asynchronous CQRS projections and persisted checkpoint tracking for read models.
- [Runtime Configuration and Backends](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-runtime-backends.md): Configure local, Spin, WASI, cloud SQL, MySQL, Redis, and outbound HTTP backend options for the counter app.
- [Leptos Server APIs](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-server-api.md): Wire Leptos server functions, REST endpoints, gRPC calls, and WASI HTTP routing around the CQRS command bus.
- [WASM and Spin Storage](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-spin-storage.md): Implement custom SQLite event, checkpoint, and projection storage for WASM and Fermyon Spin host calls.
- [Reactive Leptos UI](https://ddd-cqrs-es.mintlify.app/tutorial/leptos-ssr-ui.md): Build the polished optimistic Leptos UI and explain hydration states for the event-sourced counter app.
- [Wasmtime vs spin comparison](https://ddd-cqrs-es.mintlify.app/wasmtime-vs-spin-comparison.md)