# sattyajeetmaharana/cyberguard architecture

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

- Interactive diagram: https://gitdiagram.com/sattyajeetmaharana/cyberguard
- Repository: https://github.com/sattyajeetmaharana/cyberguard

## Overview

CyberGuard is a cybersecurity monitoring and response platform: its backend accepts security activity, runs detection and risk/policy assessment, then coordinates scoring, incident handling, alerts, and response. Users access organization, threat, incident, and score views through a web portal; the repository also contains ML detector and inference components. The graph emphasizes documented backend orchestration and the web route structure. Other UI-to-API wiring and several listed capabilities are not evidenced by the sampled source, so those connections are omitted.

Main entry points: [`backend/app/pipeline/security_pipeline.py`](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/pipeline/security_pipeline.py) (Security pipeline), [`backend/app/api/v1`](https://github.com/sattyajeetmaharana/cyberguard/tree/main/backend/app/api/v1) (API endpoints), [`ml/detectors/account_takeover_detector.py`](https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/detectors/account_takeover_detector.py) (Account takeover), [`web/src/App.tsx`](https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/App.tsx) (Web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portal"]
  node_app["Web app<br/>[App.tsx]"]
  node_routes["Page routing<br/>[AppRoutes.tsx]"]
  node_views["Security views"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_api["Backend API"]
  node_server["Backend entry<br/>[main.py]"]
  node_api_router["API routing<br/>[router.py]"]
  node_api_endpoints["API endpoints"]
end

subgraph group_security["Security processing"]
  node_security_pipeline["Security pipeline"]
  node_orchestration["Alert orchestration<br/>[service.py]"]
  node_risk["Risk assessment<br/>[engine.py]"]
  node_policy["Policy evaluation<br/>[engine.py]"]
  node_incidents["Incident handling<br/>[service.py]"]
  node_response["Response actions<br/>[service.py]"]
  node_scoring["Security scoring<br/>[service.py]"]
  node_notifications["Notifications<br/>[service.py]"]
end

subgraph group_identity["Identity and data"]
  node_auth["Authentication<br/>[auth_service.py]"]
  node_context["Organization context"]
  node_models[("Persistent models")]
end

subgraph group_ml["ML detection"]
  node_detectors["Threat detectors"]
  node_ato_detector["Account takeover"]
  node_predictor["ATO inference<br/>[predictor.py]"]
  node_features["ATO features"]
  node_detection_contract["Detection result<br/>[detection.py]"]
end

node_user(("Portal user"))

node_user -->|"uses"| node_app
node_app -->|"renders routes"| node_routes
node_routes -->|"routes to"| node_views
node_views -.->|"requests data"| node_api_client
node_server -->|"mounts"| node_api_router
node_api_router -->|"registers"| node_api_endpoints
node_api_endpoints -.->|"dispatches"| node_security_pipeline
node_api_endpoints -.->|"uses authentication"| node_auth
node_api_endpoints -.->|"uses context"| node_context
node_security_pipeline -->|"assesses risk"| node_risk
node_security_pipeline -->|"evaluates policy"| node_policy
node_security_pipeline -->|"records score"| node_scoring
node_security_pipeline -->|"correlates incidents"| node_incidents
node_security_pipeline -->|"creates alerts"| node_orchestration
node_security_pipeline -->|"recommends actions"| node_response
node_security_pipeline -->|"notifies"| node_notifications
node_auth -->|"reads and writes"| node_models
node_context -->|"reads and writes"| node_models
node_ato_detector -->|"runs inference"| node_predictor
node_ato_detector -->|"returns detection"| node_detection_contract
node_predictor -->|"extracts features"| node_features
node_detectors -.->|"supplies detections"| node_security_pipeline

click node_app "https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/App.tsx"
click node_routes "https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/routes/AppRoutes.tsx"
click node_views "https://github.com/sattyajeetmaharana/cyberguard/tree/main/web/src/pages"
click node_api_client "https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/services/api.ts"
click node_server "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/main.py"
click node_api_router "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/api/router.py"
click node_api_endpoints "https://github.com/sattyajeetmaharana/cyberguard/tree/main/backend/app/api/v1"
click node_security_pipeline "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/pipeline/security_pipeline.py"
click node_orchestration "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/orchestration/service.py"
click node_risk "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/risk/engine.py"
click node_policy "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/policy/engine.py"
click node_incidents "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/incidents/service.py"
click node_response "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/response/service.py"
click node_scoring "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/scoring/service.py"
click node_notifications "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/notifications/service.py"
click node_auth "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/services/auth_service.py"
click node_context "https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/services/security_context_service.py"
click node_models "https://github.com/sattyajeetmaharana/cyberguard/tree/main/backend/app/db/models"
click node_detectors "https://github.com/sattyajeetmaharana/cyberguard/tree/main/ml/detectors"
click node_ato_detector "https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/detectors/account_takeover_detector.py"
click node_predictor "https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/inference/account_takeover/predictor.py"
click node_features "https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/preprocessing/account_takeover/feature_extractor.py"
click node_detection_contract "https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/common/detection.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_app,node_routes,node_views,node_api_client,node_user toneBlue
class node_server,node_api_router,node_api_endpoints toneAmber
class node_security_pipeline,node_orchestration,node_risk,node_policy,node_incidents,node_response,node_scoring,node_notifications toneMint
class node_auth,node_context,node_models toneRose
class node_detectors,node_ato_detector,node_predictor,node_features,node_detection_contract toneIndigo
```

## Components

### Web portal

- [Web app](https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Page routing](https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/routes/AppRoutes.tsx): `web/src/routes/AppRoutes.tsx`
- [Security views](https://github.com/sattyajeetmaharana/cyberguard/tree/main/web/src/pages): `web/src/pages`
- [API client](https://github.com/sattyajeetmaharana/cyberguard/blob/main/web/src/services/api.ts): `web/src/services/api.ts`

### Backend API

- [Backend entry](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/main.py): `backend/app/main.py`
- [API routing](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/api/router.py): `backend/app/api/router.py`
- [API endpoints](https://github.com/sattyajeetmaharana/cyberguard/tree/main/backend/app/api/v1): `backend/app/api/v1`

### Security processing

- [Security pipeline](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/pipeline/security_pipeline.py): `backend/app/pipeline/security_pipeline.py`
- [Alert orchestration](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/orchestration/service.py): `backend/app/orchestration/service.py`
- [Risk assessment](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/risk/engine.py): `backend/app/risk/engine.py`
- [Policy evaluation](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/policy/engine.py): `backend/app/policy/engine.py`
- [Incident handling](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/incidents/service.py): `backend/app/incidents/service.py`
- [Response actions](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/response/service.py): `backend/app/response/service.py`
- [Security scoring](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/scoring/service.py): `backend/app/scoring/service.py`
- [Notifications](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/notifications/service.py): `backend/app/notifications/service.py`

### Identity and data

- [Authentication](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Organization context](https://github.com/sattyajeetmaharana/cyberguard/blob/main/backend/app/services/security_context_service.py): `backend/app/services/security_context_service.py`
- [Persistent models](https://github.com/sattyajeetmaharana/cyberguard/tree/main/backend/app/db/models): `backend/app/db/models`

### ML detection

- [Threat detectors](https://github.com/sattyajeetmaharana/cyberguard/tree/main/ml/detectors): `ml/detectors`
- [Account takeover](https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/detectors/account_takeover_detector.py): `ml/detectors/account_takeover_detector.py`
- [ATO inference](https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/inference/account_takeover/predictor.py): `ml/inference/account_takeover/predictor.py`
- [ATO features](https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/preprocessing/account_takeover/feature_extractor.py): `ml/preprocessing/account_takeover/feature_extractor.py`
- [Detection result](https://github.com/sattyajeetmaharana/cyberguard/blob/main/ml/common/detection.py): `ml/common/detection.py`

### Other components

- **Portal user**

## Connections

- Portal user → Web app: uses
- Web app → Page routing: renders routes (evidence: `web/src/App.tsx`)
- Page routing → Security views: routes to (evidence: `web/src/routes/AppRoutes.tsx`)
- Security views → API client: requests data
- Backend entry → API routing: mounts (evidence: `backend/app/main.py`)
- API routing → API endpoints: registers (evidence: `backend/app/api/router.py`)
- API endpoints → Security pipeline: dispatches
- API endpoints → Authentication: uses authentication
- API endpoints → Organization context: uses context
- Security pipeline → Risk assessment: assesses risk (evidence: `backend/app/pipeline/security_pipeline.py`)
- Security pipeline → Policy evaluation: evaluates policy (evidence: `backend/app/pipeline/security_pipeline.py`)
- Security pipeline → Security scoring: records score (evidence: `backend/app/pipeline/security_pipeline.py`)
- Security pipeline → Incident handling: correlates incidents (evidence: `backend/app/pipeline/security_pipeline.py`)
- Security pipeline → Alert orchestration: creates alerts (evidence: `backend/app/pipeline/security_pipeline.py`)
- Security pipeline → Response actions: recommends actions (evidence: `backend/app/pipeline/security_pipeline.py`)
- Security pipeline → Notifications: notifies (evidence: `backend/app/pipeline/security_pipeline.py`)
- Authentication → Persistent models: reads and writes (evidence: `backend/app/services/auth_service.py`)
- Organization context → Persistent models: reads and writes (evidence: `backend/app/services/security_context_service.py`)
- Account takeover → ATO inference: runs inference (evidence: `ml/detectors/account_takeover_detector.py`)
- Account takeover → Detection result: returns detection (evidence: `ml/detectors/account_takeover_detector.py`)
- ATO inference → ATO features: extracts features (evidence: `ml/inference/account_takeover/predictor.py`)
- Threat detectors → Security pipeline: supplies detections
