How utkarshsomvanshi45/safevision-ai works
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: main.py API & Pipeline Startup · pipeline.py Detection Pipeline · cameras.py Camera Control & Feed · database.py Database Session Layer
Components 29
Detection & Monitoring
- Detection Pipeline
backend/app/ai/pipeline.py
Backend Services
- Camera Control & Feed
backend/app/api/cameras.py - Violation Records
backend/app/api/violations.py - Alert Management
backend/app/api/alerts.py - Compliance Review
backend/app/api/compliance.py - Dashboard & Analytics
backend/app/api/dashboard.py - Safety Settings
backend/app/api/settings.py - Alert Recipients
backend/app/api/recipients.py - Email Alerts
backend/app/alerts/email_sender.py - Realtime Broadcasts
backend/app/websocket/manager.py - Database Session Layer
backend/app/database/database.py - Domain Records
backend/app/models/models.py - API & Pipeline Startup
backend/app/main.py - Runtime Configuration
backend/app/core/config.py
Identity & Access
- Login & User Admin
backend/app/auth/routes.py - JWT & Passwords
backend/app/auth/jwt_handler.py - Auth Dependencies
backend/app/auth/dependencies.py
Operator Console
- Live Monitoring
frontend/src/routes/live.tsx - Alert Review
frontend/src/routes/alerts.tsx - Snapshot Review
frontend/src/routes/compliance.tsx - Dashboard
frontend/src/routes/dashboard.tsx - Reports
frontend/src/routes/reports.tsx - Cameras & Zones
frontend/src/routes/settings.tsx - Zone Control
frontend/src/routes/zones.tsx - Sign In
frontend/src/routes/login.tsx - PPE Analytics
frontend/src/routes/analytics.tsx - Incident Tracking
frontend/src/routes/incidents.tsx
Other components
- Safety Operator
- Plant Cameras
Connections 41
- Plant Cameras → Detection Pipeline: supply video
- API & Pipeline Startup → Detection Pipeline: starts camera threads
backend/app/main.py - Detection Pipeline → Domain Records: records detections
backend/app/ai/pipeline.py - Detection Pipeline → Database Session Layer: opens session
backend/app/ai/pipeline.py - Detection Pipeline → Email Alerts: sends alert
backend/app/ai/pipeline.py - Detection Pipeline → Realtime Broadcasts: broadcasts violation
backend/app/ai/pipeline.py - Detection Pipeline → Camera Control & Feed: shares camera frames
backend/app/api/cameras.py - Domain Records → Database Session Layer: uses declarative base
backend/app/models/models.py - API & Pipeline Startup → Camera Control & Feed: registers router
backend/app/main.py - API & Pipeline Startup → Violation Records: registers router
backend/app/main.py - API & Pipeline Startup → Alert Management: registers router
backend/app/main.py - API & Pipeline Startup → Compliance Review: registers router
backend/app/main.py - API & Pipeline Startup → Dashboard & Analytics: registers router
backend/app/main.py - API & Pipeline Startup → Safety Settings: registers router
backend/app/main.py - API & Pipeline Startup → Alert Recipients: registers router
backend/app/main.py - API & Pipeline Startup → Login & User Admin: registers router
backend/app/main.py - API & Pipeline Startup → Database Session Layer: creates tables
backend/app/main.py - API & Pipeline Startup → Realtime Broadcasts: registers WebSocket route
backend/app/main.py - Login & User Admin → JWT & Passwords: uses token helpers
backend/app/auth/routes.py - Login & User Admin → Email Alerts: sends invite email
backend/app/auth/routes.py - Auth Dependencies → JWT & Passwords: decodes tokens
backend/app/auth/dependencies.py - Auth Dependencies → Database Session Layer: loads user session
backend/app/auth/dependencies.py - Camera Control & Feed → Detection Pipeline: controls pipeline
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
backend/app/websocket/manager.py - Safety Settings → Runtime Configuration: reads configuration
- Email Alerts → Runtime Configuration: reads mail settings
backend/app/alerts/email_sender.py