# aritonangjos/ciso-assistant-community architecture

> Architecture diagram of the GitHub repository aritonangjos/ciso-assistant-community, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aritonangjos/ciso-assistant-community
- Repository: https://github.com/aritonangjos/ciso-assistant-community

## Overview

CISO Assistant is an API-first governance, risk, and compliance platform. Users work through the web application or automation clients to manage frameworks, controls, assessments, risks, and remediation; the backend applies access rules and persists linked domain records. Separate capabilities include framework mapping, AI assistance, imports/exports, analytics, and ITSM synchronization. The graph preserves these documented product branches alongside the principal workflow. Some subsystems are represented at directory level because their source was not sampled; their internal call paths are therefore omitted.

Main entry points: [`backend/core/models.py`](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/models.py) (GRC records), [`backend`](https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend) (Backend API), [`backend/core/startup.py`](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/startup.py) (Platform initialization), [`backend/integrations/tasks.py`](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/tasks.py) (Sync tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_web["Web application"]
end

subgraph group_domain["GRC Domain"]
  node_domainmodels[("GRC records<br/>[models.py]")]
  node_base["Shared model layer<br/>[base_models.py]"]
  node_mapping["Framework mapping<br/>[engine.py]"]
  node_tprm[("Third-party risk<br/>[models.py]")]
  node_importexport["Import and export"]
end

subgraph group_platform["Platform Services"]
  node_api["Backend API"]
  node_identity["Identity and access<br/>[models.py]"]
  node_iamcache["Access caches<br/>[cache_builders.py]"]
  node_settings["Global settings<br/>[models.py]"]
  node_startup["Platform initialization<br/>[startup.py]"]
end

subgraph group_intelligence["AI and Analytics"]
  node_chat["AI assistance"]
  node_knowledge["Knowledge graph<br/>[knowledge_graph.py]"]
  node_metrics[("Metrics and dashboards<br/>[models.py]")]
end

subgraph group_connectors["Automation and Integrations"]
  node_mcp["MCP tools"]
  node_mcpserver["MCP server<br/>[server.py]"]
  node_n8n["n8n connector"]
  node_integration["Integration framework<br/>[base.py]"]
  node_integrationdata[("Integration records<br/>[models.py]")]
  node_registry["Integration registry<br/>[registry.py]"]
  node_sync["Sync tasks<br/>[tasks.py]"]
  node_itsm["Jira and ServiceNow"]
end

node_user(("Practitioner"))
node_external(("External systems"))

node_user -->|"uses"| node_web
node_web -->|"requests API"| node_api
node_api -.->|"checks access"| node_identity
node_identity -->|"builds caches"| node_iamcache
node_iamcache -->|"invalidated by"| node_identity
node_api -.->|"manages records"| node_domainmodels
node_domainmodels -->|"extends"| node_base
node_domainmodels -->|"reads settings"| node_settings
node_mapping -->|"maps assessments"| node_domainmodels
node_startup -->|"initializes"| node_mapping
node_startup -->|"initializes"| node_domainmodels
node_startup -->|"initializes"| node_tprm
node_chat -->|"uses graph"| node_knowledge
node_chat -->|"queries records"| node_domainmodels
node_metrics -->|"references records"| node_domainmodels
node_user -.->|"invokes tools"| node_mcpserver
node_mcpserver -->|"registers tools"| node_mcp
node_mcp -.->|"uses API"| node_api
node_n8n -.->|"calls API"| node_api
node_sync -->|"loads configuration"| node_integrationdata
node_sync -->|"gets orchestrator"| node_registry
node_sync -->|"dispatches sync"| node_itsm
node_itsm -.->|"synchronizes"| node_external
node_integration -->|"uses records"| node_integrationdata
node_user -.->|"imports or exports"| node_importexport

click node_web "https://github.com/aritonangjos/ciso-assistant-community/tree/main/frontend/src"
click node_api "https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend"
click node_identity "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/iam/models.py"
click node_iamcache "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/iam/cache_builders.py"
click node_settings "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/global_settings/models.py"
click node_domainmodels "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/models.py"
click node_base "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/base_models.py"
click node_mapping "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/mappings/engine.py"
click node_startup "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/startup.py"
click node_tprm "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/tprm/models.py"
click node_chat "https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend/chat"
click node_knowledge "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/chat/knowledge_graph.py"
click node_metrics "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/metrology/models.py"
click node_importexport "https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend/data_wizard"
click node_mcp "https://github.com/aritonangjos/ciso-assistant-community/tree/main/cli/ca_mcp/tools"
click node_mcpserver "https://github.com/aritonangjos/ciso-assistant-community/blob/main/cli/ca_mcp/server.py"
click node_n8n "https://github.com/aritonangjos/ciso-assistant-community/blob/main/automation/n8n/n8n-nodes-ca/nodes/CisoAssistantService.node.ts"
click node_integration "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/base.py"
click node_integrationdata "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/models.py"
click node_registry "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/registry.py"
click node_sync "https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/tasks.py"
click node_itsm "https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend/integrations/itsm"

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_web toneBlue
class node_domainmodels,node_base,node_mapping,node_tprm,node_importexport toneAmber
class node_api,node_identity,node_iamcache,node_settings,node_startup toneMint
class node_chat,node_knowledge,node_metrics toneRose
class node_mcp,node_mcpserver,node_n8n,node_integration,node_integrationdata,node_registry,node_sync,node_itsm,node_user,node_external toneIndigo
```

## Components

### User Experience

- [Web application](https://github.com/aritonangjos/ciso-assistant-community/tree/main/frontend/src): `frontend/src`

### GRC Domain

- [GRC records](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/models.py): `backend/core/models.py`
- [Shared model layer](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/base_models.py): `backend/core/base_models.py`
- [Framework mapping](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/mappings/engine.py): `backend/core/mappings/engine.py`
- [Third-party risk](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/tprm/models.py): `backend/tprm/models.py`
- [Import and export](https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend/data_wizard): `backend/data_wizard`

### Platform Services

- [Backend API](https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend): `backend`
- [Identity and access](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/iam/models.py): `backend/iam/models.py`
- [Access caches](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/iam/cache_builders.py): `backend/iam/cache_builders.py`
- [Global settings](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/global_settings/models.py): `backend/global_settings/models.py`
- [Platform initialization](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/core/startup.py): `backend/core/startup.py`

### AI and Analytics

- [AI assistance](https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend/chat): `backend/chat`
- [Knowledge graph](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/chat/knowledge_graph.py): `backend/chat/knowledge_graph.py`
- [Metrics and dashboards](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/metrology/models.py): `backend/metrology/models.py`

### Automation and Integrations

- [MCP tools](https://github.com/aritonangjos/ciso-assistant-community/tree/main/cli/ca_mcp/tools): `cli/ca_mcp/tools`
- [MCP server](https://github.com/aritonangjos/ciso-assistant-community/blob/main/cli/ca_mcp/server.py): `cli/ca_mcp/server.py`
- [n8n connector](https://github.com/aritonangjos/ciso-assistant-community/blob/main/automation/n8n/n8n-nodes-ca/nodes/CisoAssistantService.node.ts): `automation/n8n/n8n-nodes-ca/nodes/CisoAssistantService.node.ts`
- [Integration framework](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/base.py): `backend/integrations/base.py`
- [Integration records](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/models.py): `backend/integrations/models.py`
- [Integration registry](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/registry.py): `backend/integrations/registry.py`
- [Sync tasks](https://github.com/aritonangjos/ciso-assistant-community/blob/main/backend/integrations/tasks.py): `backend/integrations/tasks.py`
- [Jira and ServiceNow](https://github.com/aritonangjos/ciso-assistant-community/tree/main/backend/integrations/itsm): `backend/integrations/itsm`

### Other components

- **Practitioner**
- **External systems**

## Connections

- Practitioner → Web application: uses
- Web application → Backend API: requests API
- Backend API → Identity and access: checks access (evidence: `backend/chat/orm_query.py`)
- Identity and access → Access caches: builds caches (evidence: `backend/iam/cache_builders.py`)
- Access caches → Identity and access: invalidated by (evidence: `backend/iam/cache_builders.py`)
- Backend API → GRC records: manages records (evidence: `backend/core/mappings/engine.py`)
- GRC records → Shared model layer: extends (evidence: `backend/core/models.py`)
- GRC records → Global settings: reads settings (evidence: `backend/core/models.py`)
- Framework mapping → GRC records: maps assessments (evidence: `backend/core/mappings/engine.py`)
- Platform initialization → Framework mapping: initializes (evidence: `backend/core/startup.py`)
- Platform initialization → GRC records: initializes (evidence: `backend/core/startup.py`)
- Platform initialization → Third-party risk: initializes (evidence: `backend/core/startup.py`)
- AI assistance → Knowledge graph: uses graph (evidence: `backend/chat/tools.py`)
- AI assistance → GRC records: queries records (evidence: `backend/chat/orm_query.py`)
- Metrics and dashboards → GRC records: references records (evidence: `backend/core/models.py`)
- Practitioner → MCP server: invokes tools
- MCP server → MCP tools: registers tools (evidence: `cli/ca_mcp/server.py`)
- MCP tools → Backend API: uses API
- n8n connector → Backend API: calls API
- Sync tasks → Integration records: loads configuration (evidence: `backend/integrations/tasks.py`)
- Sync tasks → Integration registry: gets orchestrator (evidence: `backend/integrations/tasks.py`)
- Sync tasks → Jira and ServiceNow: dispatches sync (evidence: `backend/integrations/tasks.py`)
- Jira and ServiceNow → External systems: synchronizes
- Integration framework → Integration records: uses records (evidence: `backend/integrations/base.py`)
- Practitioner → Import and export: imports or exports
