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

https://github.com/user-attachments/assets/9307b89d-045d-457d-b22a-9f3ff03d31f3

Application Sceenshots

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

• 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

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

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

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

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

Data Generator Service

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

• Service Structure

• Test

License

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