https://github.com/el-moudni-hicham/radar-violation-detection-system
This is a web-based application built using Spring Boot and Angular. It is a radar violation detection system.
https://github.com/el-moudni-hicham/radar-violation-detection-system
angular bootstrap eureka-discovery-service graphql grpc java rest-api soap spring-boot spring-cloud-gateway typescript
Last synced: 6 months ago
JSON representation
This is a web-based application built using Spring Boot and Angular. It is a radar violation detection system.
- Host: GitHub
- URL: https://github.com/el-moudni-hicham/radar-violation-detection-system
- Owner: el-moudni-hicham
- License: gpl-3.0
- Created: 2023-05-22T13:31:31.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-05-24T16:34:48.000Z (over 2 years ago)
- Last Synced: 2025-03-23T20:11:20.218Z (7 months ago)
- Topics: angular, bootstrap, eureka-discovery-service, graphql, grpc, java, rest-api, soap, spring-boot, spring-cloud-gateway, typescript
- Language: HTML
- Homepage:
- Size: 10.2 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Radar Violation Detection System
```
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.
```
# Table of Contents
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Technologies Used](#technologies-used)
- [Technical Architecture](#technical-architecture)
- [Class Diagram](#class-diagram)
- [Backend Services](#backend-services)
- [Regestration Service](#regestration-service)
- [Radar Service](#radar-service)
- [Infraction Service](#infraction-service)
- [Eureka Discovery Service](#eureka-discovery-service)
- [Gateway Service](#gateway-service)
- [Road Radar](#road-radar)
- [Frontend with Angular](#frontend-with-angular)
- [License](#license)
## Getting Started
### Prerequisites
Before running this application, you need to have the following software installed on your system :
```java
- Java Development Kit (JDK) version 11 or later
- Node.js version 14 or later
- Angular CLI version 13 or later
```
### Installation
Follow these steps to install and run the application :
1. Clone the repository :
```
git clone https://github.com/el-moudni-hicham/radar-violation-detection-system.git
```
2. Navigate to the backend directory and run the following command to start the each Spring Boot project :
```
./mvnw spring-boot:run
```
3. Navigate to the frontend directory and run the following command to install the required packages :
```
npm install
```
4. After the packages are installed, run the following command to start the Angular application :
```
ng serve
```
5. Open your browser and navigate to `http://localhost:4200` to access the application.
## Technologies Used
The following technologies and frameworks are used in this application:
- Spring Boot
- Spring Cloud
- Eureka Descovery
- Angular
- Bootstrap
- MySQL
## Functionalities
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.
## Technical Architecture
## Class Diagram
## Backend Services
The backend contains 5 services :
### Regestration Service
```
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`
All Vehicles
Find Vehicle By Id
Delete Vehicle
Update Vehicle
> b. GraphQL :
All Vehicles with specific attributs
Find Vehicle By Id with specific attributs
> c. SOAP :
Tests with `SoapUI`
All Owners
Find Owner By Id
> d. GRPC :
Tests with `BloomRPC`
All Owners
Find Owner By Id
####
### Radar Service
```
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 Service
```
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
### Eureka Discovery Service
```
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
│
### Gateway Service
```
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
### Road Radar
```
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
# Frontend with Angular
## Video Demonstration
https://github.com/el-moudni-hicham/radar-violation-detection-system/assets/85403056/7fd47b94-4f64-4155-86b4-5575ab3ed6ab
## Application Sceenshots
Login Page
Welcome Page
Dashboard Statistics
Radars Page
Sweet Alerts Example
Add New Radar
Vehicles and their Owners Page
Infractions Page
Show PDF
## License
This project is licensed under the GPL-3.0 license - see the LICENSE file for details.