# lavadevi30/smart-traffic-management architecture

> Architecture diagram of the GitHub repository lavadevi30/smart-traffic-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lavadevi30/smart-traffic-management
- Repository: https://github.com/lavadevi30/smart-traffic-management

## Overview

Smart Traffic Management Platform is a Spring REST backend for recording traffic data, managing intersections and timing plans, and reporting classified traffic status. The documented user flow is traffic simulator → REST API → PostgreSQL → dashboard; sampled code confirms controller-to-service calls, persistence repositories, and status classification using the active timing plan. The README documents the simulator, database, and dashboard, but their implementations are not in the tree. The graph therefore treats them as external and limits internal links to source-index references or shown calls.

Main entry points: [`application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java`](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java) (Traffic Analysis), [`application/backend/src/main/java/com/smarttraffic/backend/controller/TrafficDataController.java`](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/TrafficDataController.java) (REST API), [`application/backend/src/main/java/com/smarttraffic/backend/service/TimingPlanService.java`](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/TimingPlanService.java) (Timing Plan Service), [`application/backend/src/main/java/com/smarttraffic/backend/service/IntersectionService.java`](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/IntersectionService.java) (Intersection Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Traffic API"]
  node_api["REST API"]
  node_intersection_api["Intersection API"]
  node_plan_api["Timing Plan API"]
end

subgraph group_domain["Traffic Services"]
  node_traffic_service["Traffic Analysis"]
  node_intersection_service["Intersection Service"]
  node_plan_service["Timing Plan Service"]
  node_intersection_model["Intersection Model<br/>[Intersection.java]"]
  node_traffic_model["Traffic Data Model<br/>[TrafficData.java]"]
  node_plan_model["Timing Plan Model<br/>[TimingPlan.java]"]
  node_status_model["Traffic Status<br/>[TrafficStatus.java]"]
end

subgraph group_persistence["Persistence"]
  node_traffic_repo["Traffic Repository"]
  node_intersection_repo["Intersection Repository"]
  node_plan_repo["Timing Plan Repository"]
  node_postgres[("PostgreSQL")]
end

subgraph group_runtime["Runtime"]
  node_backend["Spring Application"]
  node_health["Health Endpoint"]
end

node_simulator(("Traffic Simulator"))
node_dashboard(("Traffic Dashboard"))

node_simulator -->|"sends data"| node_api
node_api -->|"calls"| node_traffic_service
node_intersection_api -->|"calls"| node_intersection_service
node_plan_api -->|"calls"| node_plan_service
node_traffic_service -->|"queries and saves"| node_traffic_repo
node_traffic_service -->|"gets active plan"| node_plan_service
node_traffic_service -->|"creates status"| node_status_model
node_intersection_service -->|"queries and saves"| node_intersection_repo
node_plan_service -->|"queries and saves"| node_plan_repo
node_traffic_repo -->|"operates on"| node_traffic_model
node_intersection_repo -->|"operates on"| node_intersection_model
node_plan_repo -->|"operates on"| node_plan_model
node_api -->|"persists through API"| node_postgres
node_postgres -->|"supplies stored data"| node_dashboard

click node_api "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/TrafficDataController.java"
click node_intersection_api "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/IntersectionController.java"
click node_plan_api "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/TimingPlanController.java"
click node_traffic_service "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java"
click node_intersection_service "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/IntersectionService.java"
click node_plan_service "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/TimingPlanService.java"
click node_intersection_model "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/Intersection.java"
click node_traffic_model "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/TrafficData.java"
click node_plan_model "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/TimingPlan.java"
click node_status_model "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/TrafficStatus.java"
click node_traffic_repo "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/repository/TrafficDataRepository.java"
click node_intersection_repo "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/repository/IntersectionRepository.java"
click node_plan_repo "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/repository/TimingPlanRepository.java"
click node_backend "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/BackendApplication.java"
click node_health "https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/HealthController.java"

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_api,node_intersection_api,node_plan_api toneBlue
class node_traffic_service,node_intersection_service,node_plan_service,node_intersection_model,node_traffic_model,node_plan_model,node_status_model toneAmber
class node_traffic_repo,node_intersection_repo,node_plan_repo,node_postgres toneMint
class node_backend,node_health toneRose
class node_simulator,node_dashboard toneIndigo
```

## Components

### Traffic API

- [REST API](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/TrafficDataController.java): `application/backend/src/main/java/com/smarttraffic/backend/controller/TrafficDataController.java`
- [Intersection API](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/IntersectionController.java): `application/backend/src/main/java/com/smarttraffic/backend/controller/IntersectionController.java`
- [Timing Plan API](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/TimingPlanController.java): `application/backend/src/main/java/com/smarttraffic/backend/controller/TimingPlanController.java`

### Traffic Services

- [Traffic Analysis](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java): `application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java`
- [Intersection Service](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/IntersectionService.java): `application/backend/src/main/java/com/smarttraffic/backend/service/IntersectionService.java`
- [Timing Plan Service](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/service/TimingPlanService.java): `application/backend/src/main/java/com/smarttraffic/backend/service/TimingPlanService.java`
- [Intersection Model](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/Intersection.java): `application/backend/src/main/java/com/smarttraffic/backend/model/Intersection.java`
- [Traffic Data Model](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/TrafficData.java): `application/backend/src/main/java/com/smarttraffic/backend/model/TrafficData.java`
- [Timing Plan Model](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/TimingPlan.java): `application/backend/src/main/java/com/smarttraffic/backend/model/TimingPlan.java`
- [Traffic Status](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/model/TrafficStatus.java): `application/backend/src/main/java/com/smarttraffic/backend/model/TrafficStatus.java`

### Persistence

- [Traffic Repository](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/repository/TrafficDataRepository.java): `application/backend/src/main/java/com/smarttraffic/backend/repository/TrafficDataRepository.java`
- [Intersection Repository](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/repository/IntersectionRepository.java): `application/backend/src/main/java/com/smarttraffic/backend/repository/IntersectionRepository.java`
- [Timing Plan Repository](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/repository/TimingPlanRepository.java): `application/backend/src/main/java/com/smarttraffic/backend/repository/TimingPlanRepository.java`
- **PostgreSQL**

### Runtime

- [Spring Application](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/BackendApplication.java): `application/backend/src/main/java/com/smarttraffic/backend/BackendApplication.java`
- [Health Endpoint](https://github.com/lavadevi30/smart-traffic-management/blob/main/application/backend/src/main/java/com/smarttraffic/backend/controller/HealthController.java): `application/backend/src/main/java/com/smarttraffic/backend/controller/HealthController.java`

### Other components

- **Traffic Simulator**
- **Traffic Dashboard**

## Connections

- Traffic Simulator → REST API: sends data (evidence: `README.md`)
- REST API → Traffic Analysis: calls (evidence: `application/backend/src/main/java/com/smarttraffic/backend/controller/TrafficDataController.java`)
- Intersection API → Intersection Service: calls (evidence: `application/backend/src/main/java/com/smarttraffic/backend/controller/IntersectionController.java`)
- Timing Plan API → Timing Plan Service: calls (evidence: `application/backend/src/main/java/com/smarttraffic/backend/controller/TimingPlanController.java`)
- Traffic Analysis → Traffic Repository: queries and saves (evidence: `application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java`)
- Traffic Analysis → Timing Plan Service: gets active plan (evidence: `application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java`)
- Traffic Analysis → Traffic Status: creates status (evidence: `application/backend/src/main/java/com/smarttraffic/backend/service/TrafficDataService.java`)
- Intersection Service → Intersection Repository: queries and saves (evidence: `application/backend/src/main/java/com/smarttraffic/backend/service/IntersectionService.java`)
- Timing Plan Service → Timing Plan Repository: queries and saves (evidence: `application/backend/src/main/java/com/smarttraffic/backend/service/TimingPlanService.java`)
- Traffic Repository → Traffic Data Model: operates on (evidence: `application/backend/src/main/java/com/smarttraffic/backend/repository/TrafficDataRepository.java`)
- Intersection Repository → Intersection Model: operates on (evidence: `application/backend/src/main/java/com/smarttraffic/backend/repository/IntersectionRepository.java`)
- Timing Plan Repository → Timing Plan Model: operates on (evidence: `application/backend/src/main/java/com/smarttraffic/backend/repository/TimingPlanRepository.java`)
- REST API → PostgreSQL: persists through API (evidence: `README.md`)
- PostgreSQL → Traffic Dashboard: supplies stored data (evidence: `README.md`)
