Glucose Guardian WebBackend

Introduzione

Questa repo contiene il codice sorgente del backend del progetto Glucose Guardian, basato sul framework Java Spring Boot e DBMS PostgreSQL.

Installazione con Docker

Creare l'immagine docker dai sorgenti (Opzionale)

1. Installare Git e Docker

2. Aprire un terminale e clonare questo progetto:

   git clone https://github.com/c01-glucoseguardian/webbackend
   

3. Spostarsi nella cartella webbackend:

   cd webbackend
   

4. Effettuare tutte le modifiche necessarie al file di configurazione in src/main/java/resources/application.properties (Opzionale)

5. Compilare l'immagine Docker:

   docker build -t c01glucoseguardian/webbackend .
   

Lanciare l'immagine Docker

Warning
Il server non si avvierà senza una connessione con il DBMS PostgreSQL. È quindi importante configurare correttamente tali parametri in production.properties

Note
Per utilizzare un'istanza di PostgreSQL locale, potete utilizzare il dominio host.docker.internal o l'ip 172.17.0.1.
In tal caso verificare che la configurazione di PostgreSQL accetti connessioni dalla subnet 172.17.0.0/16 (la default per la rete bridge di Docker)

Un esempio di commando per eseguire l'immagine Docker è il seguente:

 docker run --name webbackend -p 8081:8080 -v ./production.properties:/config/production.properties:ro -d c01glucoseguardian/webbackend

Dove:

• --name indica il nome da dare al container.
• -p 8081:8080 espone la porta 8080 del container sulla porta 8081 dell'host.
• -v ./production.properties:/config/production.properties:ro monta il file di configurazione locale production.properties al posto del file di configurazione predefinito.
• -d utilizza la modalità detached ovvero il container verrà eseguito in background.
• c01glucoseguardian/webbackend specifica l'immagine da utilizzare. Nel caso in cui non sia disponibile localmente, verrà scaricata da dockerhub.

Per altre informazioni si rimanda alla documentazione di Docker.

Installazione da sorgenti

1. Installare Git e la JDK 17 o superiore

2. Aprire un terminale e clonare questo progetto:

   git clone https://github.com/c01-glucoseguardian/webbackend
   

3. Spostarsi nella cartella webbackend:

   cd webbackend
   

4. Effettuare tutte le modifiche necessarie al file di configurazione in src/main/java/resources/application.properties (Opzionale)

5. Compilare il file .jar:

   ./mvnw clean package -DskipTests=true -Dmaven.javadoc.skip=true
   

6. Eseguire il file .jar:

   Warning
   Il server non si avvierà senza una connessione con il DBMS PostgreSQL. È quindi importante configurare correttamente tali parametri in application.properties

   java -jar target/*.jar
   

Team

Il progetto è stato realizzato dal Team C01

Team members

Andrea Mennillo

Marco Maria Marchese

Matteo Aldi

Vito Piegari

Domenico Cifelli

Project managers

Ludovico Lerose

Amine M. Serraj

Link utili

• Frontend web
• Mobile App
• Test di Sistema
• Documentazione
• Demo