Skip to main content

Architecture (C4 Model)

This section documents the Noxys system using the C4 model by Simon Brown. C4 describes software architecture at four levels of zoom; we publish the three that are most useful to integrators, auditors, and contributors:

LevelViewAudiencePage
1System ContextAuditors, CISOs, integratorsWhere Noxys sits in your IT landscape
2ContainersArchitects, DevOps, SREsDeployable units and their relationships
3Components — noxys-apiBackend engineers, reviewersInside the API service

Note on notation. Diagrams use plain Mermaid flowcharts styled to evoke the C4 visual language (Person / System / Container / Component). The experimental C4Context Mermaid block is intentionally avoided because support across Docusaurus, GitHub, and Obsidian renderers is still inconsistent. Plain Mermaid renders everywhere.

Repository inventory​

The diagrams below reference these repositories owned by noxys-eu:

RepoRole
noxys-extensionMV3 browser extension (Chrome, Edge, Firefox, Safari)
noxys-apiGo backend — policy, audit, catalog, multi-tenant control plane
noxys-consoleNext.js admin SaaS — IAM, policies, alerts, reporting
noxys-presidioPython sidecar — Tier 2 PII / Risk Signal detection
noxys-ai-forgeAsync Small Language Model service — Tier 3 detection
noxys-vscodeVS Code extension — developer-facing controls
noxys-pdf-rendererService that renders compliance reports and DPIA exports
noxys-infraTerraform + Ansible for VPS, staging, production
noxys-docdoc.noxys.cloud — this site
noxys-websitenoxys.eu marketing + ADR registry