How shashtttt/cctv-hackathon works
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: direct_analyzer.py Direct Frame Analysis · pipeline_manager.py Camera Orchestrator · camera_worker.py Camera Workers · cameras.py Camera Routes
Components 22
Operator Console
- Console App
src/App.jsx - Console Views
src/pages - Live Camera UI
src/pages/LiveSurveillancePage.jsx - API Client
src/services/apiService.js
API Gateway
- FastAPI Gateway
backend/main.py - API Routes
backend/routers - Camera Routes
backend/routers/cameras.py
Ingest and Vision
- Camera Orchestrator
backend/pipeline/pipeline_manager.py - Camera Workers
backend/pipeline/camera_worker.py - IP Camera Streams
backend/pipeline/ip_camera_manager.py - Direct Frame Analysis
backend/ai/direct_analyzer.py - Object and Pose AI
backend/ai/yolo_detector.py
Threat Intelligence
- Plate Recognition
backend/ai/anpr_engine.py - Face Recognition
backend/ai/face_recognizer.py - Virtual Fence
backend/core/virtual_fence.py - Tamper Detection
backend/core/tamper_detector.py
Persistence
- Detection and Alert Models
backend/database/models.py - SQLite Data Layer
backend/database/db.py - Firebase Services
backend/core/firebase_service.py - Blockchain Audit
backend/core/blockchain.py
Other components
- Operator
- External Camera Feeds
Connections 27
- Operator → Console App: uses
src/App.jsx - Console App → Console Views: routes to
src/App.jsx - Operator → Live Camera UI: views feeds
- Live Camera UI → API Client: requests data
src/pages/LiveSurveillancePage.jsx - API Client → FastAPI Gateway: calls REST APIs
- FastAPI Gateway → API Routes: registers
backend/main.py - API Routes → Camera Routes: includes
- Camera Routes → Camera Orchestrator: dispatches camera work
backend/routers/cameras.py - Camera Routes → IP Camera Streams: manages streams
backend/routers/cameras.py - Camera Routes → Direct Frame Analysis: analyzes frames
backend/routers/cameras.py - Camera Orchestrator → Camera Workers: starts workers
backend/pipeline/pipeline_manager.py - Camera Orchestrator → Direct Frame Analysis: syncs watchlists
backend/pipeline/pipeline_manager.py - Camera Orchestrator → SQLite Data Layer: loads watchlists
backend/pipeline/pipeline_manager.py - Camera Workers → Object and Pose AI: runs inference
backend/pipeline/camera_worker.py - Direct Frame Analysis → Object and Pose AI: runs inference
backend/ai/direct_analyzer.py - Direct Frame Analysis → Plate Recognition: checks plates
backend/ai/direct_analyzer.py - Direct Frame Analysis → Face Recognition: matches faces
backend/ai/direct_analyzer.py - Direct Frame Analysis → Virtual Fence: checks breaches
backend/ai/direct_analyzer.py - Direct Frame Analysis → Tamper Detection: checks tampering
backend/ai/direct_analyzer.py - Direct Frame Analysis → Detection and Alert Models: creates alerts
backend/ai/direct_analyzer.py - SQLite Data Layer → Detection and Alert Models: persists records
backend/database/db.py - External Camera Feeds → IP Camera Streams: provides streams
- Camera Workers → Plate Recognition: recognizes plates
backend/pipeline/camera_worker.py - Camera Workers → Face Recognition: recognizes faces
backend/pipeline/camera_worker.py - Camera Workers → Virtual Fence: checks breaches
backend/pipeline/camera_worker.py - SQLite Data Layer → Firebase Services: optional sync
backend/database/db.py - Camera Orchestrator → Blockchain Audit: records audit events
backend/pipeline/pipeline_manager.py