# svamseekar/eu-ai-assurance-os architecture

> Architecture diagram of the GitHub repository svamseekar/eu-ai-assurance-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/svamseekar/eu-ai-assurance-os
- Repository: https://github.com/svamseekar/eu-ai-assurance-os

## Overview

EU AI Assurance OS is a multi-tenant governance control plane for teams preparing AI systems for the EU market. Users register systems, assess risk, track controls, assemble cited evidence, run evaluations, and monitor data-contract drift; these inputs support approval workflows and release-gate decisions, with audit records and readiness outputs. The Next.js dashboard is the authenticated product interface, backed by a Spring Boot API. The README documents the major capabilities, but most implementation files were not excerpted, so subsystem links below are documentation-backed rather than inferred from unsampled calls.

Main entry points: [`apps/dashboard/app/api/proxy/[...path]/route.ts`](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/app/api/proxy/%5B...path%5D/route.ts) (API proxy), [`services/api/src/main/java/os/assurance/eu/api/system`](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/system) (AI system registry), [`apps/dashboard/app/(dashboard)`](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/apps/dashboard/app/(dashboard)) (Governance views), [`services/api/src/main/java/os/assurance/eu/api/system/ReleaseGateService.java`](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/system/ReleaseGateService.java) (Release gate)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Product dashboard"]
  node_dashboard_app["Dashboard shell<br/>[layout.tsx]"]
  node_dashboard_views["Governance views"]
  node_auth_ui["Sign-in interface<br/>[login-screen.tsx]"]
  node_api_proxy["API proxy<br/>[route.ts]"]
end

subgraph group_identity["Identity and tenancy"]
  node_auth_api["Authentication API"]
  node_tenant_access["Tenant access"]
end

subgraph group_governance["System governance"]
  node_system_registry["AI system registry"]
  node_risk_controls["Risk and controls"]
  node_legal_corpus[("Pinned legal corpus")]
  node_obligation_determination["Obligation determination"]
  node_mapping_proposals["Mapping proposals"]
  node_sector_packs["Sector packs"]
end

subgraph group_assurance["Evidence and evaluation"]
  node_evidence_rag["Cited evidence RAG"]
  node_eval_gates["Evaluation gates"]
  node_contracts_drift["Contracts and drift"]
end

subgraph group_oversight["Oversight and monitoring"]
  node_approval_workflows["Approval workflows"]
  node_release_gate["Release gate"]
  node_audit_ledger[("Audit ledger<br/>[AuditService.java]")]
  node_readiness["Readiness scoring"]
  node_reg_monitor["Regulatory monitor"]
end

node_user(("Governance user"))

node_user -->|"uses"| node_dashboard_app
node_dashboard_app -->|"presents"| node_dashboard_views
node_user -->|"signs in"| node_auth_ui
node_auth_ui -->|"authenticates"| node_auth_api
node_dashboard_app -->|"proxies requests"| node_api_proxy
node_api_proxy -->|"calls API"| node_system_registry
node_api_proxy -->|"calls API"| node_risk_controls
node_api_proxy -->|"calls API"| node_evidence_rag
node_api_proxy -->|"calls API"| node_eval_gates
node_api_proxy -->|"calls API"| node_contracts_drift
node_api_proxy -->|"calls API"| node_approval_workflows
node_api_proxy -->|"calls API"| node_release_gate
node_dashboard_views -->|"requests determination"| node_obligation_determination
node_dashboard_views -->|"reviews proposals"| node_mapping_proposals
node_dashboard_views -->|"views packs"| node_sector_packs
node_dashboard_views -->|"views readiness"| node_readiness
node_dashboard_views -->|"reviews updates"| node_reg_monitor
node_system_registry -->|"tracks controls"| node_risk_controls
node_legal_corpus -->|"informs mappings"| node_mapping_proposals
node_system_registry -->|"supports evidence"| node_evidence_rag
node_system_registry -->|"evaluates system"| node_eval_gates
node_system_registry -->|"monitors contracts"| node_contracts_drift
node_system_registry -->|"enters review"| node_approval_workflows
node_eval_gates -->|"gates release"| node_release_gate
node_approval_workflows -->|"informs decision"| node_release_gate
node_release_gate -->|"records decision"| node_audit_ledger
node_system_registry -->|"scores readiness"| node_readiness
node_reg_monitor -->|"feeds updates"| node_dashboard_views
node_tenant_access -.->|"scopes access"| node_system_registry

