RavenmaskOS Service Diagram

This is the master, system-level service diagram for RavenmaskOS. It shows routing, core dependencies, identity, and observability wiring at a glance.

flowchart LR
  %% Edge + routing
  user([Users / Clients]) --> traefik[Traefik]

  %% Identity
  traefik --> oauth2proxy[oauth2-proxy]
  oauth2proxy --> zitadel[Zitadel]

  %% Core data
  postgres[(PostgreSQL)]:::data
  redis[(Redis)]:::data

  %% App and platform services
  subgraph Apps
    agentstudio[agent-studio]
    pmoadmin[pmo-admin]
    crm[crm]
    homepage[homepage]
    landing[landing]
  end

  subgraph AI_ML["AI/ML Platform"]
    norns[norns]
    bifrost[bifrost]
    langfuse[langfuse]
    ollama[ollama]
    vidar[vidar]
  end

  subgraph Voice
    livekit[livekit]
    whisper[whisper]
    piper[piper]
    telephony[telephony]
    voicegateway[voice-gateway]
    coturn[coturn]
  end

  subgraph Automation
    n8n[n8n]
    gitlabrunner[gitlab-runner]
    mcpservergitlab[mcp-server-gitlab]
  end

  subgraph SmartHome
    homeassistant[homeassistant]
    homebridge[homebridge]
    grocy[grocy]
  end

  subgraph IdentityAndSecrets["Identity + Secrets"]
    openbao[openbao]
    openfga[openfga]
  end

  subgraph Observability
    grafana[grafana]
    prometheus[prometheus]
    loki[loki]
    tempo[tempo]
    alloy[alloy]
    cadvisor[cadvisor]
    nodeexporter[node-exporter]
    postgresexporter[postgres-exporter]
    redisexporter[redis-exporter]
    uptimekuma[uptime-kuma]
  end

  %% Routing
  traefik --> Apps
  traefik --> AI_ML
  traefik --> Voice
  traefik --> Automation
  traefik --> SmartHome
  traefik --> Observability

  %% Data dependencies
  Apps --> postgres
  Apps --> redis
  AI_ML --> postgres
  AI_ML --> redis
  Voice --> postgres
  Voice --> redis
  Automation --> postgres
  Automation --> redis
  SmartHome --> postgres

  %% Identity dependencies
  Apps --> openfga
  AI_ML --> openfga
  Voice --> openfga
  Automation --> openfga

  %% Secrets
  Apps --> openbao
  AI_ML --> openbao
  Voice --> openbao
  Automation --> openbao
  SmartHome --> openbao

  %% Observability signals
  Apps --> alloy
  AI_ML --> alloy
  Voice --> alloy
  Automation --> alloy
  SmartHome --> alloy
  alloy --> prometheus
  alloy --> loki
  alloy --> tempo
  prometheus --> grafana
  loki --> grafana
  tempo --> grafana

  %% Exporters
  cadvisor --> prometheus
  nodeexporter --> prometheus
  postgresexporter --> prometheus
  redisexporter --> prometheus

  classDef data fill:#f7f7f7,stroke:#555,stroke-width:1px;