# sreevathsans/speedcamera architecture

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

- Interactive diagram: https://gitdiagram.com/sreevathsans/speedcamera
- Repository: https://github.com/sreevathsans/speedcamera

## Overview

SpeedCamera analyzes camera/video imagery for vehicle tracking, speed violations, plate identification, evidence and challans, then exposes events and media through a FastAPI service. Users sign in to role-specific React dashboards; administrators monitor feeds, statistics, violations and stolen-vehicle alerts, while public users view their vehicle’s challans. The README and excerpts establish these product stages, but do not expose every backend call path, so uncertain implementation links are omitted.

Main entry points: [`Backend/api/server.py`](https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py) (Video analysis), [`frontend/src/App.jsx`](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/App.jsx) (React application), [`frontend/src/components/AdminDashboard.jsx`](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/AdminDashboard.jsx) (Admin dashboard), [`frontend/src/api/apiClient.js`](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/api/apiClient.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Detection and enforcement"]
  node_video["Video analysis<br/>[server.py]"]
  node_vehicle_detection["Vehicle detection"]
  node_tracking_speed["Tracking and speed<br/>[server.py]"]
  node_plate_recognition["Plate recognition<br/>[plate_detection.py]"]
  node_stolen_check["Stolen plate check<br/>[stolen_plates.txt]"]
  node_challan["Challan generation"]
  node_camera_config["Camera configuration<br/>[config.py]"]
  node_camera_script["Camera test runner<br/>[main.py]"]
end

subgraph group_backend["Backend services"]
  node_api["FastAPI service<br/>[server.py]"]
  node_authentication["Authentication<br/>[auth.py]"]
  node_database_manager["Event database manager"]
  node_sqlite[("SQLite event store")]
end

subgraph group_frontend["Web experience"]
  node_web_app["React application<br/>[App.jsx]"]
  node_login["Login page<br/>[LoginPage.jsx]"]
  node_auth_state["Client auth state<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[apiClient.js]"]
  node_home["Role dashboard routing<br/>[HomePage.jsx]"]
  node_admin_dashboard["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_public_dashboard["Public dashboard"]
  node_theme_state["Theme state<br/>[ThemeContext.jsx]"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_theme_toggle["Theme toggle<br/>[ThemeToggle.jsx]"]
end

node_operator(("Camera operator"))
node_web_user(("Dashboard user"))

node_operator -->|"provides footage"| node_video
node_video -.->|"detects vehicles"| node_vehicle_detection
node_video -->|"tracks and measures"| node_tracking_speed
node_tracking_speed -->|"uses calibration"| node_camera_config
node_video -.->|"extracts plates"| node_plate_recognition
node_video -.->|"checks plates"| node_stolen_check
node_video -->|"generates challan"| node_challan
node_operator -->|"runs test feed"| node_camera_script
node_camera_script -->|"uses settings"| node_camera_config
node_web_user -->|"opens dashboard"| node_web_app
node_web_app -->|"routes to"| node_login
node_web_app -->|"routes to"| node_home
node_web_app -->|"provides auth"| node_auth_state
node_web_app -->|"provides theme"| node_theme_state
node_web_app -->|"renders"| node_navbar
node_login -->|"submits credentials"| node_auth_state
node_auth_state -->|"requests token"| node_api_client
node_api_client -->|"calls backend"| node_api
node_api -->|"validates users"| node_authentication
node_home -->|"renders admin view"| node_admin_dashboard
node_home -->|"renders public view"| node_public_dashboard
node_admin_dashboard -->|"fetches dashboard data"| node_api_client
node_public_dashboard -->|"fetches events"| node_api_client
node_admin_dashboard -->|"opens event socket"| node_api
node_admin_dashboard -->|"loads camera feeds"| node_api
node_navbar -->|"renders"| node_theme_toggle
node_theme_toggle -->|"toggles theme"| node_theme_state
node_api -->|"reads and logs events"| node_sqlite
node_challan -.->|"stores challan data"| node_sqlite

click node_video "https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py"
click node_vehicle_detection "https://github.com/sreevathsans/speedcamera/tree/master/Backend/models/VehicleDetector"
click node_tracking_speed "https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py"
click node_plate_recognition "https://github.com/sreevathsans/speedcamera/blob/master/Backend/models/NumberPlateDetector/YOLOv5/YOLOv5/plate_detection.py"
click node_stolen_check "https://github.com/sreevathsans/speedcamera/blob/master/Backend/stolen_plates.txt"
click node_challan "https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/challan_generator.py"
click node_camera_config "https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/config.py"
click node_camera_script "https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/main.py"
click node_api "https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py"
click node_authentication "https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/auth.py"
click node_database_manager "https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/database_manager.py"
click node_web_app "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/App.jsx"
click node_login "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/pages/LoginPage.jsx"
click node_auth_state "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/api/apiClient.js"
click node_home "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/pages/HomePage.jsx"
click node_admin_dashboard "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/AdminDashboard.jsx"
click node_public_dashboard "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/PublicDashboard.jsx"
click node_theme_state "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/context/ThemeContext.jsx"
click node_navbar "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/Navbar.jsx"
click node_theme_toggle "https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/ThemeToggle.jsx"

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_video,node_vehicle_detection,node_tracking_speed,node_plate_recognition,node_stolen_check,node_challan,node_camera_config,node_camera_script,node_web_user toneBlue
class node_api,node_authentication,node_database_manager,node_sqlite toneAmber
class node_web_app,node_login,node_auth_state,node_api_client,node_home,node_admin_dashboard,node_public_dashboard,node_theme_state,node_navbar,node_theme_toggle toneMint
class node_operator toneIndigo
```

## Components

### Detection and enforcement

- [Video analysis](https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py): `Backend/api/server.py`
- [Vehicle detection](https://github.com/sreevathsans/speedcamera/tree/master/Backend/models/VehicleDetector): `Backend/models/VehicleDetector`
- [Tracking and speed](https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py): `Backend/api/server.py`
- [Plate recognition](https://github.com/sreevathsans/speedcamera/blob/master/Backend/models/NumberPlateDetector/YOLOv5/YOLOv5/plate_detection.py): `Backend/models/NumberPlateDetector/YOLOv5/YOLOv5/plate_detection.py`
- [Stolen plate check](https://github.com/sreevathsans/speedcamera/blob/master/Backend/stolen_plates.txt): `Backend/stolen_plates.txt`
- [Challan generation](https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/challan_generator.py): `Backend/scripts/challan_generator.py`
- [Camera configuration](https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/config.py): `Backend/scripts/config.py`
- [Camera test runner](https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/main.py): `Backend/scripts/main.py`

### Backend services

- [FastAPI service](https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/server.py): `Backend/api/server.py`
- [Authentication](https://github.com/sreevathsans/speedcamera/blob/master/Backend/api/auth.py): `Backend/api/auth.py`
- [Event database manager](https://github.com/sreevathsans/speedcamera/blob/master/Backend/scripts/database_manager.py): `Backend/scripts/database_manager.py`
- **SQLite event store**

### Web experience

- [React application](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login page](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Client auth state](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/api/apiClient.js): `frontend/src/api/apiClient.js`
- [Role dashboard routing](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Admin dashboard](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/AdminDashboard.jsx): `frontend/src/components/AdminDashboard.jsx`
- [Public dashboard](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/PublicDashboard.jsx): `frontend/src/components/PublicDashboard.jsx`
- [Theme state](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/context/ThemeContext.jsx): `frontend/src/context/ThemeContext.jsx`
- [Navigation bar](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [Theme toggle](https://github.com/sreevathsans/speedcamera/blob/master/frontend/src/components/ThemeToggle.jsx): `frontend/src/components/ThemeToggle.jsx`

### Other components

- **Camera operator**
- **Dashboard user**

## Connections

- Camera operator → Video analysis: provides footage (evidence: `README.md`)
- Video analysis → Vehicle detection: detects vehicles
- Video analysis → Tracking and speed: tracks and measures (evidence: `Backend/api/server.py`)
- Tracking and speed → Camera configuration: uses calibration (evidence: `Backend/api/server.py`)
- Video analysis → Plate recognition: extracts plates
- Video analysis → Stolen plate check: checks plates
- Video analysis → Challan generation: generates challan (evidence: `README.md`)
- Camera operator → Camera test runner: runs test feed (evidence: `README.md`)
- Camera test runner → Camera configuration: uses settings (evidence: `Backend/scripts/main.py`)
- Dashboard user → React application: opens dashboard (evidence: `README.md`)
- React application → Login page: routes to (evidence: `frontend/src/App.jsx`)
- React application → Role dashboard routing: routes to (evidence: `frontend/src/App.jsx`)
- React application → Client auth state: provides auth (evidence: `frontend/src/App.jsx`)
- React application → Theme state: provides theme (evidence: `frontend/src/App.jsx`)
- React application → Navigation bar: renders (evidence: `frontend/src/App.jsx`)
- Login page → Client auth state: submits credentials (evidence: `frontend/src/pages/LoginPage.jsx`)
- Client auth state → API client: requests token (evidence: `frontend/src/context/AuthContext.jsx`)
- API client → FastAPI service: calls backend (evidence: `frontend/src/api/apiClient.js`)
- FastAPI service → Authentication: validates users (evidence: `Backend/api/server.py`)
- Role dashboard routing → Admin dashboard: renders admin view (evidence: `frontend/src/pages/HomePage.jsx`)
- Role dashboard routing → Public dashboard: renders public view (evidence: `frontend/src/pages/HomePage.jsx`)
- Admin dashboard → API client: fetches dashboard data (evidence: `frontend/src/components/AdminDashboard.jsx`)
- Public dashboard → API client: fetches events (evidence: `frontend/src/components/PublicDashboard.jsx`)
- Admin dashboard → FastAPI service: opens event socket (evidence: `frontend/src/components/AdminDashboard.jsx`)
- Admin dashboard → FastAPI service: loads camera feeds (evidence: `frontend/src/components/AdminDashboard.jsx`)
- Navigation bar → Theme toggle: renders (evidence: `frontend/src/components/Navbar.jsx`)
- Theme toggle → Theme state: toggles theme (evidence: `frontend/src/components/ThemeToggle.jsx`)
- FastAPI service → SQLite event store: reads and logs events (evidence: `README.md`)
- Challan generation → SQLite event store: stores challan data
