Architecture¶

MundiX system architecture and design documentation.

Overview¶

MundiX is a multi-agent development system built with:

Backend: FastAPI + SQLAlchemy + PostgreSQL
Cache/Queue: Redis
Communication: Matrix (Synapse) + mautrix-telegram
Infrastructure: Docker Compose + Traefik
Documentation: MkDocs Material

Architecture Documents¶

Master Architecture ¶

High-level system architecture including: - Component overview - Data flow diagrams - Integration points - Deployment architecture

Diagrams ¶

Visual representations: - System architecture diagrams (Mermaid) - Sequence diagrams - Component diagrams - Infrastructure diagrams

ADRs ¶

Architecture decision records documenting key technical decisions.

System Components¶

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

    subgraph "API Layer"
        B[Orchestrator API]
        C[Auth API]
    end

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

    subgraph "Data Layer"
        F[(PostgreSQL)]
        G[(Redis)]
    end

    subgraph "Agent Layer"
        H[Agent-Architect]
        I[Agent-Backend]
        J[Agent-QA]
        K[Agent-Security]
        L[Agent-DevOps]
    end

    A --> B
    B --> C
    B --> D
    D --> E
    B --> F
    B --> G
    D --> H
    D --> I
    D --> J
    D --> K
    D --> L

Last updated: 2026-02-03