# vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system architecture

> Architecture diagram of the GitHub repository vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system
- Repository: https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system

## Overview

The product is a FastAPI-based BRT corridor monitoring and automated e-challan system. Video sources feed live detection and tracking; the application checks lane intrusion and vehicle authorization, reads plates, tracks distance-based enforcement stages, and dispatches alerts and evidence-backed challans. The dashboard exposes live monitoring and enforcement results. The README documents several capabilities not fully visible in the excerpts; those links are cited to it rather than presented as inspected implementation details.

Main entry points: [`backend/app/main.py`](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py) (FastAPI Application), [`backend/app/services/intrusion.py`](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/intrusion.py) (Intrusion & Fine Stages), [`backend/app/services/sms.py`](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/sms.py) (SMS Notifications), [`backend/app/services/db.py`](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/db.py) (PostgreSQL Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitoring["Live Monitoring"]
  node_application["FastAPI Application<br/>[main.py]"]
  node_dashboard["Operations Dashboard<br/>[index.html]"]
  node_video_feed["Live MJPEG Feed<br/>[main.py]"]
end

subgraph group_detection["Detection &amp; Enforcement"]
  node_tracking["Vehicle Detection &amp; Tracking<br/>[main.py]"]
  node_lane_check["Lane Geometry &amp; Distance<br/>[lane.py]"]
  node_authorization["Vehicle Authorization<br/>[authorization.py]"]
  node_plate_reader["Plate Recognition<br/>[anpr.py]"]
  node_intrusion_tracker["Intrusion &amp; Fine Stages<br/>[intrusion.py]"]
  node_penalty_policy["Penalty Policy<br/>[config.py]"]
end

subgraph group_alerts["Alerts &amp; Evidence"]
  node_sms_service["SMS Notifications<br/>[sms.py]"]
  node_evidence_capture["Evidence Snapshots<br/>[main.py]"]
  node_challan_generator["PDF E-Challan &amp; Digest<br/>[challan.py]"]
end

subgraph group_persistence["Persistence"]
  node_database[("PostgreSQL Records<br/>[db.py]")]
end

node_operator(("Operator"))
node_video_sources(("CCTV / Video"))
node_sms_provider["Twilio Gateway"]
node_postgresql[("PostgreSQL")]

node_operator -->|"opens dashboard"| node_dashboard
node_video_sources -->|"provide frames"| node_tracking
node_application -->|"renders"| node_dashboard
node_application -->|"streams"| node_video_feed
node_tracking -->|"checks lane and distance"| node_lane_check
node_tracking -->|"classifies vehicles"| node_authorization
node_tracking -->|"reads plates"| node_plate_reader
node_tracking -->|"updates intrusion state"| node_intrusion_tracker
node_intrusion_tracker -->|"uses thresholds"| node_penalty_policy
node_application -->|"dispatches stage alerts"| node_sms_service
node_sms_service -.->|"sends via Twilio"| node_sms_provider
node_application -->|"captures snapshots"| node_evidence_capture
node_application -->|"generates PDF"| node_challan_generator
node_application -->|"persists and reads records"| node_database
node_database -->|"stores records"| node_postgresql

click node_application "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py"
click node_dashboard "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/templates/index.html"
click node_video_feed "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py"
click node_tracking "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py"
click node_lane_check "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/lane.py"
click node_authorization "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/authorization.py"
click node_plate_reader "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/anpr.py"
click node_intrusion_tracker "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/intrusion.py"
click node_penalty_policy "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/config.py"
click node_sms_service "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/sms.py"
click node_evidence_capture "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py"
click node_challan_generator "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/challan.py"
click node_database "https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/db.py"

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_application,node_dashboard,node_video_feed toneBlue
class node_tracking,node_lane_check,node_authorization,node_plate_reader,node_intrusion_tracker,node_penalty_policy,node_postgresql toneAmber
class node_sms_service,node_evidence_capture,node_challan_generator toneMint
class node_database toneRose
class node_operator,node_video_sources,node_sms_provider toneIndigo
```

## Components

### Live Monitoring

- [FastAPI Application](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py): `backend/app/main.py`
- [Operations Dashboard](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/templates/index.html): `backend/app/templates/index.html`
- [Live MJPEG Feed](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py): `backend/app/main.py`

### Detection & Enforcement

- [Vehicle Detection & Tracking](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py): `backend/app/main.py`
- [Lane Geometry & Distance](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/lane.py): `backend/app/services/lane.py`
- [Vehicle Authorization](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/authorization.py): `backend/app/services/authorization.py`
- [Plate Recognition](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/anpr.py): `backend/app/services/anpr.py`
- [Intrusion & Fine Stages](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/intrusion.py): `backend/app/services/intrusion.py`
- [Penalty Policy](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/config.py): `backend/app/services/config.py`

### Alerts & Evidence

- [SMS Notifications](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/sms.py): `backend/app/services/sms.py`
- [Evidence Snapshots](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/main.py): `backend/app/main.py`
- [PDF E-Challan & Digest](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/challan.py): `backend/app/services/challan.py`

### Persistence

- [PostgreSQL Records](https://github.com/vaishnavigiri1210/automated-pmpml-brt-lane-intrusion-detection-vehicle-tracking-and-dynamic-fine-management-system/blob/main/backend/app/services/db.py): `backend/app/services/db.py`

### Other components

- **Operator**
- **CCTV / Video**
- **Twilio Gateway**
- **PostgreSQL**

## Connections

- Operator → Operations Dashboard: opens dashboard (evidence: `README.md`)
- CCTV / Video → Vehicle Detection & Tracking: provide frames (evidence: `README.md`)
- FastAPI Application → Operations Dashboard: renders (evidence: `backend/app/main.py`)
- FastAPI Application → Live MJPEG Feed: streams (evidence: `backend/app/main.py`)
- Vehicle Detection & Tracking → Lane Geometry & Distance: checks lane and distance (evidence: `backend/app/main.py`)
- Vehicle Detection & Tracking → Vehicle Authorization: classifies vehicles (evidence: `backend/app/main.py`)
- Vehicle Detection & Tracking → Plate Recognition: reads plates (evidence: `backend/app/main.py`)
- Vehicle Detection & Tracking → Intrusion & Fine Stages: updates intrusion state (evidence: `README.md`)
- Intrusion & Fine Stages → Penalty Policy: uses thresholds (evidence: `backend/app/services/intrusion.py`)
- FastAPI Application → SMS Notifications: dispatches stage alerts (evidence: `backend/app/main.py`)
- SMS Notifications → Twilio Gateway: sends via Twilio (evidence: `backend/app/services/sms.py`)
- FastAPI Application → Evidence Snapshots: captures snapshots (evidence: `backend/app/main.py`)
- FastAPI Application → PDF E-Challan & Digest: generates PDF (evidence: `backend/app/main.py`)
- FastAPI Application → PostgreSQL Records: persists and reads records (evidence: `backend/app/main.py`)
- PostgreSQL Records → PostgreSQL: stores records (evidence: `README.md`)
