# utkarshsomvanshi45/safevision-ai architecture

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

- Interactive diagram: https://gitdiagram.com/utkarshsomvanshi45/safevision-ai
- Repository: https://github.com/utkarshsomvanshi45/safevision-ai

## Overview

SafeVision AI monitors plant cameras for PPE and zone-safety violations, then records incidents and delivers alerts for operators to review. The documented flow runs per-camera detection, confirms violations across consecutive frames, and saves violation, alert, and compliance records while broadcasting updates; the UI also supports live feeds, review, analytics, reports, and configuration. Edges follow the README, excerpts, or SOURCE INDEX references; several frontend-to-backend and unsampled feature links are omitted where their call paths are not shown.

Main entry points: [`backend/app/main.py`](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/main.py) (API & Pipeline Startup), [`backend/app/ai/pipeline.py`](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/ai/pipeline.py) (Detection Pipeline), [`backend/app/api/cameras.py`](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/cameras.py) (Camera Control & Feed), [`backend/app/database/database.py`](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/database/database.py) (Database Session Layer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitoring["Detection &amp; Monitoring"]
  node_pipeline["Detection Pipeline<br/>[pipeline.py]"]
end

subgraph group_backend["Backend Services"]
  node_camera_api["Camera Control &amp; Feed<br/>[cameras.py]"]
  node_violations_api["Violation Records<br/>[violations.py]"]
  node_alerts_api["Alert Management<br/>[alerts.py]"]
  node_compliance_api["Compliance Review<br/>[compliance.py]"]
  node_dashboard_api["Dashboard &amp; Analytics<br/>[dashboard.py]"]
  node_settings_api["Safety Settings<br/>[settings.py]"]
  node_recipients_api["Alert Recipients<br/>[recipients.py]"]
  node_email["Email Alerts<br/>[email_sender.py]"]
  node_ws_manager["Realtime Broadcasts<br/>[manager.py]"]
  node_database["Database Session Layer<br/>[database.py]"]
  node_models["Domain Records<br/>[models.py]"]
  node_main["API &amp; Pipeline Startup<br/>[main.py]"]
  node_settings["Runtime Configuration<br/>[config.py]"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth_routes["Login &amp; User Admin<br/>[routes.py]"]
  node_jwt["JWT &amp; Passwords<br/>[jwt_handler.py]"]
  node_auth_deps["Auth Dependencies<br/>[dependencies.py]"]
end

subgraph group_frontend["Operator Console"]
  node_live_ui["Live Monitoring<br/>[live.tsx]"]
  node_alerts_ui["Alert Review<br/>[alerts.tsx]"]
  node_compliance_ui["Snapshot Review<br/>[compliance.tsx]"]
  node_dashboard_ui["Dashboard<br/>[dashboard.tsx]"]
  node_reports_ui["Reports<br/>[reports.tsx]"]
  node_settings_ui["Cameras &amp; Zones<br/>[settings.tsx]"]
  node_zones_ui["Zone Control<br/>[zones.tsx]"]
  node_login_ui["Sign In<br/>[login.tsx]"]
  node_analytics_ui["PPE Analytics<br/>[analytics.tsx]"]
  node_incidents_ui["Incident Tracking<br/>[incidents.tsx]"]
end

node_operator(("Safety Operator"))
node_cameras["Plant Cameras"]

node_cameras -->|"supply video"| node_pipeline
node_main -->|"starts camera threads"| node_pipeline
node_pipeline -->|"records detections"| node_models
node_pipeline -->|"opens session"| node_database
node_pipeline -->|"sends alert"| node_email
node_pipeline -->|"broadcasts violation"| node_ws_manager
node_pipeline -.->|"shares camera frames"| node_camera_api
node_models -->|"uses declarative base"| node_database
node_main -->|"registers router"| node_camera_api
node_main -->|"registers router"| node_violations_api
node_main -->|"registers router"| node_alerts_api
node_main -->|"registers router"| node_compliance_api
node_main -->|"registers router"| node_dashboard_api
node_main -->|"registers router"| node_settings_api
node_main -->|"registers router"| node_recipients_api
node_main -->|"registers router"| node_auth_routes
node_main -->|"creates tables"| node_database
node_main -->|"registers WebSocket route"| node_ws_manager
node_auth_routes -->|"uses token helpers"| node_jwt
node_auth_routes -->|"sends invite email"| node_email
node_auth_deps -->|"decodes tokens"| node_jwt
node_auth_deps -->|"loads user session"| node_database
node_camera_api -->|"controls pipeline"| node_pipeline
node_operator -->|"signs in"| node_login_ui
node_operator -->|"views feeds"| node_live_ui
node_operator -->|"reviews alerts"| node_alerts_ui
node_operator -->|"reviews snapshots"| node_compliance_ui
node_operator -->|"monitors status"| node_dashboard_ui
node_operator -->|"views reports"| node_reports_ui
node_operator -->|"configures cameras"| node_settings_ui
node_operator -->|"edits zones"| node_zones_ui
node_operator -->|"reviews analytics"| node_analytics_ui
node_operator -->|"tracks incidents"| node_incidents_ui
node_live_ui -.->|"requests live feed"| node_camera_api
node_alerts_ui -.->|"manages alerts"| node_alerts_api
node_compliance_ui -.->|"reviews snapshots"| node_compliance_api
node_dashboard_ui -.->|"requests metrics"| node_dashboard_api
node_settings_ui -.->|"manages cameras"| node_camera_api
node_ws_manager -->|"pushes live events"| node_operator
node_settings_api -.->|"reads configuration"| node_settings
node_email -->|"reads mail settings"| node_settings

click node_pipeline "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/ai/pipeline.py"
click node_camera_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/cameras.py"
click node_violations_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/violations.py"
click node_alerts_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/alerts.py"
click node_compliance_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/compliance.py"
click node_dashboard_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/dashboard.py"
click node_settings_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/settings.py"
click node_recipients_api "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/recipients.py"
click node_email "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/alerts/email_sender.py"
click node_ws_manager "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/websocket/manager.py"
click node_database "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/database/database.py"
click node_models "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/models/models.py"
click node_main "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/auth/routes.py"
click node_jwt "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/auth/jwt_handler.py"
click node_auth_deps "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/auth/dependencies.py"
click node_live_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/live.tsx"
click node_alerts_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/alerts.tsx"
click node_compliance_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/compliance.tsx"
click node_dashboard_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/dashboard.tsx"
click node_reports_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/reports.tsx"
click node_settings_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/settings.tsx"
click node_zones_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/zones.tsx"
click node_login_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/login.tsx"
click node_analytics_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/analytics.tsx"
click node_incidents_ui "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/incidents.tsx"
click node_settings "https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/core/config.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_pipeline toneBlue
class node_camera_api,node_violations_api,node_alerts_api,node_compliance_api,node_dashboard_api,node_settings_api,node_recipients_api,node_email,node_ws_manager,node_database,node_models,node_main,node_settings toneAmber
class node_auth_routes,node_jwt,node_auth_deps toneMint
class node_live_ui,node_alerts_ui,node_compliance_ui,node_dashboard_ui,node_reports_ui,node_settings_ui,node_zones_ui,node_login_ui,node_analytics_ui,node_incidents_ui toneRose
class node_operator,node_cameras toneIndigo
```

## Components

### Detection & Monitoring

- [Detection Pipeline](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/ai/pipeline.py): `backend/app/ai/pipeline.py`

### Backend Services

- [Camera Control & Feed](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/cameras.py): `backend/app/api/cameras.py`
- [Violation Records](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/violations.py): `backend/app/api/violations.py`
- [Alert Management](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/alerts.py): `backend/app/api/alerts.py`
- [Compliance Review](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/compliance.py): `backend/app/api/compliance.py`
- [Dashboard & Analytics](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/dashboard.py): `backend/app/api/dashboard.py`
- [Safety Settings](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/settings.py): `backend/app/api/settings.py`
- [Alert Recipients](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/api/recipients.py): `backend/app/api/recipients.py`
- [Email Alerts](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/alerts/email_sender.py): `backend/app/alerts/email_sender.py`
- [Realtime Broadcasts](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/websocket/manager.py): `backend/app/websocket/manager.py`
- [Database Session Layer](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/database/database.py): `backend/app/database/database.py`
- [Domain Records](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/models/models.py): `backend/app/models/models.py`
- [API & Pipeline Startup](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/main.py): `backend/app/main.py`
- [Runtime Configuration](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/core/config.py): `backend/app/core/config.py`

### Identity & Access

- [Login & User Admin](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/auth/routes.py): `backend/app/auth/routes.py`
- [JWT & Passwords](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/auth/jwt_handler.py): `backend/app/auth/jwt_handler.py`
- [Auth Dependencies](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/backend/app/auth/dependencies.py): `backend/app/auth/dependencies.py`

### Operator Console

- [Live Monitoring](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/live.tsx): `frontend/src/routes/live.tsx`
- [Alert Review](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/alerts.tsx): `frontend/src/routes/alerts.tsx`
- [Snapshot Review](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/compliance.tsx): `frontend/src/routes/compliance.tsx`
- [Dashboard](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/dashboard.tsx): `frontend/src/routes/dashboard.tsx`
- [Reports](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/reports.tsx): `frontend/src/routes/reports.tsx`
- [Cameras & Zones](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/settings.tsx): `frontend/src/routes/settings.tsx`
- [Zone Control](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/zones.tsx): `frontend/src/routes/zones.tsx`
- [Sign In](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/login.tsx): `frontend/src/routes/login.tsx`
- [PPE Analytics](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/analytics.tsx): `frontend/src/routes/analytics.tsx`
- [Incident Tracking](https://github.com/utkarshsomvanshi45/safevision-ai/blob/main/frontend/src/routes/incidents.tsx): `frontend/src/routes/incidents.tsx`

### Other components

- **Safety Operator**
- **Plant Cameras**

## Connections

- Plant Cameras → Detection Pipeline: supply video
- API & Pipeline Startup → Detection Pipeline: starts camera threads (evidence: `backend/app/main.py`)
- Detection Pipeline → Domain Records: records detections (evidence: `backend/app/ai/pipeline.py`)
- Detection Pipeline → Database Session Layer: opens session (evidence: `backend/app/ai/pipeline.py`)
- Detection Pipeline → Email Alerts: sends alert (evidence: `backend/app/ai/pipeline.py`)
- Detection Pipeline → Realtime Broadcasts: broadcasts violation (evidence: `backend/app/ai/pipeline.py`)
- Detection Pipeline → Camera Control & Feed: shares camera frames (evidence: `backend/app/api/cameras.py`)
- Domain Records → Database Session Layer: uses declarative base (evidence: `backend/app/models/models.py`)
- API & Pipeline Startup → Camera Control & Feed: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Violation Records: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Alert Management: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Compliance Review: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Dashboard & Analytics: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Safety Settings: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Alert Recipients: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Login & User Admin: registers router (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Database Session Layer: creates tables (evidence: `backend/app/main.py`)
- API & Pipeline Startup → Realtime Broadcasts: registers WebSocket route (evidence: `backend/app/main.py`)
- Login & User Admin → JWT & Passwords: uses token helpers (evidence: `backend/app/auth/routes.py`)
- Login & User Admin → Email Alerts: sends invite email (evidence: `backend/app/auth/routes.py`)
- Auth Dependencies → JWT & Passwords: decodes tokens (evidence: `backend/app/auth/dependencies.py`)
- Auth Dependencies → Database Session Layer: loads user session (evidence: `backend/app/auth/dependencies.py`)
- Camera Control & Feed → Detection Pipeline: controls pipeline (evidence: `backend/app/api/cameras.py`)
- Safety Operator → Sign In: signs in
- Safety Operator → Live Monitoring: views feeds
- Safety Operator → Alert Review: reviews alerts
- Safety Operator → Snapshot Review: reviews snapshots
- Safety Operator → Dashboard: monitors status
- Safety Operator → Reports: views reports
- Safety Operator → Cameras & Zones: configures cameras
- Safety Operator → Zone Control: edits zones
- Safety Operator → PPE Analytics: reviews analytics
- Safety Operator → Incident Tracking: tracks incidents
- Live Monitoring → Camera Control & Feed: requests live feed
- Alert Review → Alert Management: manages alerts
- Snapshot Review → Compliance Review: reviews snapshots
- Dashboard → Dashboard & Analytics: requests metrics
- Cameras & Zones → Camera Control & Feed: manages cameras
- Realtime Broadcasts → Safety Operator: pushes live events (evidence: `backend/app/websocket/manager.py`)
- Safety Settings → Runtime Configuration: reads configuration
- Email Alerts → Runtime Configuration: reads mail settings (evidence: `backend/app/alerts/email_sender.py`)
