Technical Reference · v1.0

System Architecture

Violation Detection & Automated Notification Pipeline

🖥️
Frontend Layer
Client-Side Application
React.js REST / WebSocket Live Video Feed
PORT 3000
Browser Client
HTTP / WS
⚙️
Backend API Layer
Application Server
FastAPI Python 3.11 Uvicorn REST Endpoints
PORT 8001
Inference Request
🤖
AI Inference Layer
Computer Vision Engine
YOLOv8 / Ultralytics GPU / CUDA Real-time Detection Confidence Score
Model Inference
Frame Analysis
Detection Result
⚠ VIOLATION DETECTED
① Log to Database
🗄️
PostgreSQL
Event Persistence
violations timestamp snapshot confidence
📋
Event Log Entry
Structured Record Saved
INSERT event_id location
② Trigger Notification
🔁
n8n Workflow
Automation Engine
Webhook Trigger POST /webhook
📱
SMS Notification
Twilio / SMS Gateway
Alert Message Recipient Timestamp
Push to Repo
🔄
CI/CD Pipeline
Continuous Integration & Deployment
GitHub Actions Run Tests Build Docker Image Push to Registry Auto Deploy on Merge
main / dev branch
Automated Workflow
Containerised Deploy
☁️
Infrastructure Layer
Deployment & Orchestration
Docker docker-compose Nginx Reverse Proxy
Production Env
Scalable Deploy
Legend
Frontend / Infra
Backend API
AI Inference
Violation Path
Database Logging
n8n Automation
SMS Alert
CI/CD Pipeline