# yash2006kr/trinetra-ai architecture

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

- Interactive diagram: https://gitdiagram.com/yash2006kr/trinetra-ai
- Repository: https://github.com/yash2006kr/trinetra-ai

## Overview

Trinetra AI is a modular CCTV surveillance suite: users select a camera and surveillance domain in the dashboard, then view processed live video and alerts. The documented runtime spans camera capture, object detection and domain analysis, alert/event handling, and dashboard delivery. The tree and README establish additional capabilities, but most gateway, frontend, and shared-runtime source was not sampled, so uncertain internal call wiring is omitted.

Main entry points: [`SmartVision-AI-Surveillance-Suite/shared_core/vision/live_processor.py`](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/vision/live_processor.py) (Live processor), [`SmartVision-AI-Surveillance-Suite/api_gateway/main.py`](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/api_gateway/main.py) (API gateway), [`SmartVision-AI-Surveillance-Suite/highway_surveillance/pipeline.py`](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/highway_surveillance/pipeline.py) (Highway rules), [`SmartVision-AI-Surveillance-Suite/frontend/src/main.jsx`](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/frontend/src/main.jsx) (React dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Monitoring interface"]
  node_dashboard["React dashboard<br/>[main.jsx]"]
  node_gateway["API gateway<br/>[main.py]"]
end

subgraph group_capture["Video processing"]
  node_camera["Camera manager<br/>[camera_manager.py]"]
  node_processor["Live processor<br/>[live_processor.py]"]
  node_detector["YOLO detector<br/>[yolo_detector.py]"]
end

subgraph group_domains["Surveillance domains"]
  node_highway["Highway rules<br/>[pipeline.py]"]
  node_traffic["Traffic management"]
  node_city["City security"]
  node_retail["Retail analytics"]
  node_industrial["Industrial safety"]
  node_parking["Smart parking"]
  node_railway["Railway surveillance"]
  node_campus["Campus security"]
  node_home["Home security"]
  node_wildlife["Wildlife monitoring"]
end

subgraph group_events["Events and persistence"]
  node_alerts["Alert engine<br/>[alerts.py]"]
  node_recorder["Event recorder<br/>[event_recorder.py]"]
  node_repository["Data repository<br/>[repository.py]"]
  node_database[("Mongo repository")]
end

subgraph group_platform["Shared platform"]
  node_notifications["Notification providers<br/>[providers.py]"]
end

node_operator(("Operator"))

node_operator -->|"operates"| node_dashboard
node_dashboard -->|"API and live stream"| node_gateway
node_gateway -->|"camera control"| node_camera
node_camera -->|"video frames"| node_processor
node_processor -->|"detect objects"| node_detector
node_processor -->|"analyze detections"| node_highway
node_processor -->|"analyze detections"| node_traffic
node_processor -->|"analyze detections"| node_city
node_processor -->|"analyze detections"| node_retail
node_processor -->|"analyze detections"| node_industrial
node_processor -->|"analyze detections"| node_parking
node_processor -->|"analyze detections"| node_railway
node_processor -->|"analyze detections"| node_campus
node_processor -->|"analyze detections"| node_home
node_processor -->|"analyze detections"| node_wildlife
node_highway -->|"dispatch alerts"| node_alerts
node_highway -->|"save alerts"| node_repository
node_repository -->|"persist data"| node_database
node_alerts -.->|"notify"| node_notifications
node_processor -.->|"record events"| node_recorder
node_gateway -->|"live updates"| node_dashboard

click node_dashboard "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/frontend/src/main.jsx"
click node_gateway "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/api_gateway/main.py"
click node_camera "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/stream_manager/camera_manager.py"
click node_processor "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/vision/live_processor.py"
click node_detector "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/ai_models/yolo_detector.py"
click node_highway "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/highway_surveillance/pipeline.py"
click node_traffic "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/traffic_management"
click node_city "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/smart_city_security"
click node_retail "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/retail_analytics"
click node_industrial "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/industrial_safety"
click node_parking "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/smart_parking"
click node_railway "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/railway_surveillance"
click node_campus "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/campus_security"
click node_home "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/home_security"
click node_wildlife "https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/wildlife_monitoring"
click node_alerts "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/alert_engine/alerts.py"
click node_recorder "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/recording_engine/event_recorder.py"
click node_repository "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/database/repository.py"
click node_database "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/database/mongo_repository.py"
click node_notifications "https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/notifications/providers.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_dashboard,node_gateway toneBlue
class node_camera,node_processor,node_detector toneAmber
class node_highway,node_traffic,node_city,node_retail,node_industrial,node_parking,node_railway,node_campus,node_home,node_wildlife toneMint
class node_alerts,node_recorder,node_repository,node_database toneRose
class node_notifications,node_operator toneIndigo
```

## Components

### Monitoring interface

- [React dashboard](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/frontend/src/main.jsx): `SmartVision-AI-Surveillance-Suite/frontend/src/main.jsx`
- [API gateway](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/api_gateway/main.py): `SmartVision-AI-Surveillance-Suite/api_gateway/main.py`

### Video processing

- [Camera manager](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/stream_manager/camera_manager.py): `SmartVision-AI-Surveillance-Suite/shared_core/stream_manager/camera_manager.py`
- [Live processor](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/vision/live_processor.py): `SmartVision-AI-Surveillance-Suite/shared_core/vision/live_processor.py`
- [YOLO detector](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/ai_models/yolo_detector.py): `SmartVision-AI-Surveillance-Suite/shared_core/ai_models/yolo_detector.py`

### Surveillance domains

- [Highway rules](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/highway_surveillance/pipeline.py): `SmartVision-AI-Surveillance-Suite/highway_surveillance/pipeline.py`
- [Traffic management](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/traffic_management): `SmartVision-AI-Surveillance-Suite/traffic_management`
- [City security](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/smart_city_security): `SmartVision-AI-Surveillance-Suite/smart_city_security`
- [Retail analytics](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/retail_analytics): `SmartVision-AI-Surveillance-Suite/retail_analytics`
- [Industrial safety](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/industrial_safety): `SmartVision-AI-Surveillance-Suite/industrial_safety`
- [Smart parking](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/smart_parking): `SmartVision-AI-Surveillance-Suite/smart_parking`
- [Railway surveillance](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/railway_surveillance): `SmartVision-AI-Surveillance-Suite/railway_surveillance`
- [Campus security](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/campus_security): `SmartVision-AI-Surveillance-Suite/campus_security`
- [Home security](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/home_security): `SmartVision-AI-Surveillance-Suite/home_security`
- [Wildlife monitoring](https://github.com/yash2006kr/trinetra-ai/tree/main/SmartVision-AI-Surveillance-Suite/wildlife_monitoring): `SmartVision-AI-Surveillance-Suite/wildlife_monitoring`

### Events and persistence

- [Alert engine](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/alert_engine/alerts.py): `SmartVision-AI-Surveillance-Suite/shared_core/alert_engine/alerts.py`
- [Event recorder](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/recording_engine/event_recorder.py): `SmartVision-AI-Surveillance-Suite/shared_core/recording_engine/event_recorder.py`
- [Data repository](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/database/repository.py): `SmartVision-AI-Surveillance-Suite/shared_core/database/repository.py`
- [Mongo repository](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/database/mongo_repository.py): `SmartVision-AI-Surveillance-Suite/shared_core/database/mongo_repository.py`

### Shared platform

- [Notification providers](https://github.com/yash2006kr/trinetra-ai/blob/main/SmartVision-AI-Surveillance-Suite/shared_core/notifications/providers.py): `SmartVision-AI-Surveillance-Suite/shared_core/notifications/providers.py`

### Other components

- **Operator**

## Connections

- Operator → React dashboard: operates
- React dashboard → API gateway: API and live stream
- API gateway → Camera manager: camera control
- Camera manager → Live processor: video frames
- Live processor → YOLO detector: detect objects
- Live processor → Highway rules: analyze detections
- Live processor → Traffic management: analyze detections
- Live processor → City security: analyze detections
- Live processor → Retail analytics: analyze detections
- Live processor → Industrial safety: analyze detections
- Live processor → Smart parking: analyze detections
- Live processor → Railway surveillance: analyze detections
- Live processor → Campus security: analyze detections
- Live processor → Home security: analyze detections
- Live processor → Wildlife monitoring: analyze detections
- Highway rules → Alert engine: dispatch alerts
- Highway rules → Data repository: save alerts
- Data repository → Mongo repository: persist data
- Alert engine → Notification providers: notify
- Live processor → Event recorder: record events
- API gateway → React dashboard: live updates