# eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system architecture

> Architecture diagram of the GitHub repository eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system
- Repository: https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system

## Overview

This repository presents an industrial PPE-safety monitoring product, with a React supervisor dashboard and an Express API. The visible camera workflow processes media through local person/PPE detection, then exposes camera, alert, worker, and reporting views; however, the sampled implementation does not establish the README’s full camera-to-IoT pipeline. The API’s worker route uses in-memory mock data, not the documented SQLite store. Dashboard pages and API route wiring are included where documented or indexed; unverified runtime integrations are omitted.

Main entry points: [`artifacts/safety-monitor/src/App.tsx`](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/App.tsx) (Application router), [`artifacts/safety-monitor/src/pages/cameras.tsx`](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/cameras.tsx) (Camera monitoring), [`artifacts/safety-monitor/src/pages/dashboard.tsx`](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/dashboard.tsx) (Live dashboard), [`artifacts/api-server/src/app.ts`](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/app.ts) (Express application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Supervisor dashboard"]
  node_app["Application router<br/>[App.tsx]"]
  node_workers_ui["Worker management<br/>[workers.tsx]"]
  node_cameras_ui["Camera monitoring<br/>[cameras.tsx]"]
  node_dashboard_ui["Live dashboard<br/>[dashboard.tsx]"]
  node_alerts_ui["Alerts<br/>[alerts.tsx]"]
  node_logs_ui["Warning logs<br/>[warning-logs.tsx]"]
  node_reports_ui["Reports<br/>[reports.tsx]"]
  node_zones_ui["Zones<br/>[zones.tsx]"]
  node_sensors_ui["Sensors<br/>[sensors.tsx]"]
  node_settings_ui["Settings<br/>[settings.tsx]"]
  node_auth_ui["Authentication<br/>[use-auth.tsx]"]
end

subgraph group_detection["Camera detection"]
  node_detection_model["Detection model loader<br/>[detection-model.ts]"]
  node_ppe_engine["PPE detection engine<br/>[ppe-detection.ts]"]
end

subgraph group_backend["API service"]
  node_api_app["Express application<br/>[app.ts]"]
  node_api_routes["REST route modules"]
  node_worker_route["Worker API<br/>[workers.ts]"]
  node_websocket["WebSocket service<br/>[websocket.ts]"]
end

subgraph group_state["Application state"]
  node_camera_state["Camera media state"]
  node_warning_state["Local warning state"]
  node_notification_state["Notification state"]
  node_mock_data[("In-memory records<br/>[mock-data.ts]")]
  node_sqlite[("SQLite database<br/>[index.ts]")]
end

node_supervisor(("Supervisor"))

node_supervisor -->|"uses"| node_app
node_app -->|"routes to"| node_workers_ui
node_app -->|"routes to"| node_cameras_ui
node_app -->|"routes to"| node_dashboard_ui
node_app -->|"routes to"| node_alerts_ui
node_app -->|"routes to"| node_logs_ui
node_app -->|"routes to"| node_reports_ui
node_app -->|"routes to"| node_zones_ui
node_app -->|"routes to"| node_sensors_ui
node_app -->|"routes to"| node_settings_ui
node_app -->|"provides auth"| node_auth_ui
node_app -->|"provides media"| node_camera_state
node_app -->|"provides logs"| node_warning_state
node_app -->|"provides notifications"| node_notification_state
node_cameras_ui -->|"runs detection"| node_ppe_engine
node_ppe_engine -->|"loads model"| node_detection_model
node_cameras_ui -->|"uses media"| node_camera_state
node_cameras_ui -->|"records warnings"| node_warning_state
node_cameras_ui -->|"adds notifications"| node_notification_state
node_dashboard_ui -->|"uses detections"| node_ppe_engine
node_dashboard_ui -->|"uses media"| node_camera_state
node_dashboard_ui -->|"uses warnings"| node_warning_state
node_dashboard_ui -->|"uses notifications"| node_notification_state
node_app -->|"serves API"| node_api_app
node_api_app -->|"mounts routes"| node_api_routes
node_api_routes -->|"registers workers"| node_worker_route
node_worker_route -->|"reads and updates"| node_mock_data
node_workers_ui -.->|"requests workers"| node_worker_route
node_api_app -.->|"streams updates"| node_websocket
node_api_app -.->|"persists records"| node_sqlite

click node_app "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/App.tsx"
click node_workers_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/workers.tsx"
click node_cameras_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/cameras.tsx"
click node_dashboard_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/dashboard.tsx"
click node_alerts_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/alerts.tsx"
click node_logs_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/warning-logs.tsx"
click node_reports_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/reports.tsx"
click node_zones_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/zones.tsx"
click node_sensors_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/sensors.tsx"
click node_settings_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/settings.tsx"
click node_auth_ui "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/hooks/use-auth.tsx"
click node_detection_model "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/lib/detection-model.ts"
click node_ppe_engine "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/lib/ppe-detection.ts"
click node_camera_state "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/context/camera-video-context.tsx"
click node_warning_state "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/context/local-warning-logs-context.tsx"
click node_notification_state "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/context/notification-context.tsx"
click node_api_app "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/app.ts"
click node_api_routes "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/tree/main/artifacts/api-server/src/routes"
click node_worker_route "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/routes/workers.ts"
click node_mock_data "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/lib/mock-data.ts"
click node_websocket "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/lib/websocket.ts"
click node_sqlite "https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/lib/db/src/schema/index.ts"

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_workers_ui,node_cameras_ui,node_dashboard_ui,node_alerts_ui,node_logs_ui,node_reports_ui,node_zones_ui,node_sensors_ui,node_settings_ui,node_auth_ui toneBlue
class node_detection_model,node_ppe_engine toneAmber
class node_api_app,node_api_routes,node_worker_route,node_websocket toneMint
class node_camera_state,node_warning_state,node_notification_state,node_mock_data,node_sqlite toneRose
class node_supervisor toneIndigo
```

## Components

### Supervisor dashboard

- [Application router](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/App.tsx): `artifacts/safety-monitor/src/App.tsx`
- [Worker management](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/workers.tsx): `artifacts/safety-monitor/src/pages/workers.tsx`
- [Camera monitoring](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/cameras.tsx): `artifacts/safety-monitor/src/pages/cameras.tsx`
- [Live dashboard](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/dashboard.tsx): `artifacts/safety-monitor/src/pages/dashboard.tsx`
- [Alerts](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/alerts.tsx): `artifacts/safety-monitor/src/pages/alerts.tsx`
- [Warning logs](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/warning-logs.tsx): `artifacts/safety-monitor/src/pages/warning-logs.tsx`
- [Reports](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/reports.tsx): `artifacts/safety-monitor/src/pages/reports.tsx`
- [Zones](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/zones.tsx): `artifacts/safety-monitor/src/pages/zones.tsx`
- [Sensors](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/sensors.tsx): `artifacts/safety-monitor/src/pages/sensors.tsx`
- [Settings](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/pages/settings.tsx): `artifacts/safety-monitor/src/pages/settings.tsx`
- [Authentication](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/hooks/use-auth.tsx): `artifacts/safety-monitor/src/hooks/use-auth.tsx`

### Camera detection

- [Detection model loader](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/lib/detection-model.ts): `artifacts/safety-monitor/src/lib/detection-model.ts`
- [PPE detection engine](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/lib/ppe-detection.ts): `artifacts/safety-monitor/src/lib/ppe-detection.ts`

### API service

- [Express application](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [REST route modules](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/tree/main/artifacts/api-server/src/routes): `artifacts/api-server/src/routes`
- [Worker API](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/routes/workers.ts): `artifacts/api-server/src/routes/workers.ts`
- [WebSocket service](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/lib/websocket.ts): `artifacts/api-server/src/lib/websocket.ts`

### Application state

- [Camera media state](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/context/camera-video-context.tsx): `artifacts/safety-monitor/src/context/camera-video-context.tsx`
- [Local warning state](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/context/local-warning-logs-context.tsx): `artifacts/safety-monitor/src/context/local-warning-logs-context.tsx`
- [Notification state](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/safety-monitor/src/context/notification-context.tsx): `artifacts/safety-monitor/src/context/notification-context.tsx`
- [In-memory records](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/artifacts/api-server/src/lib/mock-data.ts): `artifacts/api-server/src/lib/mock-data.ts`
- [SQLite database](https://github.com/eramiya-vimalanathan/edge-ai-based-industrial-safety-violation-detection-system/blob/main/lib/db/src/schema/index.ts): `lib/db/src/schema/index.ts`

### Other components

- **Supervisor**

## Connections

- Supervisor → Application router: uses (evidence: `README.md`)
- Application router → Worker management: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Camera monitoring: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Live dashboard: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Alerts: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Warning logs: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Reports: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Zones: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Sensors: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Settings: routes to (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Authentication: provides auth (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Camera media state: provides media (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Local warning state: provides logs (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Application router → Notification state: provides notifications (evidence: `artifacts/safety-monitor/src/App.tsx`)
- Camera monitoring → PPE detection engine: runs detection (evidence: `artifacts/safety-monitor/src/pages/cameras.tsx`)
- PPE detection engine → Detection model loader: loads model (evidence: `artifacts/safety-monitor/src/lib/ppe-detection.ts`)
- Camera monitoring → Camera media state: uses media (evidence: `artifacts/safety-monitor/src/pages/cameras.tsx`)
- Camera monitoring → Local warning state: records warnings (evidence: `artifacts/safety-monitor/src/pages/cameras.tsx`)
- Camera monitoring → Notification state: adds notifications (evidence: `artifacts/safety-monitor/src/pages/cameras.tsx`)
- Live dashboard → PPE detection engine: uses detections (evidence: `artifacts/safety-monitor/src/pages/dashboard.tsx`)
- Live dashboard → Camera media state: uses media (evidence: `artifacts/safety-monitor/src/pages/dashboard.tsx`)
- Live dashboard → Local warning state: uses warnings (evidence: `artifacts/safety-monitor/src/pages/dashboard.tsx`)
- Live dashboard → Notification state: uses notifications (evidence: `artifacts/safety-monitor/src/pages/dashboard.tsx`)
- Application router → Express application: serves API (evidence: `artifacts/api-server/src/app.ts`)
- Express application → REST route modules: mounts routes (evidence: `artifacts/api-server/src/app.ts`)
- REST route modules → Worker API: registers workers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Worker API → In-memory records: reads and updates (evidence: `artifacts/api-server/src/routes/workers.ts`)
- Worker management → Worker API: requests workers (evidence: `README.md`)
- Express application → WebSocket service: streams updates (evidence: `README.md`)
- Express application → SQLite database: persists records (evidence: `README.md`)
