Architecture Diagrams

Visual representations of MundiX system architecture.

System Architecture

graph TB
    subgraph "Frontend Layer"
        Web[Web UI]
    end

    subgraph "API Layer"
        Orch[Orchestrator API]
        Auth[Auth Module]
    end

    subgraph "Communication Layer"
        Matrix[Matrix Synapse]
        Bridge[mautrix-telegram]
    end

    subgraph "Agent Layer"
        Arch[Agent-Architect]
        BE[Agent-Backend]
        QA[Agent-QA]
        Sec[Agent-Security]
        DevOps[Agent-DevOps]
    end

    subgraph "Data Layer"
        PG[(PostgreSQL)]
        Redis[(Redis)]
    end

    Web --> Orch
    Orch --> Auth
    Orch --> Matrix
    Matrix --> Bridge
    Matrix --> Arch
    Matrix --> BE
    Matrix --> QA
    Matrix --> Sec
    Matrix --> DevOps
    Orch --> PG
    Orch --> Redis

Authentication Flow

sequenceDiagram
    participant Client
    participant API
    participant Redis
    participant DB

    Client->>API: POST /auth/login
    API->>Redis: Check rate limit
    Redis-->>API: OK
    API->>DB: Verify credentials
    DB-->>API: User valid
    API->>API: Generate JWT + Refresh
    API->>DB: Store refresh token
    API-->>Client: Return tokens

    Note over Client: Use access token

    Client->>API: POST /auth/refresh
    API->>DB: Validate refresh token
    API->>DB: Revoke old token
    API->>DB: Create new refresh token
    API-->>Client: New tokens

Task Processing Flow

graph LR
    A[Task Request] --> B{Parse Intent}
    B --> C[Create Task Packet]
    C --> D[Assign Agents]
    D --> E[Agent-Architect]
    E --> F[Agent-Backend]
    F --> G[Agent-QA]
    G --> H[Agent-Security]
    H --> I[Documentation]
    I --> J[Deployment]
    J --> K[Task Completed]

---

Diagrams rendered with Mermaid in MkDocs Material