# itamar-raanan/sec360 architecture

> Architecture diagram of the GitHub repository itamar-raanan/sec360, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/itamar-raanan/sec360
- Repository: https://github.com/itamar-raanan/sec360

## Overview

SEC360 is a self-hosted security visibility, posture-management, and audit platform. Analysts use its React interface to authenticate and inspect correlated identity, endpoint, compliance, risk, activity, vulnerability, DLP, Linux audit, proxy-policy, and network-topology data; administrators configure integrations and settings. Backend collection and evaluation persist inventory and evidence in PostgreSQL, with optional SIEM delivery. The repository also includes an on-premises Network Map collector and a read-only MCP interface. Relationships for unsampled feature modules follow README descriptions; omitted source details limit more specific call-flow claims.

Main entry points: [`backend/app/core/database.py`](https://github.com/itamar-raanan/sec360/blob/main/backend/app/core/database.py) (PostgreSQL state), [`backend/app/collectors/scheduler.py`](https://github.com/itamar-raanan/sec360/blob/main/backend/app/collectors/scheduler.py) (Collection scheduler), [`frontend/src/api/client.ts`](https://github.com/itamar-raanan/sec360/blob/main/frontend/src/api/client.ts) (API client), [`backend/app/api/routes`](https://github.com/itamar-raanan/sec360/tree/main/backend/app/api/routes) (Feature APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Analyst interface"]
  node_spa["Web application<br/>[App.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
end

subgraph group_api["Backend API"]
  node_auth_api["Authentication<br/>[auth.py]"]
  node_api_deps["Authorization layer<br/>[deps.py]"]
  node_feature_routes["Feature APIs"]
  node_integration_api["Integration management<br/>[integrations.py]"]
end

subgraph group_collection["Collection and analysis"]
  node_scheduler["Collection scheduler<br/>[scheduler.py]"]
  node_integration_collectors["Integration collectors"]
  node_correlation["Correlation engine<br/>[correlation.py]"]
  node_compliance["Compliance engine<br/>[compliance.py]"]
  node_risk["Risk engine<br/>[risk.py]"]
  node_network_service["Network Map service<br/>[service.py]"]
end

subgraph group_state["State and audit"]
  node_database[("PostgreSQL state<br/>[database.py]")]
  node_domain_models["Inventory and evidence"]
  node_siem["SIEM delivery<br/>[siem.py]"]
end

subgraph group_extensions["Optional interfaces"]
  node_network_collector["On-prem collector<br/>[main.py]"]
  node_mcp["Read-only MCP server<br/>[server.py]"]
end

node_analyst(("Analyst"))
node_siem_endpoint(("SIEM endpoint"))
node_network_sources(("Network devices"))

node_analyst -->|"uses"| node_spa
node_spa -.->|"requests data"| node_api_client
node_api_client -->|"refreshes session"| node_auth_api
node_api_client -.->|"calls API"| node_feature_routes
node_feature_routes -->|"authorizes requests"| node_api_deps
node_integration_api -.->|"starts sync"| node_scheduler
node_scheduler -->|"runs collectors"| node_integration_collectors
node_integration_collectors -->|"stores collected data"| node_database
node_scheduler -->|"runs correlation"| node_correlation
node_scheduler -->|"evaluates compliance"| node_compliance
node_scheduler -->|"calculates risk"| node_risk
node_correlation -->|"updates inventory"| node_database
node_compliance -->|"stores results"| node_database
node_risk -->|"stores scores"| node_database
node_database -->|"persists"| node_domain_models
node_network_sources -->|"provides snapshots"| node_network_collector
node_network_collector -->|"pushes snapshots"| node_network_service
node_network_service -->|"installs snapshot"| node_database
node_database -->|"queues audit events"| node_siem
node_siem -->|"forwards events"| node_siem_endpoint
node_mcp -->|"queries read-only API"| node_feature_routes

click node_spa "https://github.com/itamar-raanan/sec360/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/itamar-raanan/sec360/blob/main/frontend/src/api/client.ts"
click node_auth_api "https://github.com/itamar-raanan/sec360/blob/main/backend/app/api/routes/auth.py"
click node_api_deps "https://github.com/itamar-raanan/sec360/blob/main/backend/app/api/deps.py"
click node_feature_routes "https://github.com/itamar-raanan/sec360/tree/main/backend/app/api/routes"
click node_integration_api "https://github.com/itamar-raanan/sec360/blob/main/backend/app/api/routes/integrations.py"
click node_scheduler "https://github.com/itamar-raanan/sec360/blob/main/backend/app/collectors/scheduler.py"
click node_integration_collectors "https://github.com/itamar-raanan/sec360/tree/main/backend/app/collectors"
click node_correlation "https://github.com/itamar-raanan/sec360/blob/main/backend/app/engines/correlation.py"
click node_compliance "https://github.com/itamar-raanan/sec360/blob/main/backend/app/engines/compliance.py"
click node_risk "https://github.com/itamar-raanan/sec360/blob/main/backend/app/engines/risk.py"
click node_network_service "https://github.com/itamar-raanan/sec360/blob/main/backend/app/network_map/service.py"
click node_database "https://github.com/itamar-raanan/sec360/blob/main/backend/app/core/database.py"
click node_domain_models "https://github.com/itamar-raanan/sec360/tree/main/backend/app/models"
click node_siem "https://github.com/itamar-raanan/sec360/blob/main/backend/app/services/siem.py"
click node_network_collector "https://github.com/itamar-raanan/sec360/blob/main/collector/sec360_collector/main.py"
click node_mcp "https://github.com/itamar-raanan/sec360/blob/main/mcp-server/sec360_mcp/server.py"

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_spa,node_api_client toneBlue
class node_auth_api,node_api_deps,node_feature_routes,node_integration_api toneAmber
class node_scheduler,node_integration_collectors,node_correlation,node_compliance,node_risk,node_network_service toneMint
class node_database,node_domain_models,node_siem toneRose
class node_network_collector,node_mcp,node_analyst,node_siem_endpoint,node_network_sources toneIndigo
```

## Components

### Analyst interface

- [Web application](https://github.com/itamar-raanan/sec360/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/itamar-raanan/sec360/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Backend API

- [Authentication](https://github.com/itamar-raanan/sec360/blob/main/backend/app/api/routes/auth.py): `backend/app/api/routes/auth.py`
- [Authorization layer](https://github.com/itamar-raanan/sec360/blob/main/backend/app/api/deps.py): `backend/app/api/deps.py`
- [Feature APIs](https://github.com/itamar-raanan/sec360/tree/main/backend/app/api/routes): `backend/app/api/routes`
- [Integration management](https://github.com/itamar-raanan/sec360/blob/main/backend/app/api/routes/integrations.py): `backend/app/api/routes/integrations.py`

### Collection and analysis

- [Collection scheduler](https://github.com/itamar-raanan/sec360/blob/main/backend/app/collectors/scheduler.py): `backend/app/collectors/scheduler.py`
- [Integration collectors](https://github.com/itamar-raanan/sec360/tree/main/backend/app/collectors): `backend/app/collectors`
- [Correlation engine](https://github.com/itamar-raanan/sec360/blob/main/backend/app/engines/correlation.py): `backend/app/engines/correlation.py`
- [Compliance engine](https://github.com/itamar-raanan/sec360/blob/main/backend/app/engines/compliance.py): `backend/app/engines/compliance.py`
- [Risk engine](https://github.com/itamar-raanan/sec360/blob/main/backend/app/engines/risk.py): `backend/app/engines/risk.py`
- [Network Map service](https://github.com/itamar-raanan/sec360/blob/main/backend/app/network_map/service.py): `backend/app/network_map/service.py`

### State and audit

- [PostgreSQL state](https://github.com/itamar-raanan/sec360/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Inventory and evidence](https://github.com/itamar-raanan/sec360/tree/main/backend/app/models): `backend/app/models`
- [SIEM delivery](https://github.com/itamar-raanan/sec360/blob/main/backend/app/services/siem.py): `backend/app/services/siem.py`

### Optional interfaces

- [On-prem collector](https://github.com/itamar-raanan/sec360/blob/main/collector/sec360_collector/main.py): `collector/sec360_collector/main.py`
- [Read-only MCP server](https://github.com/itamar-raanan/sec360/blob/main/mcp-server/sec360_mcp/server.py): `mcp-server/sec360_mcp/server.py`

### Other components

- **Analyst**
- **SIEM endpoint**
- **Network devices**

## Connections

- Analyst → Web application: uses (evidence: `README.md`)
- Web application → API client: requests data
- API client → Authentication: refreshes session (evidence: `frontend/src/api/client.ts`)
- API client → Feature APIs: calls API
- Feature APIs → Authorization layer: authorizes requests (evidence: `backend/app/api/deps.py`)
- Integration management → Collection scheduler: starts sync
- Collection scheduler → Integration collectors: runs collectors (evidence: `README.md`)
- Integration collectors → PostgreSQL state: stores collected data (evidence: `README.md`)
- Collection scheduler → Correlation engine: runs correlation (evidence: `README.md`)
- Collection scheduler → Compliance engine: evaluates compliance (evidence: `README.md`)
- Collection scheduler → Risk engine: calculates risk (evidence: `README.md`)
- Correlation engine → PostgreSQL state: updates inventory (evidence: `README.md`)
- Compliance engine → PostgreSQL state: stores results (evidence: `README.md`)
- Risk engine → PostgreSQL state: stores scores (evidence: `README.md`)
- PostgreSQL state → Inventory and evidence: persists (evidence: `backend/app/core/database.py`)
- Network devices → On-prem collector: provides snapshots (evidence: `README.md`)
- On-prem collector → Network Map service: pushes snapshots (evidence: `README.md`)
- Network Map service → PostgreSQL state: installs snapshot (evidence: `backend/app/network_map/service.py`)
- PostgreSQL state → SIEM delivery: queues audit events (evidence: `backend/app/api/deps.py`)
- SIEM delivery → SIEM endpoint: forwards events (evidence: `README.md`)
- Read-only MCP server → Feature APIs: queries read-only API
