# shashtttt/cctv-hackathon architecture

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

- Interactive diagram: https://gitdiagram.com/shashtttt/cctv-hackathon
- Repository: https://github.com/shashtttt/cctv-hackathon

## Overview

IBVAP is a multi-camera border-surveillance platform: camera feeds and submitted frames are analyzed for people, behavior, fence breaches, faces, plates, and tampering; resulting alerts, snapshots, and metrics are exposed through a web console. The principal path runs from camera ingestion through worker or direct-frame analysis, persistence, and operator-facing APIs and views. README documents major capabilities beyond the sampled excerpts; those are represented where the tree supports them, while unsampled implementation links are omitted or marked unverified.

Main entry points: [`backend/ai/direct_analyzer.py`](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/direct_analyzer.py) (Direct Frame Analysis), [`backend/pipeline/pipeline_manager.py`](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/pipeline_manager.py) (Camera Orchestrator), [`backend/pipeline/camera_worker.py`](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/camera_worker.py) (Camera Workers), [`backend/routers/cameras.py`](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/routers/cameras.py) (Camera Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Operator Console"]
  node_app["Console App<br/>[App.jsx]"]
  node_console_views["Console Views"]
  node_live_camera["Live Camera UI"]
  node_api_client["API Client<br/>[apiService.js]"]
end

subgraph group_gateway["API Gateway"]
  node_gateway_app["FastAPI Gateway<br/>[main.py]"]
  node_api_routes["API Routes"]
  node_camera_routes["Camera Routes<br/>[cameras.py]"]
end

subgraph group_vision["Ingest and Vision"]
  node_pipeline["Camera Orchestrator"]
  node_workers["Camera Workers<br/>[camera_worker.py]"]
  node_ip_streams["IP Camera Streams"]
  node_direct_analysis["Direct Frame Analysis<br/>[direct_analyzer.py]"]
  node_yolo["Object and Pose AI<br/>[yolo_detector.py]"]
end

subgraph group_security["Threat Intelligence"]
  node_anpr["Plate Recognition<br/>[anpr_engine.py]"]
  node_frs["Face Recognition<br/>[face_recognizer.py]"]
  node_fence["Virtual Fence<br/>[virtual_fence.py]"]
  node_tamper["Tamper Detection<br/>[tamper_detector.py]"]
end

subgraph group_state["Persistence"]
  node_domain_data["Detection and Alert Models<br/>[models.py]"]
  node_database[("SQLite Data Layer<br/>[db.py]")]
  node_firebase["Firebase Services"]
  node_blockchain["Blockchain Audit<br/>[blockchain.py]"]
end

node_operator(("Operator"))
node_external_feeds(("External Camera Feeds"))

node_operator -->|"uses"| node_app
node_app -->|"routes to"| node_console_views
node_operator -.->|"views feeds"| node_live_camera
node_live_camera -->|"requests data"| node_api_client
node_api_client -->|"calls REST APIs"| node_gateway_app
node_gateway_app -->|"registers"| node_api_routes
node_api_routes -.->|"includes"| node_camera_routes
node_camera_routes -->|"dispatches camera work"| node_pipeline
node_camera_routes -->|"manages streams"| node_ip_streams
node_camera_routes -->|"analyzes frames"| node_direct_analysis
node_pipeline -->|"starts workers"| node_workers
node_pipeline -->|"syncs watchlists"| node_direct_analysis
node_pipeline -->|"loads watchlists"| node_database
node_workers -->|"runs inference"| node_yolo
node_direct_analysis -->|"runs inference"| node_yolo
node_direct_analysis -->|"checks plates"| node_anpr
node_direct_analysis -->|"matches faces"| node_frs
node_direct_analysis -->|"checks breaches"| node_fence
node_direct_analysis -->|"checks tampering"| node_tamper
node_direct_analysis -->|"creates alerts"| node_domain_data
node_database -->|"persists records"| node_domain_data
node_external_feeds -.->|"provides streams"| node_ip_streams
node_workers -->|"recognizes plates"| node_anpr
node_workers -->|"recognizes faces"| node_frs
node_workers -->|"checks breaches"| node_fence
node_database -.->|"optional sync"| node_firebase
node_pipeline -.->|"records audit events"| node_blockchain

click node_app "https://github.com/shashtttt/cctv-hackathon/blob/main/src/App.jsx"
click node_console_views "https://github.com/shashtttt/cctv-hackathon/tree/main/src/pages"
click node_live_camera "https://github.com/shashtttt/cctv-hackathon/blob/main/src/pages/LiveSurveillancePage.jsx"
click node_api_client "https://github.com/shashtttt/cctv-hackathon/blob/main/src/services/apiService.js"
click node_gateway_app "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/main.py"
click node_api_routes "https://github.com/shashtttt/cctv-hackathon/tree/main/backend/routers"
click node_camera_routes "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/routers/cameras.py"
click node_pipeline "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/pipeline_manager.py"
click node_workers "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/camera_worker.py"
click node_ip_streams "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/ip_camera_manager.py"
click node_direct_analysis "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/direct_analyzer.py"
click node_yolo "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/yolo_detector.py"
click node_anpr "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/anpr_engine.py"
click node_frs "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/face_recognizer.py"
click node_fence "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/virtual_fence.py"
click node_tamper "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/tamper_detector.py"
click node_domain_data "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/database/models.py"
click node_database "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/database/db.py"
click node_firebase "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/firebase_service.py"
click node_blockchain "https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/blockchain.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_app,node_console_views,node_live_camera,node_api_client toneBlue
class node_gateway_app,node_api_routes,node_camera_routes toneAmber
class node_pipeline,node_workers,node_ip_streams,node_direct_analysis,node_yolo toneMint
class node_anpr,node_frs,node_fence,node_tamper toneRose
class node_domain_data,node_database,node_firebase,node_blockchain,node_operator,node_external_feeds toneIndigo
```

## Components

### Operator Console

- [Console App](https://github.com/shashtttt/cctv-hackathon/blob/main/src/App.jsx): `src/App.jsx`
- [Console Views](https://github.com/shashtttt/cctv-hackathon/tree/main/src/pages): `src/pages`
- [Live Camera UI](https://github.com/shashtttt/cctv-hackathon/blob/main/src/pages/LiveSurveillancePage.jsx): `src/pages/LiveSurveillancePage.jsx`
- [API Client](https://github.com/shashtttt/cctv-hackathon/blob/main/src/services/apiService.js): `src/services/apiService.js`

### API Gateway

- [FastAPI Gateway](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/main.py): `backend/main.py`
- [API Routes](https://github.com/shashtttt/cctv-hackathon/tree/main/backend/routers): `backend/routers`
- [Camera Routes](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/routers/cameras.py): `backend/routers/cameras.py`

### Ingest and Vision

- [Camera Orchestrator](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/pipeline_manager.py): `backend/pipeline/pipeline_manager.py`
- [Camera Workers](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/camera_worker.py): `backend/pipeline/camera_worker.py`
- [IP Camera Streams](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/pipeline/ip_camera_manager.py): `backend/pipeline/ip_camera_manager.py`
- [Direct Frame Analysis](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/direct_analyzer.py): `backend/ai/direct_analyzer.py`
- [Object and Pose AI](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/yolo_detector.py): `backend/ai/yolo_detector.py`

### Threat Intelligence

- [Plate Recognition](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/anpr_engine.py): `backend/ai/anpr_engine.py`
- [Face Recognition](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/ai/face_recognizer.py): `backend/ai/face_recognizer.py`
- [Virtual Fence](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/virtual_fence.py): `backend/core/virtual_fence.py`
- [Tamper Detection](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/tamper_detector.py): `backend/core/tamper_detector.py`

### Persistence

- [Detection and Alert Models](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/database/models.py): `backend/database/models.py`
- [SQLite Data Layer](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/database/db.py): `backend/database/db.py`
- [Firebase Services](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/firebase_service.py): `backend/core/firebase_service.py`
- [Blockchain Audit](https://github.com/shashtttt/cctv-hackathon/blob/main/backend/core/blockchain.py): `backend/core/blockchain.py`

### Other components

- **Operator**
- **External Camera Feeds**

## Connections

- Operator → Console App: uses (evidence: `src/App.jsx`)
- Console App → Console Views: routes to (evidence: `src/App.jsx`)
- Operator → Live Camera UI: views feeds
- Live Camera UI → API Client: requests data (evidence: `src/pages/LiveSurveillancePage.jsx`)
- API Client → FastAPI Gateway: calls REST APIs
- FastAPI Gateway → API Routes: registers (evidence: `backend/main.py`)
- API Routes → Camera Routes: includes
- Camera Routes → Camera Orchestrator: dispatches camera work (evidence: `backend/routers/cameras.py`)
- Camera Routes → IP Camera Streams: manages streams (evidence: `backend/routers/cameras.py`)
- Camera Routes → Direct Frame Analysis: analyzes frames (evidence: `backend/routers/cameras.py`)
- Camera Orchestrator → Camera Workers: starts workers (evidence: `backend/pipeline/pipeline_manager.py`)
- Camera Orchestrator → Direct Frame Analysis: syncs watchlists (evidence: `backend/pipeline/pipeline_manager.py`)
- Camera Orchestrator → SQLite Data Layer: loads watchlists (evidence: `backend/pipeline/pipeline_manager.py`)
- Camera Workers → Object and Pose AI: runs inference (evidence: `backend/pipeline/camera_worker.py`)
- Direct Frame Analysis → Object and Pose AI: runs inference (evidence: `backend/ai/direct_analyzer.py`)
- Direct Frame Analysis → Plate Recognition: checks plates (evidence: `backend/ai/direct_analyzer.py`)
- Direct Frame Analysis → Face Recognition: matches faces (evidence: `backend/ai/direct_analyzer.py`)
- Direct Frame Analysis → Virtual Fence: checks breaches (evidence: `backend/ai/direct_analyzer.py`)
- Direct Frame Analysis → Tamper Detection: checks tampering (evidence: `backend/ai/direct_analyzer.py`)
- Direct Frame Analysis → Detection and Alert Models: creates alerts (evidence: `backend/ai/direct_analyzer.py`)
- SQLite Data Layer → Detection and Alert Models: persists records (evidence: `backend/database/db.py`)
- External Camera Feeds → IP Camera Streams: provides streams
- Camera Workers → Plate Recognition: recognizes plates (evidence: `backend/pipeline/camera_worker.py`)
- Camera Workers → Face Recognition: recognizes faces (evidence: `backend/pipeline/camera_worker.py`)
- Camera Workers → Virtual Fence: checks breaches (evidence: `backend/pipeline/camera_worker.py`)
- SQLite Data Layer → Firebase Services: optional sync (evidence: `backend/database/db.py`)
- Camera Orchestrator → Blockchain Audit: records audit events (evidence: `backend/pipeline/pipeline_manager.py`)
