Architecture¶

Verity is built as a distributed, event-driven microservices platform designed for enterprise-grade identity security. This section provides comprehensive technical reference for engineers building, operating, and extending the platform.

High-Level Architecture¶

graph TB
    subgraph Ingest["① Ingest Plane"]
        C1[Azure AD Connector]
        C2[Fabric Connector]
        C3[Synapse Connector]
        C4[Databricks Connector]
        C5[PostgreSQL Connector]
        C6[HR Connector]
    end

    subgraph Normalise["② Normalise Plane"]
        IW[Ingest Worker]
        IR[Identity Resolver]
        AC[Asset Classifier]
    end

    subgraph Score["③ Score Plane"]
        DE[Decay Engine]
    end

    subgraph Review["④ Review Plane"]
        RG[Review Generator]
        WE[Workflow Engine]
    end

    subgraph Remediate["⑤ Remediate Plane"]
        RS[Remediation Service]
        AW[Audit Writer]
    end

    subgraph Infrastructure
        PG[(PostgreSQL/<br/>TimescaleDB)]
        CH[(ClickHouse)]
        KF[Apache Kafka]
        RD[(Redis)]
        TP[Temporal]
    end

    subgraph Interface
        API[API Gateway]
        UI[Dashboard UI]
        CR[Compliance Reporter]
    end

    C1 & C2 & C3 & C4 & C5 & C6 --> KF
    KF --> IW --> IR & AC
    IR & AC --> KF
    KF --> DE --> PG
    DE --> KF
    KF --> RG --> WE
    WE --> TP
    KF --> RS --> AW --> CH
    API --> PG & CH & RD
    UI --> API
    CR --> CH

    style Ingest fill:#7c4dff,color:#fff,stroke:none
    style Normalise fill:#651fff,color:#fff,stroke:none
    style Score fill:#536dfe,color:#fff,stroke:none
    style Review fill:#448aff,color:#fff,stroke:none
    style Remediate fill:#40c4ff,color:#000,stroke:none

Documentation¶

Design Principles¶

Technology Stack¶