L'Aquila Smart Road Plateform

For the Project of Software Oriented at @Univaq:

It's built using Spring Boot and Angular, designed as a monitor violation detection system. Its primary goal is to monitor vehicules violations.

The backend is implemented with Spring Boot, while the frontend utilizes Angular and Bootstrap for the user interface.

Beyond standard data querying and modification, the system allows for the submission of speeding violations, resulting in an offense record. Additionally, it enables vehicle owners to view their own violations, giving them easy access to their offense history.

Frontend with Angular

Video Demonstration

Walkthrough.mp4

Application Sceenshots

Login Page

Dashboard Statistics

Monitors Page

Add New Monitor

Vehicles and their Owners Page

Amends Page

Show PDF

Table of Contents

• Getting Started
  • Prerequisites
  • Installation
• Technologies Used
• Technical Architecture
• Class Diagram
• Backend Services
  • Vehicule Service
  • Monitor Prosumer
  • Amend Prosumer
  • Eureka Discovery Service
  • Gateway Service
  • Data Generator Service
• Frontend with Angular
• License

Getting Started

Prerequisites

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 later
- Docker

Installation

Follow these steps to install and run the application :

1. Clone the repository :

git clone https://github.com/adam-bouafia/L-Aquila-Smart-Roads.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
• Docker

Functionalities

The application allows performing the following operations:

• Submit a speeding violation.
• View violations of a vehicle owner.
• Modify and view monitor data.
• Modify and view vehicle and owner data.
• Modify and view amend data.

Technical Architecture

Class Diagram

Backend Services

The backend contains 5 services :

Vehicule 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, Vehicule number, brand, fiscal power, and model

• Service Structure

├───src
│   ├───main
│   │   ├───java
│   │   │   └───univaq
│   │   │       └───disim
                └───sose
│   │   │           └───Vehiculeservice
│   │   │               │   VehiculeServiceApplication.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 attributes

c. SOAP :

Tests with SoapUI

All Owners

d. GRPC :

Tests with BloomRPC

All Owners

Find Owner By Id

Monitor Prosumer

Monitor microservice responsible for managing monitors handles monitor entities defined
by their ID, maximum speed limit, and coordinates (longitude and latitude)

• Service Structure

├───src
│   ├───main
│   │   ├───java
│   │   │   └───univaq
│   │   │       └───disim
                 └───sose
│   │   │           └───monitorprosumer
│   │   │               │   MonitorProsumerApplication.java
│   │   │               │
│   │   │               ├───entites
│   │   │               │       Monitor.java
│   │   │               │
│   │   │               ├───feign
│   │   │               │       amendRestClient.java
│   │   │               │
│   │   │               ├───models
│   │   │               │       amend.java
│   │   │               │       NewData.java
│   │   │               │
│   │   │               ├───repositories
│   │   │               │       MonitorRepository.java
│   │   │               │
│   │   │               └───web
│   │   │                       MonitorRestController.java
│   │   │
│   │   └───resources
│   │       │   application.properties
│   │       │   Monitor-Prosumer.proto
│   │       │
│   │       ├───static
│   │       └───templates

Amend Prosumer

amend microservice responsible for managing violations handles each violation, which is defined
by its ID, date, the monitor number that detected the offense, the vehicle Vehicule number,
the vehicle's speed, the monitor's maximum speed limit, and the fine amount.

• Service Structure

├───src
│   ├───main
│   │   ├───java
│   │   │   └───univaq
│   │   │       └───disim
                  └───sose
│   │   │           └───amendservice
│   │   │               │   amendServiceApplication.java
│   │   │               │
│   │   │               ├───entites
│   │   │               │       amend.java
│   │   │               │
│   │   │               ├───feign
│   │   │               │       MonitorRestClient.java
│   │   │               │       VehicleRestClient.java
│   │   │               │
│   │   │               ├───models
│   │   │               │       NewData.java
│   │   │               │       Owner.java
│   │   │               │       Monitor.java
│   │   │               │       Vehicle.java
│   │   │               │
│   │   │               ├───repositories
│   │   │               │       amendRepository.java
│   │   │               │
│   │   │               └───web
│   │   │                       amendRestController.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
│   │   │   └───univaq
│   │   │       └───disim
                  └───sose
│   │   │           └───eurekadiscovery
│   │   │                   EurekaDiscoveryApplication.java
│   │   │
│   │   └───resources
│   │           application.properties
│   │
│   └───test
│       └───java
│           └───univaq
│               └───disim
                  └───sose
│                   └───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
│   │   │   └───univaq
│   │   │       └───disim
                  └───sose
│   │   │           └───gateway
│   │   │                   GatewayApplication.java
│   │   │
│   │   └───resources
│   │           application.properties
│   │           application.yml

Data Generator Service

A Java application that simulates a monitor system generating random speeding violations
and sending them to the Monitor-Prosumer.

• Service Structure

├───src
│   ├───main
│   │   ├───java
│   │   │   └───univaq
│   │   │       └───disim
                  └───sose
│   │   │           └───monitorroad
│   │   │               │   MonitorDetectionService.java
│   │   │               │   MonitorRoadApplication.java
│   │   │               │
│   │   │               └───models
│   │   │                       NewData.java
│   │   │                       Monitor.java
│   │   │                       Vehicle.java
│   │   │
│   │   └───resources
│   │       │   application.properties
│   │       │
│   │       ├───static
│   │       └───templates

• Test

roject example" 

License

This project is licensed under the GPL-3.0 license - see the LICENSE file for details.