# shivanesh21/sentinelai architecture

> Architecture diagram of the GitHub repository shivanesh21/sentinelai, 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/shivanesh21/sentinelai
- Repository: https://github.com/shivanesh21/sentinelai

## Overview

SentinelAI is an incident-risk monitoring and response application, with a React dashboard backed by a FastAPI service. Users inspect service risk and model drift, or run an incident simulation that exercises risk assessment, root-cause analysis, remediation, and recovery verification. The backend also includes telemetry simulation and feature engineering, model/anomaly scoring, evidence assembly, and drift monitoring. The README contains only the product name, so capability coverage relies on the source index and shown excerpts; several backend internals are unsampled, and their runtime links are omitted where not evidenced.

Main entry points: [`client/src/App.jsx`](https://github.com/shivanesh21/sentinelai/blob/main/client/src/App.jsx) (Dashboard shell), [`backend/src/pipeline/e2e.py`](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/pipeline/e2e.py) (Incident pipeline), [`backend/src/api/main.py`](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/api/main.py) (HTTP API), [`client/src/api.js`](https://github.com/shivanesh21/sentinelai/blob/main/client/src/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard"]
  node_app["Dashboard shell<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_overview["Overview<br/>[OverviewTab.jsx]"]
  node_risk_view["Risk view<br/>[RiskTab.jsx]"]
  node_pipeline_view["Pipeline view<br/>[PipelineTab.jsx]"]
  node_incident_view["Incidents view<br/>[IncidentsTab.jsx]"]
  node_remediation_view["Remediation view<br/>[RemediationTab.jsx]"]
  node_models_view["Models view<br/>[ModelsTab.jsx]"]
  node_drift_view["Drift view<br/>[DriftTab.jsx]"]
  node_ui_components["UI components<br/>[ui.jsx]"]
end

subgraph group_api["API service"]
  node_backend_api["HTTP API<br/>[main.py]"]
  node_pipeline["Incident pipeline<br/>[e2e.py]"]
end

subgraph group_telemetry["Telemetry and features"]
  node_simulator["Telemetry simulator<br/>[generator.py]"]
  node_service_sim["Service metrics<br/>[service.py]"]
  node_scenario_defs["Failure scenarios"]
  node_feature_engineering["Feature engineering<br/>[engineering.py]"]
  node_feature_store[("Feature store<br/>[store.py]")]
end

subgraph group_intelligence["Risk and diagnosis"]
  node_anomaly["Anomaly detection<br/>[base.py]"]
  node_risk_engine["Risk scoring<br/>[engine.py]"]
  node_evidence["Evidence assembly<br/>[assembler.py]"]
  node_rca_client["RCA analysis<br/>[client.py]"]
  node_rca_heuristic["Heuristic diagnosis<br/>[heuristic.py]"]
  node_model_training["Model implementations<br/>[advanced.py]"]
end

subgraph group_response["Response and operations"]
  node_remediation["Remediation executor<br/>[executor.py]"]
  node_remediation_backend["Action backends<br/>[backends.py]"]
  node_recovery["Recovery verification<br/>[verifier.py]"]
  node_drift["Drift monitoring<br/>[drift.py]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_app
node_app -->|"renders"| node_overview
node_app -->|"renders"| node_risk_view
node_app -->|"renders"| node_pipeline_view
node_app -->|"renders"| node_incident_view
node_app -->|"renders"| node_remediation_view
node_app -->|"renders"| node_models_view
node_app -->|"renders"| node_drift_view
node_app -->|"fetches through"| node_api_client
node_risk_view -->|"scores via"| node_api_client
node_pipeline_view -->|"runs via"| node_api_client
node_drift_view -->|"checks via"| node_api_client
node_app -->|"uses"| node_ui_components
node_risk_view -->|"renders with"| node_ui_components
node_api_client -.->|"requests"| node_backend_api
node_backend_api -->|"runs"| node_pipeline
node_pipeline -->|"generates incidents"| node_simulator
node_simulator -->|"simulates services"| node_service_sim
node_simulator -->|"applies scenarios"| node_scenario_defs
node_feature_engineering -.->|"stores features"| node_feature_store
node_pipeline -->|"uses detection"| node_anomaly
node_pipeline -->|"scores risk"| node_risk_engine
node_backend_api -->|"scores requests"| node_risk_engine
node_backend_api -->|"assembles evidence"| node_evidence
node_evidence -->|"scores rows"| node_risk_engine
node_backend_api -.->|"analyzes evidence"| node_rca_client
node_rca_client -->|"falls back to"| node_rca_heuristic
node_rca_client -.->|"queries optional LLM"| node_operator
node_pipeline -->|"executes response"| node_remediation
node_remediation -->|"dispatches actions"| node_remediation_backend
node_pipeline -.->|"verifies recovery"| node_recovery
node_app -.->|"requests reports"| node_drift
node_risk_engine -->|"loads models"| node_model_training

click node_app "https://github.com/shivanesh21/sentinelai/blob/main/client/src/App.jsx"
click node_api_client "https://github.com/shivanesh21/sentinelai/blob/main/client/src/api.js"
click node_overview "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/OverviewTab.jsx"
click node_risk_view "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/RiskTab.jsx"
click node_pipeline_view "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/PipelineTab.jsx"
click node_incident_view "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/IncidentsTab.jsx"
click node_remediation_view "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/RemediationTab.jsx"
click node_models_view "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/ModelsTab.jsx"
click node_drift_view "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/DriftTab.jsx"
click node_ui_components "https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/ui.jsx"
click node_backend_api "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/api/main.py"
click node_pipeline "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/pipeline/e2e.py"
click node_simulator "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/telemetry/simulator/generator.py"
click node_service_sim "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/telemetry/simulator/service.py"
click node_scenario_defs "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/telemetry/simulator/failure_scenarios.py"
click node_feature_engineering "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/features/engineering.py"
click node_feature_store "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/features/store.py"
click node_anomaly "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/anomaly/base.py"
click node_risk_engine "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/risk/engine.py"
click node_evidence "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/evidence/assembler.py"
click node_rca_client "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/rca/client.py"
click node_rca_heuristic "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/rca/heuristic.py"
click node_remediation "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/remediation/executor.py"
click node_remediation_backend "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/remediation/backends.py"
click node_recovery "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/recovery/verifier.py"
click node_drift "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/mlops/drift.py"
click node_model_training "https://github.com/shivanesh21/sentinelai/blob/main/backend/src/models/advanced.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_api_client,node_overview,node_risk_view,node_pipeline_view,node_incident_view,node_remediation_view,node_models_view,node_drift_view,node_ui_components toneBlue
class node_backend_api,node_pipeline toneAmber
class node_simulator,node_service_sim,node_scenario_defs,node_feature_engineering,node_feature_store toneMint
class node_anomaly,node_risk_engine,node_evidence,node_rca_client,node_rca_heuristic,node_model_training toneRose
class node_remediation,node_remediation_backend,node_recovery,node_drift,node_operator toneIndigo
```

## Components

### Dashboard

- [Dashboard shell](https://github.com/shivanesh21/sentinelai/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [API client](https://github.com/shivanesh21/sentinelai/blob/main/client/src/api.js): `client/src/api.js`
- [Overview](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/OverviewTab.jsx): `client/src/components/OverviewTab.jsx`
- [Risk view](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/RiskTab.jsx): `client/src/components/RiskTab.jsx`
- [Pipeline view](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/PipelineTab.jsx): `client/src/components/PipelineTab.jsx`
- [Incidents view](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/IncidentsTab.jsx): `client/src/components/IncidentsTab.jsx`
- [Remediation view](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/RemediationTab.jsx): `client/src/components/RemediationTab.jsx`
- [Models view](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/ModelsTab.jsx): `client/src/components/ModelsTab.jsx`
- [Drift view](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/DriftTab.jsx): `client/src/components/DriftTab.jsx`
- [UI components](https://github.com/shivanesh21/sentinelai/blob/main/client/src/components/ui.jsx): `client/src/components/ui.jsx`

### API service

- [HTTP API](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/api/main.py): `backend/src/api/main.py`
- [Incident pipeline](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/pipeline/e2e.py): `backend/src/pipeline/e2e.py`

### Telemetry and features

- [Telemetry simulator](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/telemetry/simulator/generator.py): `backend/src/telemetry/simulator/generator.py`
- [Service metrics](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/telemetry/simulator/service.py): `backend/src/telemetry/simulator/service.py`
- [Failure scenarios](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/telemetry/simulator/failure_scenarios.py): `backend/src/telemetry/simulator/failure_scenarios.py`
- [Feature engineering](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/features/engineering.py): `backend/src/features/engineering.py`
- [Feature store](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/features/store.py): `backend/src/features/store.py`

### Risk and diagnosis

- [Anomaly detection](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/anomaly/base.py): `backend/src/anomaly/base.py`
- [Risk scoring](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/risk/engine.py): `backend/src/risk/engine.py`
- [Evidence assembly](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/evidence/assembler.py): `backend/src/evidence/assembler.py`
- [RCA analysis](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/rca/client.py): `backend/src/rca/client.py`
- [Heuristic diagnosis](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/rca/heuristic.py): `backend/src/rca/heuristic.py`
- [Model implementations](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/models/advanced.py): `backend/src/models/advanced.py`

### Response and operations

- [Remediation executor](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/remediation/executor.py): `backend/src/remediation/executor.py`
- [Action backends](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/remediation/backends.py): `backend/src/remediation/backends.py`
- [Recovery verification](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/recovery/verifier.py): `backend/src/recovery/verifier.py`
- [Drift monitoring](https://github.com/shivanesh21/sentinelai/blob/main/backend/src/mlops/drift.py): `backend/src/mlops/drift.py`

### Other components

- **Operator**

## Connections

- Operator → Dashboard shell: uses (evidence: `client/src/App.jsx`)
- Dashboard shell → Overview: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → Risk view: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → Pipeline view: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → Incidents view: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → Remediation view: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → Models view: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → Drift view: renders (evidence: `client/src/App.jsx`)
- Dashboard shell → API client: fetches through (evidence: `client/src/App.jsx`)
- Risk view → API client: scores via (evidence: `client/src/components/RiskTab.jsx`)
- Pipeline view → API client: runs via (evidence: `client/src/components/PipelineTab.jsx`)
- Drift view → API client: checks via (evidence: `client/src/components/DriftTab.jsx`)
- Dashboard shell → UI components: uses (evidence: `client/src/App.jsx`)
- Risk view → UI components: renders with (evidence: `client/src/components/RiskTab.jsx`)
- API client → HTTP API: requests
- HTTP API → Incident pipeline: runs (evidence: `backend/src/api/main.py`)
- Incident pipeline → Telemetry simulator: generates incidents (evidence: `backend/src/pipeline/e2e.py`)
- Telemetry simulator → Service metrics: simulates services (evidence: `backend/src/telemetry/simulator/generator.py`)
- Telemetry simulator → Failure scenarios: applies scenarios (evidence: `backend/src/telemetry/simulator/generator.py`)
- Feature engineering → Feature store: stores features
- Incident pipeline → Anomaly detection: uses detection (evidence: `backend/src/pipeline/e2e.py`)
- Incident pipeline → Risk scoring: scores risk (evidence: `backend/src/pipeline/e2e.py`)
- HTTP API → Risk scoring: scores requests (evidence: `backend/src/api/main.py`)
- HTTP API → Evidence assembly: assembles evidence (evidence: `backend/src/api/main.py`)
- Evidence assembly → Risk scoring: scores rows (evidence: `backend/src/evidence/assembler.py`)
- HTTP API → RCA analysis: analyzes evidence
- RCA analysis → Heuristic diagnosis: falls back to (evidence: `backend/src/rca/client.py`)
- RCA analysis → Operator: queries optional LLM
- Incident pipeline → Remediation executor: executes response (evidence: `backend/src/pipeline/e2e.py`)
- Remediation executor → Action backends: dispatches actions (evidence: `backend/src/remediation/executor.py`)
- Incident pipeline → Recovery verification: verifies recovery
- Dashboard shell → Drift monitoring: requests reports
- Risk scoring → Model implementations: loads models (evidence: `backend/src/risk/engine.py`)
