How dharshan-raj/perimeter_fencing_al works
IT Furnace is a camera-based perimeter intrusion monitoring system. Its main workflow acquires a configured camera or fallback video, detects and tracks people, evaluates zone transitions, records event evidence and history, then serves live video, alerts, and analytics to a React dashboard. The dashboard also supports zone editing and authenticated monitoring controls. Edges reflect calls and data flows visible in excerpts or documented API capabilities; unsampled subsystems are included where the README establishes their role, with uncertain internal links omitted.
Main entry points: main.py FastAPI routes · camera_manager.py Camera worker · App.jsx Dashboard app · CameraFeed.jsx Live feed
Components 24
Video Capture
- Stream reader
backend/camera/rtsp_stream.py - Camera worker
backend/camera/camera_manager.py
Detection & Events
- Person detector
backend/detection/detector.py - Zone manager
backend/detection/zone_manager.py - Intrusion evaluation
backend/detection/intrusion_detector.py - Evidence capture
backend/services/evidence_service.py - ntfy notifications
backend/services/notification_service.py
Monitoring API
- FastAPI routes
backend/main.py - Alert WebSocket
backend/services/websocket_manager.py - Event models
backend/models.py - SQL database
backend/database.py - Evidence files
evidence - Runtime settings
backend/config.py
Dashboard
- Dashboard app
frontend/src/App.jsx - API client
frontend/src/services/api.js - Live feed
frontend/src/components/CameraFeed.jsx - Zone editor
frontend/src/ZoneEditor.jsx - Alert panel
frontend/src/components/AlertPanel.jsx - Analytics panels
frontend/src/components/AnalyticsPanels.jsx - Camera status
frontend/src/components/CameraStatus.jsx - Navigation
frontend/src/components/Sidebar.jsx
Other components
- Security operator
- CCTV / webcam
- ntfy service
Connections 30
- CCTV / webcam → Stream reader: provides frames
README.md - Stream reader → Camera worker: reads stream
backend/camera/camera_manager.py - Runtime settings → Camera worker: configures
backend/camera/camera_manager.py - Camera worker → Person detector: runs detection
backend/camera/camera_manager.py - Camera worker → Zone manager: uses zones
backend/camera/camera_manager.py - Camera worker → Intrusion evaluation: evaluates tracks
backend/camera/camera_manager.py - Camera worker → Evidence capture: saves event frame
backend/camera/camera_manager.py - Camera worker → Event models: records events
backend/camera/camera_manager.py - Evidence capture → Evidence files: writes images
backend/services/evidence_service.py - Camera worker → FastAPI routes: publishes events
backend/camera/camera_manager.py - FastAPI routes → Alert WebSocket: broadcasts alerts
backend/main.py - FastAPI routes → ntfy notifications: dispatches critical
backend/main.py - ntfy notifications → ntfy service: posts notification
backend/services/notification_service.py - Event models → SQL database: maps records
backend/models.py - FastAPI routes → SQL database: queries and updates
backend/main.py - FastAPI routes → Camera worker: controls camera
backend/main.py - FastAPI routes → Zone manager: reads and updates
backend/main.py - FastAPI routes → Evidence files: serves images
backend/main.py - Security operator → Dashboard app: uses dashboard
README.md - Dashboard app → API client: requests data
frontend/src/App.jsx - API client → FastAPI routes: calls HTTP API
README.md - Dashboard app → Live feed: renders feed
frontend/src/App.jsx - Dashboard app → Alert panel: renders alerts
frontend/src/App.jsx - Dashboard app → Analytics panels: renders analytics
frontend/src/App.jsx - Dashboard app → Camera status: renders status
frontend/src/App.jsx - Dashboard app → Navigation: renders navigation
frontend/src/App.jsx - Live feed → Zone editor: embeds editor
frontend/src/components/CameraFeed.jsx - Live feed → FastAPI routes: loads MJPEG
README.md - Zone editor → API client: updates zones
frontend/src/ZoneEditor.jsx - FastAPI routes → Dashboard app: streams alert events
README.md