click node_dashboard_app "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/app/(dashboard)/layout.tsx"
click node_dashboard_views "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/apps/dashboard/app/(dashboard)"
click node_auth_ui "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/components/auth/login-screen.tsx"
click node_api_proxy "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/app/api/proxy/%5B...path%5D/route.ts"
click node_auth_api "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/auth"
click node_tenant_access "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/tenant"
click node_system_registry "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/system"
click node_risk_controls "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/control/ControlService.java"
click node_legal_corpus "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/corpus"
click node_obligation_determination "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/determination"
click node_mapping_proposals "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/proposal"
click node_sector_packs "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/sector"
click node_evidence_rag "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/evidence"
click node_eval_gates "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/eval"
click node_contracts_drift "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/contract"
click node_approval_workflows "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/workflow/ApprovalWorkflowService.java"
click node_release_gate "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/system/ReleaseGateService.java"
click node_audit_ledger "https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/audit/AuditService.java"
click node_readiness "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/readiness"
click node_reg_monitor "https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/regmonitor"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard_app,node_dashboard_views,node_auth_ui,node_api_proxy,node_user toneBlue
class node_auth_api,node_tenant_access toneAmber
class node_system_registry,node_risk_controls,node_legal_corpus,node_obligation_determination,node_mapping_proposals,node_sector_packs toneMint
class node_evidence_rag,node_eval_gates,node_contracts_drift toneRose
class node_approval_workflows,node_release_gate,node_audit_ledger,node_readiness,node_reg_monitor toneIndigo
```

## Components

### Product dashboard

- [Dashboard shell](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/app/(dashboard)/layout.tsx): `apps/dashboard/app/(dashboard)/layout.tsx`
- [Governance views](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/apps/dashboard/app/(dashboard)): `apps/dashboard/app/(dashboard)`
- [Sign-in interface](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/components/auth/login-screen.tsx): `apps/dashboard/components/auth/login-screen.tsx`
- [API proxy](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/apps/dashboard/app/api/proxy/%5B...path%5D/route.ts): `apps/dashboard/app/api/proxy/[...path]/route.ts`

### Identity and tenancy

- [Authentication API](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/auth): `services/api/src/main/java/os/assurance/eu/api/auth`
- [Tenant access](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/tenant): `services/api/src/main/java/os/assurance/eu/api/tenant`

### System governance

- [AI system registry](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/system): `services/api/src/main/java/os/assurance/eu/api/system`
- [Risk and controls](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/control/ControlService.java): `services/api/src/main/java/os/assurance/eu/api/control/ControlService.java`
- [Pinned legal corpus](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/corpus): `services/api/src/main/java/os/assurance/eu/api/corpus`
- [Obligation determination](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/determination): `services/api/src/main/java/os/assurance/eu/api/determination`
- [Mapping proposals](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/proposal): `services/api/src/main/java/os/assurance/eu/api/proposal`
- [Sector packs](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/sector): `services/api/src/main/java/os/assurance/eu/api/sector`

### Evidence and evaluation

- [Cited evidence RAG](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/evidence): `services/api/src/main/java/os/assurance/eu/api/evidence`
- [Evaluation gates](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/eval): `services/api/src/main/java/os/assurance/eu/api/eval`
- [Contracts and drift](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/contract): `services/api/src/main/java/os/assurance/eu/api/contract`

### Oversight and monitoring

- [Approval workflows](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/workflow/ApprovalWorkflowService.java): `services/api/src/main/java/os/assurance/eu/api/workflow/ApprovalWorkflowService.java`
- [Release gate](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/system/ReleaseGateService.java): `services/api/src/main/java/os/assurance/eu/api/system/ReleaseGateService.java`
- [Audit ledger](https://github.com/svamseekar/eu-ai-assurance-os/blob/main/services/api/src/main/java/os/assurance/eu/api/audit/AuditService.java): `services/api/src/main/java/os/assurance/eu/api/audit/AuditService.java`
- [Readiness scoring](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/readiness): `services/api/src/main/java/os/assurance/eu/api/readiness`
- [Regulatory monitor](https://github.com/svamseekar/eu-ai-assurance-os/tree/main/services/api/src/main/java/os/assurance/eu/api/regmonitor): `services/api/src/main/java/os/assurance/eu/api/regmonitor`

### Other components

- **Governance user**

## Connections

- Governance user → Dashboard shell: uses (evidence: `README.md`)
- Dashboard shell → Governance views: presents (evidence: `README.md`)
- Governance user → Sign-in interface: signs in (evidence: `README.md`)
- Sign-in interface → Authentication API: authenticates (evidence: `README.md`)
- Dashboard shell → API proxy: proxies requests (evidence: `README.md`)
- API proxy → AI system registry: calls API (evidence: `README.md`)
- API proxy → Risk and controls: calls API (evidence: `README.md`)
- API proxy → Cited evidence RAG: calls API (evidence: `README.md`)
- API proxy → Evaluation gates: calls API (evidence: `README.md`)
- API proxy → Contracts and drift: calls API (evidence: `README.md`)
- API proxy → Approval workflows: calls API (evidence: `README.md`)
- API proxy → Release gate: calls API (evidence: `README.md`)
- Governance views → Obligation determination: requests determination (evidence: `README.md`)
- Governance views → Mapping proposals: reviews proposals (evidence: `README.md`)
- Governance views → Sector packs: views packs (evidence: `README.md`)
- Governance views → Readiness scoring: views readiness (evidence: `README.md`)
- Governance views → Regulatory monitor: reviews updates (evidence: `README.md`)
- AI system registry → Risk and controls: tracks controls (evidence: `README.md`)
- Pinned legal corpus → Mapping proposals: informs mappings (evidence: `README.md`)
- AI system registry → Cited evidence RAG: supports evidence (evidence: `README.md`)
- AI system registry → Evaluation gates: evaluates system (evidence: `README.md`)
- AI system registry → Contracts and drift: monitors contracts (evidence: `README.md`)
- AI system registry → Approval workflows: enters review (evidence: `README.md`)
- Evaluation gates → Release gate: gates release (evidence: `README.md`)
- Approval workflows → Release gate: informs decision (evidence: `README.md`)
- Release gate → Audit ledger: records decision (evidence: `README.md`)
- AI system registry → Readiness scoring: scores readiness (evidence: `README.md`)
- Regulatory monitor → Governance views: feeds updates (evidence: `README.md`)
- Tenant access → AI system registry: scopes access (evidence: `services/api/src/main/java/os/assurance/eu/api/system/AiSystemRepository.java`)
