# balajigun/ppe_monitoring architecture

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

## Overview

This is a real-time PPE safety video analytics application. Its principal workflow reads a video stream, detects and tracks people and PPE, associates PPE with workers, confirms violations over time, then produces alerts, reports, and annotated video. Separate branches detect unsafe worker–machinery proximity and monitor camera, application, and GPU health. The README documents several pipeline connections; sampled source confirms key implementations and some orchestration, but not every call in the main processing loop, so documented links cite the README.

Main entry points: [`src/main.py`](https://github.com/balajigun/ppe_monitoring/blob/main/src/main.py) (Pipeline runner), [`src/detector.py`](https://github.com/balajigun/ppe_monitoring/blob/main/src/detector.py) (YOLO tracker), [`src/alert_manager.py`](https://github.com/balajigun/ppe_monitoring/blob/main/src/alert_manager.py) (Violation alerts), [`src/ppe_rules.py`](https://github.com/balajigun/ppe_monitoring/blob/main/src/ppe_rules.py) (PPE association rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vision["Video analytics"]
  node_main["Pipeline runner<br/>[main.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_reader["Video reader<br/>[video_reader.py]"]
  node_detector["YOLO tracker<br/>[detector.py]"]
  node_detection["Detection records<br/>[detection.py]"]
end

subgraph group_safety["Safety decisions"]
  node_rules["PPE association rules<br/>[ppe_rules.py]"]
  node_state["Worker PPE state<br/>[ppe_state.py]"]
  node_proximity["Proximity detection"]
end

subgraph group_outputs["Reporting and alerts"]
  node_csv["PPE CSV reports<br/>[csv_logger.py]"]
  node_workerlog["Worker count log"]
  node_alerts["Violation alerts<br/>[alert_manager.py]"]
  node_evidence["Violation screenshots"]
  node_proximitylog["Proximity event log"]
  node_videoout["Annotated video<br/>[visualizer.py]"]
end

subgraph group_health["Operations"]
  node_camera["Camera health"]
  node_apphealth["Application health"]
  node_gpu["GPU metrics<br/>[gpu_monitor.py]"]
  node_logging["Application logging<br/>[logging_setup.py]"]
end

node_operator(("Video source"))
node_supervisor(("Email recipient"))

node_operator -->|"provides video"| node_reader
node_main -->|"reads frames"| node_reader
node_main -->|"runs detection"| node_detector
node_detector -->|"loads settings"| node_config
node_detector -->|"creates records"| node_detection
node_main -->|"evaluates PPE"| node_rules
node_rules -->|"evaluates objects"| node_detection
node_main -->|"confirms violations"| node_state
node_main -->|"writes reports"| node_csv
node_main -->|"logs worker counts"| node_workerlog
node_main -->|"processes violations"| node_alerts
node_alerts -->|"saves screenshots"| node_evidence
node_alerts -->|"sends email"| node_supervisor
node_main -->|"checks proximity"| node_proximity
node_main -->|"logs events"| node_proximitylog
node_main -->|"renders output"| node_videoout
node_main -->|"starts monitoring"| node_camera
node_main -->|"starts monitoring"| node_apphealth
node_main -->|"monitors GPU"| node_gpu
node_main -->|"sets up logs"| node_logging

click node_main "https://github.com/balajigun/ppe_monitoring/blob/main/src/main.py"
click node_config "https://github.com/balajigun/ppe_monitoring/blob/main/src/config.py"
click node_reader "https://github.com/balajigun/ppe_monitoring/blob/main/src/video_reader.py"
click node_detector "https://github.com/balajigun/ppe_monitoring/blob/main/src/detector.py"
click node_detection "https://github.com/balajigun/ppe_monitoring/blob/main/src/detection.py"
click node_rules "https://github.com/balajigun/ppe_monitoring/blob/main/src/ppe_rules.py"
click node_state "https://github.com/balajigun/ppe_monitoring/blob/main/src/ppe_state.py"
click node_proximity "https://github.com/balajigun/ppe_monitoring/blob/main/src/proximity_detector.py"
click node_csv "https://github.com/balajigun/ppe_monitoring/blob/main/src/csv_logger.py"
click node_workerlog "https://github.com/balajigun/ppe_monitoring/blob/main/src/worker_count_logger.py"
click node_alerts "https://github.com/balajigun/ppe_monitoring/blob/main/src/alert_manager.py"
click node_proximitylog "https://github.com/balajigun/ppe_monitoring/blob/main/src/proximity_event_logger.py"
click node_videoout "https://github.com/balajigun/ppe_monitoring/blob/main/src/visualizer.py"
click node_camera "https://github.com/balajigun/ppe_monitoring/blob/main/src/camera_health_monitor.py"
click node_apphealth "https://github.com/balajigun/ppe_monitoring/blob/main/src/application_monitor.py"
click node_gpu "https://github.com/balajigun/ppe_monitoring/blob/main/src/gpu_monitor.py"
click node_logging "https://github.com/balajigun/ppe_monitoring/blob/main/src/logging_setup.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_main,node_config,node_reader,node_detector,node_detection toneBlue
class node_rules,node_state,node_proximity toneAmber
class node_csv,node_workerlog,node_alerts,node_evidence,node_proximitylog,node_videoout toneMint
class node_camera,node_apphealth,node_gpu,node_logging toneRose
class node_operator,node_supervisor toneIndigo
```

## Components

### Video analytics

- [Pipeline runner](https://github.com/balajigun/ppe_monitoring/blob/main/src/main.py): `src/main.py`
- [Runtime configuration](https://github.com/balajigun/ppe_monitoring/blob/main/src/config.py): `src/config.py`
- [Video reader](https://github.com/balajigun/ppe_monitoring/blob/main/src/video_reader.py): `src/video_reader.py`
- [YOLO tracker](https://github.com/balajigun/ppe_monitoring/blob/main/src/detector.py): `src/detector.py`
- [Detection records](https://github.com/balajigun/ppe_monitoring/blob/main/src/detection.py): `src/detection.py`

### Safety decisions

- [PPE association rules](https://github.com/balajigun/ppe_monitoring/blob/main/src/ppe_rules.py): `src/ppe_rules.py`
- [Worker PPE state](https://github.com/balajigun/ppe_monitoring/blob/main/src/ppe_state.py): `src/ppe_state.py`
- [Proximity detection](https://github.com/balajigun/ppe_monitoring/blob/main/src/proximity_detector.py): `src/proximity_detector.py`

### Reporting and alerts

- [PPE CSV reports](https://github.com/balajigun/ppe_monitoring/blob/main/src/csv_logger.py): `src/csv_logger.py`
- [Worker count log](https://github.com/balajigun/ppe_monitoring/blob/main/src/worker_count_logger.py): `src/worker_count_logger.py`
- [Violation alerts](https://github.com/balajigun/ppe_monitoring/blob/main/src/alert_manager.py): `src/alert_manager.py`
- **Violation screenshots**
- [Proximity event log](https://github.com/balajigun/ppe_monitoring/blob/main/src/proximity_event_logger.py): `src/proximity_event_logger.py`
- [Annotated video](https://github.com/balajigun/ppe_monitoring/blob/main/src/visualizer.py): `src/visualizer.py`

### Operations

- [Camera health](https://github.com/balajigun/ppe_monitoring/blob/main/src/camera_health_monitor.py): `src/camera_health_monitor.py`
- [Application health](https://github.com/balajigun/ppe_monitoring/blob/main/src/application_monitor.py): `src/application_monitor.py`
- [GPU metrics](https://github.com/balajigun/ppe_monitoring/blob/main/src/gpu_monitor.py): `src/gpu_monitor.py`
- [Application logging](https://github.com/balajigun/ppe_monitoring/blob/main/src/logging_setup.py): `src/logging_setup.py`

### Other components

- **Video source**
- **Email recipient**

## Connections

- Video source → Video reader: provides video (evidence: `README.md`)
- Pipeline runner → Video reader: reads frames (evidence: `README.md`)
- Pipeline runner → YOLO tracker: runs detection (evidence: `README.md`)
- YOLO tracker → Runtime configuration: loads settings (evidence: `src/detector.py`)
- YOLO tracker → Detection records: creates records (evidence: `src/detector.py`)
- Pipeline runner → PPE association rules: evaluates PPE (evidence: `README.md`)
- PPE association rules → Detection records: evaluates objects (evidence: `src/ppe_rules.py`)
- Pipeline runner → Worker PPE state: confirms violations (evidence: `README.md`)
- Pipeline runner → PPE CSV reports: writes reports (evidence: `README.md`)
- Pipeline runner → Worker count log: logs worker counts (evidence: `README.md`)
- Pipeline runner → Violation alerts: processes violations (evidence: `src/main.py`)
- Violation alerts → Violation screenshots: saves screenshots (evidence: `src/alert_manager.py`)
- Violation alerts → Email recipient: sends email (evidence: `src/alert_manager.py`)
- Pipeline runner → Proximity detection: checks proximity (evidence: `README.md`)
- Pipeline runner → Proximity event log: logs events (evidence: `README.md`)
- Pipeline runner → Annotated video: renders output (evidence: `README.md`)
- Pipeline runner → Camera health: starts monitoring (evidence: `src/main.py`)
- Pipeline runner → Application health: starts monitoring (evidence: `src/main.py`)
- Pipeline runner → GPU metrics: monitors GPU (evidence: `README.md`)
- Pipeline runner → Application logging: sets up logs (evidence: `src/main.py`)
