# amenmnx/radar-monitoring-system architecture

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

- Interactive diagram: https://gitdiagram.com/amenmnx/radar-monitoring-system
- Repository: https://github.com/amenmnx/radar-monitoring-system

## Overview

This is a hybrid radar-station monitoring and traffic-enforcement platform. Users enter through the React application to manage or review radar, detection, vehicle, and violation information; frontend-owned accounts, vehicles, detections, violations, and payment status are stored locally, while radar stations, telemetry, and alerts are handled by the Spring REST API. The diagram preserves these separate responsibilities and shows backend service-to-repository calls where source evidence is available. Several frontend pages and backend telemetry wiring are represented at subsystem level because their implementations were not sampled.

Main entry points: [`Radar-System-monitoring-main/src/router.tsx`](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/router.tsx) (Route dispatch), [`Radar-System-monitoring-main/src/lib/store.tsx`](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/lib/store.tsx) (Application state), [`backend/src/main/java/com/radar/monitoring/service/RadarStationService.java`](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/RadarStationService.java) (Radar station service), [`Radar-System-monitoring-main/src/lib/api.ts`](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/lib/api.ts) (REST API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_router["Route dispatch<br/>[router.tsx]"]
  node_screens["Radar and dashboard pages"]
  node_detection_pages["Detection pages<br/>[detections.tsx]"]
  node_vehicle_pages["Vehicle pages<br/>[mon-vehicule.tsx]"]
  node_violation_pages["Violation pages<br/>[violations.tsx]"]
  node_user_pages["Login and user pages<br/>[login.tsx]"]
  node_ui["Shared application UI<br/>[AppLayout.tsx]"]
  node_api_client["REST API client<br/>[api.ts]"]
end

subgraph group_local["Local application data"]
  node_app_store["Application state<br/>[store.tsx]"]
  node_local_storage[("Browser storage")]
end

subgraph group_backend["Radar API"]
  node_radar_api["Radar REST controllers"]
  node_radar_service["Radar station service"]
  node_alert_api["Alert controller"]
  node_alert_service["Alert service"]
  node_telemetry_api["Telemetry endpoint"]
  node_telemetry_service["Telemetry service"]
end

subgraph group_persistence["Backend persistence"]
  node_radar_repository["Radar station repository"]
  node_alert_repository["Alert repository"]
  node_telemetry_repository["Telemetry repository"]
  node_h2[("H2 database")]
end

node_user(("Administrator or user"))

node_user -->|"opens pages"| node_router
node_router -->|"dispatches routes"| node_screens
node_router -->|"dispatches routes"| node_detection_pages
node_router -->|"dispatches routes"| node_vehicle_pages
node_router -->|"dispatches routes"| node_violation_pages
node_router -->|"dispatches routes"| node_user_pages
node_screens -.->|"uses state"| node_app_store
node_detection_pages -.->|"uses state"| node_app_store
node_vehicle_pages -.->|"uses state"| node_app_store
node_violation_pages -.->|"uses state"| node_app_store
node_user_pages -.->|"uses state"| node_app_store
node_screens -.->|"renders layout"| node_ui
node_app_store -->|"persists state"| node_local_storage
node_api_client -->|"calls REST API"| node_radar_api
node_api_client -->|"calls REST API"| node_alert_api
node_api_client -->|"calls REST API"| node_telemetry_api
node_radar_api -->|"delegates"| node_radar_service
node_radar_service -->|"reads and writes"| node_radar_repository
node_alert_api -->|"delegates"| node_alert_service
node_alert_service -->|"reads and writes"| node_alert_repository
node_alert_service -->|"looks up radar"| node_radar_service
node_telemetry_service -->|"reads and writes"| node_telemetry_repository
node_telemetry_service -->|"uses radar service"| node_radar_service
node_radar_repository -.->|"stores entities"| node_h2
node_alert_repository -.->|"stores entities"| node_h2
node_telemetry_repository -.->|"stores readings"| node_h2

click node_router "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/router.tsx"
click node_screens "https://github.com/amenmnx/radar-monitoring-system/tree/main/Radar-System-monitoring-main/src/routes"
click node_detection_pages "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/detections.tsx"
click node_vehicle_pages "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/mon-vehicule.tsx"
click node_violation_pages "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/violations.tsx"
click node_user_pages "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/login.tsx"
click node_ui "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/components/AppLayout.tsx"
click node_api_client "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/lib/api.ts"
click node_app_store "https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/lib/store.tsx"
click node_radar_api "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/controller/RadarStationController.java"
click node_radar_service "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/RadarStationService.java"
click node_radar_repository "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/repository/RadarStationRepository.java"
click node_alert_api "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/controller/RadarAlertController.java"
click node_alert_service "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/RadarAlertService.java"
click node_alert_repository "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/repository/RadarAlertRepository.java"
click node_telemetry_api "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/controller/TelemetryController.java"
click node_telemetry_service "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/TelemetryService.java"
click node_telemetry_repository "https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/repository/TelemetryReadingRepository.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_router,node_screens,node_detection_pages,node_vehicle_pages,node_violation_pages,node_user_pages,node_ui,node_api_client,node_user toneBlue
class node_app_store,node_local_storage toneAmber
class node_radar_api,node_radar_service,node_alert_api,node_alert_service,node_telemetry_api,node_telemetry_service toneMint
class node_radar_repository,node_alert_repository,node_telemetry_repository,node_h2 toneRose
```

## Components

### Frontend experience

- [Route dispatch](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/router.tsx): `Radar-System-monitoring-main/src/router.tsx`
- [Radar and dashboard pages](https://github.com/amenmnx/radar-monitoring-system/tree/main/Radar-System-monitoring-main/src/routes): `Radar-System-monitoring-main/src/routes`
- [Detection pages](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/detections.tsx): `Radar-System-monitoring-main/src/routes/detections.tsx`
- [Vehicle pages](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/mon-vehicule.tsx): `Radar-System-monitoring-main/src/routes/mon-vehicule.tsx`
- [Violation pages](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/violations.tsx): `Radar-System-monitoring-main/src/routes/violations.tsx`
- [Login and user pages](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/routes/login.tsx): `Radar-System-monitoring-main/src/routes/login.tsx`
- [Shared application UI](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/components/AppLayout.tsx): `Radar-System-monitoring-main/src/components/AppLayout.tsx`
- [REST API client](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/lib/api.ts): `Radar-System-monitoring-main/src/lib/api.ts`

### Local application data

- [Application state](https://github.com/amenmnx/radar-monitoring-system/blob/main/Radar-System-monitoring-main/src/lib/store.tsx): `Radar-System-monitoring-main/src/lib/store.tsx`
- **Browser storage**

### Radar API

- [Radar REST controllers](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/controller/RadarStationController.java): `backend/src/main/java/com/radar/monitoring/controller/RadarStationController.java`
- [Radar station service](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/RadarStationService.java): `backend/src/main/java/com/radar/monitoring/service/RadarStationService.java`
- [Alert controller](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/controller/RadarAlertController.java): `backend/src/main/java/com/radar/monitoring/controller/RadarAlertController.java`
- [Alert service](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/RadarAlertService.java): `backend/src/main/java/com/radar/monitoring/service/RadarAlertService.java`
- [Telemetry endpoint](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/controller/TelemetryController.java): `backend/src/main/java/com/radar/monitoring/controller/TelemetryController.java`
- [Telemetry service](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/service/TelemetryService.java): `backend/src/main/java/com/radar/monitoring/service/TelemetryService.java`

### Backend persistence

- [Radar station repository](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/repository/RadarStationRepository.java): `backend/src/main/java/com/radar/monitoring/repository/RadarStationRepository.java`
- [Alert repository](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/repository/RadarAlertRepository.java): `backend/src/main/java/com/radar/monitoring/repository/RadarAlertRepository.java`
- [Telemetry repository](https://github.com/amenmnx/radar-monitoring-system/blob/main/backend/src/main/java/com/radar/monitoring/repository/TelemetryReadingRepository.java): `backend/src/main/java/com/radar/monitoring/repository/TelemetryReadingRepository.java`
- **H2 database**

### Other components

- **Administrator or user**

## Connections

- Administrator or user → Route dispatch: opens pages (evidence: `README.md`)
- Route dispatch → Radar and dashboard pages: dispatches routes (evidence: `Radar-System-monitoring-main/src/routeTree.gen.ts`)
- Route dispatch → Detection pages: dispatches routes (evidence: `Radar-System-monitoring-main/src/routeTree.gen.ts`)
- Route dispatch → Vehicle pages: dispatches routes (evidence: `Radar-System-monitoring-main/src/routeTree.gen.ts`)
- Route dispatch → Violation pages: dispatches routes (evidence: `Radar-System-monitoring-main/src/routeTree.gen.ts`)
- Route dispatch → Login and user pages: dispatches routes (evidence: `Radar-System-monitoring-main/src/routeTree.gen.ts`)
- Radar and dashboard pages → Application state: uses state
- Detection pages → Application state: uses state
- Vehicle pages → Application state: uses state
- Violation pages → Application state: uses state
- Login and user pages → Application state: uses state
- Radar and dashboard pages → Shared application UI: renders layout
- Application state → Browser storage: persists state (evidence: `README.md`)
- REST API client → Radar REST controllers: calls REST API (evidence: `README.md`)
- REST API client → Alert controller: calls REST API (evidence: `README.md`)
- REST API client → Telemetry endpoint: calls REST API (evidence: `README.md`)
- Radar REST controllers → Radar station service: delegates (evidence: `backend/src/main/java/com/radar/monitoring/controller/RadarStationController.java`)
- Radar station service → Radar station repository: reads and writes (evidence: `backend/src/main/java/com/radar/monitoring/service/RadarStationService.java`)
- Alert controller → Alert service: delegates (evidence: `backend/src/main/java/com/radar/monitoring/controller/RadarAlertController.java`)
- Alert service → Alert repository: reads and writes (evidence: `backend/src/main/java/com/radar/monitoring/service/RadarAlertService.java`)
- Alert service → Radar station service: looks up radar (evidence: `backend/src/main/java/com/radar/monitoring/service/RadarAlertService.java`)
- Telemetry service → Telemetry repository: reads and writes (evidence: `backend/src/main/java/com/radar/monitoring/service/TelemetryService.java`)
- Telemetry service → Radar station service: uses radar service (evidence: `backend/src/main/java/com/radar/monitoring/service/TelemetryService.java`)
- Radar station repository → H2 database: stores entities
- Alert repository → H2 database: stores entities
- Telemetry repository → H2 database: stores readings
