How 3bdelmoemn/fire-smoke-detection-engine works
FireGuard AI combines a React operator dashboard with a FastAPI fire/smoke detection backend. The principal workflow is live-camera or uploaded-media capture, YOLO inference, temporal confirmation and cooldown-based alerting, with event and alert records available to dashboard users. Authentication, health/KPI reporting, and evaluation assets are additional product capabilities. Relationships are grounded in the README and supplied excerpts or SOURCE INDEX references; unsampled implementation details and some frontend-to-route wiring are not inferred.
Main entry points: main.py FastAPI App · detection_realtime.py Realtime Routes · App.jsx Dashboard App · api.js API Client
Components 29
Operator Dashboard
- Dashboard App
frontend/src/App.jsx - Login Page
frontend/src/pages/Login.jsx - Live Dashboard
frontend/src/pages/Dashboard.jsx - Upload Analysis
frontend/src/pages/Upload.jsx - Evaluation Gallery
frontend/src/pages/Evaluation.jsx - Alert History
frontend/src/pages/Alerts.jsx - API Client
frontend/src/services/api.js
API and Access
- FastAPI App
backend/app/main.py - Auth Routes
backend/app/api/v1/auth.py - Realtime Routes
backend/app/api/v1/detection_realtime.py - Upload Routes
backend/app/api/v1/detection_upload.py - Evaluation Routes
backend/app/api/v1/evaluation.py - Alert Routes
backend/app/api/v1/alerts.py - Health Routes
backend/app/api/v1/health.py - Auth Service
backend/app/services/auth_service.py
Detection and Alerts
- YOLO Inference
backend/app/services/inference_service.py - Model Loader
backend/app/ml/model_loader.py - Camera Service
backend/app/services/camera_service.py - Media Service
backend/app/services/media_service.py - Alert Decision
backend/app/services/alert_decision_engine.py - Temporal Validator
backend/app/services/temporal_validator.py - Notifications
backend/app/services/notification_service.py
Persistence and Model
- Application Database
backend/app/db/session.py - Detection Repository
backend/app/repositories/detection_repository.py - Alert Repository
backend/app/repositories/alert_repository.py - User Repository
backend/app/repositories/user_repository.py - Application Settings
backend/app/core/config.py
Other components
- Operator
- Camera / Media
Connections 46
- Operator → Dashboard App: uses
README.md - Dashboard App → Login Page: routes to
frontend/src/App.jsx - Dashboard App → Live Dashboard: routes to
frontend/src/App.jsx - Dashboard App → Upload Analysis: routes to
frontend/src/App.jsx - Dashboard App → Evaluation Gallery: routes to
frontend/src/App.jsx - Dashboard App → Alert History: routes to
frontend/src/App.jsx - Login Page → API Client: calls
frontend/src/pages/Login.jsx - Live Dashboard → API Client: calls
frontend/src/pages/Dashboard.jsx - Upload Analysis → API Client: calls
frontend/src/pages/Upload.jsx - Evaluation Gallery → API Client: calls
frontend/src/pages/Evaluation.jsx - Alert History → API Client: calls
frontend/src/pages/Alerts.jsx - API Client → FastAPI App: REST / WebSocket
README.md - FastAPI App → Auth Routes: registers
backend/app/main.py - FastAPI App → Realtime Routes: registers
backend/app/main.py - FastAPI App → Upload Routes: registers
backend/app/main.py - FastAPI App → Evaluation Routes: registers
backend/app/main.py - FastAPI App → Alert Routes: registers
backend/app/main.py - FastAPI App → Health Routes: registers
backend/app/main.py - Auth Routes → Auth Service: calls
backend/app/api/v1/auth.py - Camera / Media → Realtime Routes: supplies frames
README.md - Realtime Routes → Camera Service: uses
backend/app/api/v1/detection_realtime.py - Realtime Routes → YOLO Inference: requests inference
backend/app/api/v1/detection_realtime.py - Upload Routes → YOLO Inference: requests inference
backend/app/api/v1/detection_upload.py - Camera Service → YOLO Inference: provides frames
- Realtime Routes → Alert Decision: evaluates detections
backend/app/api/v1/detection_realtime.py - Alert Decision → Temporal Validator: validates over time
README.md - Alert Decision → Notifications: dispatches alerts
README.md - Realtime Routes → Notifications: uses
backend/app/api/v1/detection_realtime.py - Upload Routes → Media Service: uses
backend/app/api/v1/detection_upload.py - Realtime Routes → Media Service: uses
backend/app/api/v1/detection_realtime.py - FastAPI App → Model Loader: preloads
backend/app/main.py - YOLO Inference → Model Loader: uses model
- Realtime Routes → Detection Repository: persists events
backend/app/api/v1/detection_realtime.py - Upload Routes → Detection Repository: persists events
backend/app/api/v1/detection_upload.py - Realtime Routes → Alert Repository: persists alerts
backend/app/api/v1/detection_realtime.py - Alert Routes → Alert Repository: queries alerts
backend/app/api/v1/alerts.py - Health Routes → Detection Repository: reads KPIs
backend/app/api/v1/health.py - Health Routes → Alert Repository: checks alerts
backend/app/api/v1/health.py - Auth Service → User Repository: uses user model
- Detection Repository → Application Database: reads / writes
- Alert Repository → Application Database: reads / writes
- FastAPI App → Application Database: initializes
backend/app/main.py - FastAPI App → Application Settings: loads settings
backend/app/main.py - Realtime Routes → Application Settings: uses settings
backend/app/api/v1/detection_realtime.py - Upload Routes → Application Settings: uses settings
backend/app/api/v1/detection_upload.py - Notifications → Operator: WhatsApp alert
README.md