Air Quality Dashboard

Demo video available by clicking on the image

A small application to provide details on air quality for a certain city/coordinates.

This work aims to demonstrate the student's ability to test a platform through JUnit, Mockito, Selenium, etc.

Built with:

Angular

Spring Boot

Architecture

Components

• Web Application (Angular)
• Service (Spring Boot)

How to Run

To run the system, Docker Compose must be installed and updated.

That said, the steps are as follows:

1. Change the Angular environment to do the requests of the API to your machine

   Example to run on localhost. If you are hosting in another machine, the IP address of it should be in the place of localhost.

   • Change the environment.prod.ts file as the following:

   import { HttpHeaders } from '@angular/common/http';
   export const environment = {
     httpOptions: {
       headers: new HttpHeaders({'Content-Type': 'application/json'})
     },
     baseURL: 'http://localhost:8080/api/',
     production: true
   };
   

2. Compile services for the execution of containers Docker, running at the root of the repository:

   $ docker-compose build
   

3. Start the containers:

   $ docker-compose up -d
   

The Web application will be available at: localhost

Deploy

The system was made available through the Google Cloud Platform and according to this guide, using free tier. Briefly, a VM was created, the repository was cloned, the baseURL was changed in the environment.prod.ts file to match the machine's IP and the Docker Compose was executed according to the guide and with the 1.27.4 version to support the 3.8 version of the Compose file. Finally, in the Firewall definitions, ports 80 and 8080 were opened to allow access to the web application and service, respectively.

Web application available at: 35.246.89.129

API docs available at: 35.246.89.129:8080/api/swagger-ui/index.html

Static Code Analysis with SonarQube available at: 34.89.73.181:9000

• Login: admin
• Password: tqs-p1

Details and Tests

You can find all the details and Tests info in the Work Report. Be aware, the Work Report was made in Portuguese.

Grade

Evaluated with 20 out of 20.