# katayama8000/axum-cqrs-rust architecture

> Architecture diagram of the GitHub repository katayama8000/axum-cqrs-rust, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/katayama8000/axum-cqrs-rust
- Repository: https://github.com/katayama8000/axum-cqrs-rust

## Overview

##### Project type and purpose
- This is a Rust-based, Docker-oriented backend microservice implementing CQRS (Command Query Responsibility Segregation) and Event Sourcing via Axum, MariaDB and Redis.
- It exposes HTTP endpoints (version check, create/update/find/list circles), handles commands through a write pipeline, persists events/snapshots, publishes them to Redis, and serves queries from a read model.

##### File structure
- Top-level crates (in `src/crates/`):
- **main**: boots the application, loads config, sets up DI/injectors (command/query handler wiring).
- **api**: HTTP router, request handlers, application state.
- **command**: definition of commands, command handler orchestrating domain logic.
- **domain**: aggregates (Circle), value objects, interfaces (ports) for repository, duplicate checker, reader.
- **infrastructure**: adapters (adapters for MariaDB schema, repository impl, Redis event publisher).
- **query**: query definitions and query handler (read pipeline).
- Supporting:
- `src/bin/main.rs` – alternative entrypoint.
- Docker assets under `Docker/` (db, redis, server).
- `compose.yml` – service composition.
- SQL scripts under `sql/`, docs in `docs/`, design notes under `Description/`.
- CI/CD workflows, devcontainer, Makefile, shell scripts.

##### README
- Tech stack: Rust, Axum, MariaDB, Redis, Docker
- Architecture: CQRS + Event Sourcing
- Points to `docs/EVENT_SYSTEM_ARCHITECTURE.md` for deep dive.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client / Consumer"]:::blue
    Client -->|"HTTP"| Rou

    subgraph "Config & Injector (main crate)"
      direction TB
      MainLib["lib.rs"] 
      AppJs["app.rs"] 
      Conf["config.rs"] 
      Conn["connect.rs"] 
      RedisConn["redis_connect.rs"] 
      InjCmd["build_command_handler.rs"] 
      InjQ["build_query_handler.rs"] 
      ImplCmd["command_handler_impl.rs"] 
      ImplQ["query_handler_impl.rs"]
    end
    click MainLib "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/lib.rs"
    click AppJs "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/app.rs"
    click Conf "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/config.rs"
    click Conn "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/config/connect.rs"
    click RedisConn "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/config/redis_connect.rs"
    click InjCmd "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/injectors/build_command_handler.rs"
    click InjQ "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/injectors/build_query_handler.rs"
    click ImplCmd "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/injectors/command_handler_impl.rs"
    click ImplQ "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/main/src/injectors/query_handler_impl.rs"

    MainLib --> Rou
    MainLib --> CH
    MainLib --> QLib

    subgraph "API Gateway (api crate)"
      direction TB
      Rou["router.rs"] 
      Han["handler.rs"] 
      AppS["app_state.rs"] 
      LibApi["lib.rs"]
    end
    click Rou "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/api/src/router.rs"
    click Han "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/api/src/handler.rs"
    click AppS "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/api/src/app_state.rs"
    click LibApi "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/api/src/lib.rs"

    Rou --> Han
    Han -->|"uses"| AppS
    Han --> CH
    Han --> QHFile

    subgraph "Command Handler (command crate)"
      direction TB
      CHLib["lib.rs"]
      CmdDef["command.rs"]
      CreateC["create_circle.rs"]
      UpdateC["update_circle.rs"]
      CH["command_handler.rs"]
    end
    click CHLib "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/command/src/lib.rs"
    click CmdDef "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/command/src/command.rs"
    click CreateC "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/command/src/command/create_circle.rs"
    click UpdateC "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/command/src/command/update_circle.rs"
    click CH "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/command/src/command_handler.rs"

    CH --> DomLib

    subgraph "Domain Model (domain crate)"
      direction TB
      AggCircle["aggregate/circle.rs"]
      AggEvent["aggregate/event.rs"]
      VO1["value_object/circle_id.rs"]
      VO2["value_object/event_id.rs"]
      VO3["value_object/version.rs"]
      PortRepo["interface/command/circle_repository_interface.rs"]
      PortDup["interface/command/circle_duplicate_checker_interface.rs"]
      PortRead["interface/query/circle_reader_interface.rs"]
      DomLib["lib.rs"]
    end
    click AggCircle "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/aggregate/circle.rs"
    click AggEvent "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/aggregate/event.rs"
    click VO1 "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/aggregate/value_object/circle_id.rs"
    click VO2 "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/aggregate/value_object/event_id.rs"
    click VO3 "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/aggregate/value_object/version.rs"
    click PortRepo "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/interface/command/circle_repository_interface.rs"
    click PortDup "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/interface/command/circle_duplicate_checker_interface.rs"
    click PortRead "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/interface/query/circle_reader_interface.rs"
    click DomLib "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/domain/src/lib.rs"

    DomLib --> Repo
    DomLib --> Pub

    subgraph "Infrastructure Adapters (infrastructure crate)"
      direction TB
      Repo["circle_repository.rs"]
      Dup["circle_duplicate_checker.rs"]
      Reader["circle_reader.rs"]
      Pub["event_publisher.rs"]
      Schema1["maria_db_schema/circle_event_data.rs"]
      Schema2["maria_db_schema/circle_snapshot_data.rs"]
      InfraLib["lib.rs"]
    end
    click Repo "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/circle_repository.rs"
    click Dup "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/circle_duplicate_checker.rs"
    click Reader "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/circle_reader.rs"
    click Pub "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/event_publisher.rs"
    click Schema1 "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/maria_db_schema/circle_event_data.rs"
    click Schema2 "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/maria_db_schema/circle_snapshot_data.rs"
    click InfraLib "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/infrastructure/src/lib.rs"

    Repo --> DBEvent
    Pub --> RedisBus

    subgraph "Query Handler (query crate)"
      direction TB
      QLib["lib.rs"]
      QHFile["query_handler.rs"]
      GetC["get_circle.rs"]
      ListC["list_circles.rs"]
    end
    click QLib "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/query/src/lib.rs"
    click QHFile "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/query/src/query_handler.rs"
    click GetC "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/query/src/query/get_circle.rs"
    click ListC "https://github.com/katayama8000/axum-cqrs-rust/blob/main/src/crates/query/src/query/list_circles.rs"

    RedisBus --> QHFile
    QHFile --> DBRead

    DBEvent["MariaDB Event Store"]:::orange
    RedisBus["Redis Event Bus"]:::green
    DBRead["MariaDB Read Model"]:::orange

    subgraph "Docker Compose"
      direction TB
      AppCont["Application Container"]:::dashed
      DBCont["MariaDB Container"]:::dashed
      RedCont["Redis Container"]:::dashed
    end
    AppCont --> Rou
    DBCont --> DBEvent
    DBCont --> DBRead
    RedCont --> RedisBus

    classDef blue fill:#D6EAF8,stroke:#1B4F72;
    classDef orange fill:#FDEBD0,stroke:#B9770E;
    classDef green fill:#D5F5E3,stroke:#196F3D;
    classDef dashed stroke-dasharray:5 5;
```
