diagram

Command /architect:diagram

Generate architecture diagrams in Mermaid format based on codebase analysis.

Diagram Types

1. Component Diagram

Shows high-level system components and their relationships.

graph TD
    subgraph Presentation
        R[Routers]
        DTO[DTOs]
    end

    subgraph Application
        S[Services]
        E[Events]
    end

    subgraph Domain
        M[Models]
        VO[Value Objects]
    end

    subgraph Infrastructure
        REPO[Repositories]
        EXT[External APIs]
        CACHE[Cache]
    end

    R --> S
    S --> REPO
    S --> E
    REPO --> M
    S --> EXT
    S --> CACHE

2. Data Flow Diagram

Shows how data flows through the system.

flowchart LR
    Client([Client])
    API[FastAPI]
    Auth{Auth}
    Service[Service]
    DB[(Database)]
    Cache[(Redis)]
    Queue[Message Queue]

    Client -->|HTTP Request| API
    API --> Auth
    Auth -->|Valid| Service
    Auth -->|Invalid| Client
    Service -->|Query| DB
    Service -->|Cache| Cache
    Service -->|Event| Queue
    Service -->|Response| API
    API -->|HTTP Response| Client

3. Sequence Diagram

Shows interaction between components for a specific use case.

sequenceDiagram
    participant C as Client
    participant R as Router
    participant S as Service
    participant REPO as Repository
    participant DB as Database

    C->>R: POST /orders
    R->>R: Validate DTO
    R->>S: create_order(data)
    S->>S: Apply business rules
    S->>REPO: save(order)
    REPO->>DB: INSERT
    DB-->>REPO: order_id
    REPO-->>S: Order
    S->>S: Publish OrderCreated event
    S-->>R: OrderReadDTO
    R-->>C: 201 Created

4. ER Diagram

Shows database entity relationships.

erDiagram
    users {
        int id PK
        string email UK
        string name
        string password_hash
        boolean is_active
        datetime created_at
    }

    orders {
        int id PK
        int user_id FK
        string status
        decimal total
        datetime created_at
    }

    order_items {
        int order_id PK,FK
        int product_id PK,FK
        int quantity
        decimal unit_price
    }

    products {
        int id PK
        string name
        string sku UK
        decimal price
        int stock
    }

    users ||--o{ orders : places
    orders ||--|{ order_items : contains
    products ||--o{ order_items : "included in"