This is a web-based application built using Spring Boot and Angular. It is a radar violation detection
system It aims to detect and track radar violations, providing real-time notifications and reporting
reporting for efficient traffic management.
The backend is built using Spring Boot , while the frontend is built using Angular with Bootstrap for
the user interface.
In addition to the standard operations of data querying and modification, the system allow for
the submission of a speeding violation, resulting in an offense record. Furthermore, it should enable
vehicle owners to view their own violations, providing them with easy access to their offense history.
- Getting Started
- Technologies Used
- Technical Architecture
- Class Diagram
- Backend Services
- Frontend with Angular
- License
Before running this application, you need to have the following software installed on your system :
- Java Development Kit (JDK) version 11 or later
- Node.js version 14 or later
- Angular CLI version 13 or laterFollow these steps to install and run the application :
- Clone the repository :
git clone https://github.com/el-moudni-hicham/radar-violation-detection-system.git
- Navigate to the backend directory and run the following command to start the each Spring Boot project :
./mvnw spring-boot:run
- Navigate to the frontend directory and run the following command to install the required packages :
npm install
- After the packages are installed, run the following command to start the Angular application :
ng serve
- Open your browser and navigate to
http://localhost:4200to access the application.
The following technologies and frameworks are used in this application:
- Spring Boot
- Spring Cloud
- Eureka Descovery
- Angular
- Bootstrap
- MySQL
The application allows performing the following operations:
- Submit a speeding violation.
- View violations of a vehicle owner.
- Modify and view radar data.
- Modify and view vehicle and owner data.
- Modify and view infraction data.
The backend contains 5 services :
Registration microservice manages vehicles owned by owners. Each vehicle belongs to a single owner.
An owner is defined by their ID, name, date of birth, email.
A vehicle is defined by its ID, regestration number, brand, fiscal power, and model
- Service Structure
├───src │ ├───main │ │ ├───java │ │ │ └───ma │ │ │ └───enset │ │ │ └───regestrationservice │ │ │ │ RegestrationServiceApplication.java │ │ │ │ │ │ │ ├───entites │ │ │ │ Owner.java │ │ │ │ OwnerRequest.java │ │ │ │ Vehicle.java │ │ │ │ │ │ │ ├───repositories │ │ │ │ OwnerRepository.java │ │ │ │ VehicleRepository.java │ │ │ │ │ │ │ └───web │ │ │ ├───graphql │ │ │ │ OwnerGraphqlController.java │ │ │ │ VehicleGraphqlController.java │ │ │ │ │ │ │ ├───grpc │ │ │ │ │ GrpcConfig.java │ │ │ │ │ OwnerGrpcService.java │ │ │ │ │ │ │ │ │ └───stub │ │ │ │ OwnerGrpcServiceGrpc.java │ │ │ │ OwnerService.java │ │ │ │ │ │ │ ├───rest │ │ │ │ OwnerRestController.java │ │ │ │ VehicleRestController.java │ │ │ │ │ │ │ └───soap │ │ │ CXFSoapWebServiceConfig.java │ │ │ OwnerSoapController.java │ │ │ OwnerSoapService.java │ │ │ │ │ └───resources │ │ │ application.properties │ │ │ owner-service.proto │ │ │ xsd-schema.xsd │ │ │ │ │ ├───graphql │ │ │ schema.graphqls │ │ │ │ │ ├───static │ │ └───templates
- Web services integration REST, GraphQL, SOAP et GRPC :
a. REST :
Tests with Postman
|
|
|
|
|
|
|
|
b. GraphQL :
|
|
|
|
c. SOAP :
Tests with SoapUI
|
|
|
|
d. GRPC :
Tests with BloomRPC
|
|
|
|
Radar microservice responsible for managing radars handles radar entities defined
by their ID, maximum speed limit, and coordinates (longitude and latitude)
- Service Structure
├───src │ ├───main │ │ ├───java │ │ │ └───ma │ │ │ └───enset │ │ │ └───radarservice │ │ │ │ RadarServiceApplication.java │ │ │ │ │ │ │ ├───entites │ │ │ │ Radar.java │ │ │ │ │ │ │ ├───feign │ │ │ │ InfractionRestClient.java │ │ │ │ │ │ │ ├───models │ │ │ │ Infraction.java │ │ │ │ NewData.java │ │ │ │ │ │ │ ├───repositories │ │ │ │ RadarRepository.java │ │ │ │ │ │ │ └───web │ │ │ RadarRestController.java │ │ │ │ │ └───resources │ │ │ application.properties │ │ │ radar-service.proto │ │ │ │ │ ├───static │ │ └───templates
Infraction microservice responsible for managing violations handles each violation, which is defined
by its ID, date, the radar number that detected the offense, the vehicle regestration number,
the vehicle's speed, the radar's maximum speed limit, and the fine amount.
- Service Structure
├───src │ ├───main │ │ ├───java │ │ │ └───ma │ │ │ └───enset │ │ │ └───infractionservice │ │ │ │ InfractionServiceApplication.java │ │ │ │ │ │ │ ├───entites │ │ │ │ Infraction.java │ │ │ │ │ │ │ ├───feign │ │ │ │ RadarRestClient.java │ │ │ │ VehicleRestClient.java │ │ │ │ │ │ │ ├───models │ │ │ │ NewData.java │ │ │ │ Owner.java │ │ │ │ Radar.java │ │ │ │ Vehicle.java │ │ │ │ │ │ │ ├───repositories │ │ │ │ InfractionRepository.java │ │ │ │ │ │ │ └───web │ │ │ InfractionRestController.java │ │ │ │ │ └───resources │ │ │ application.properties │ │ │ │ │ ├───static │ │ └───templates
server-side component in the Netflix OSS stack that allows services to register
and discover each other in a microservices architecture.
- Service Structure
├───src │ ├───main │ │ ├───java │ │ │ └───ma │ │ │ └───enset │ │ │ └───eurekadiscovery │ │ │ EurekaDiscoveryApplication.java │ │ │ │ │ └───resources │ │ application.properties │ │ │ └───test │ └───java │ └───ma │ └───enset │ └───eurekadiscovery │ EurekaDiscoveryApplicationTests.java │
Spring Cloud Gateway It provides a centralized entry point for routing and filtering requests
to microservices in a distributed system, enabling dynamic and scalable routing based on various criteria.
- Service Structure
├───src │ ├───main │ │ ├───java │ │ │ └───ma │ │ │ └───enset │ │ │ └───gateway │ │ │ GatewayApplication.java │ │ │ │ │ └───resources │ │ application.properties │ │ application.yml
A Java application that simulates a radar system generating random speeding violations
and sending them to the Radar-Service.
- Service Structure
├───src │ ├───main │ │ ├───java │ │ │ └───ma │ │ │ └───enset │ │ │ └───radarroad │ │ │ │ RadarDetectionService.java │ │ │ │ RadarRoadApplication.java │ │ │ │ │ │ │ └───models │ │ │ NewData.java │ │ │ Radar.java │ │ │ Vehicle.java │ │ │ │ │ └───resources │ │ │ application.properties │ │ │ │ │ ├───static │ │ └───templates
- Test
|
|
v-radar-demo-video.mp4
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This project is licensed under the GPL-3.0 license - see the LICENSE file for details.