Ingegneria del Software - Progetto 2023/24

Questo progetto è stato sviluppato come parte del corso di Ingegneria del Software (Anno Accademico 2023/24) ed è volto a supportare lo scambio di prestazioni d’opera senza utilizzo di denaro.
L'applicazione permette a organizzazioni di gestire categorie di attività scambiabili e supporta un processo incrementale, a partire dalla prima versione che include funzionalità di configurazione.

🔗📚 Link al manuale utente

🎯 Funzionalità chiave

• Versione 1.0.0
  • Gestione delle gerarchie di categorie.
  • Configurazione di fattori di conversione tra categorie foglia.
  • Gestione persistente dei dati.
  • Interfaccia CLI per configuratori.
• Versione 2.0.0
  • Interfaccia CLI per fruitori.
• Versione 3.0.0
  • Possibilità di inserire nuove proposte di scambio per i fruitori.
• Versione 4.0.0
  • Sistema di chiusura automatico delle proposte di scambio.
  • Sistema di notifica delle proposte di scambio chiuse ai configuratori.
  • Visualizzazione avanzate delle proposte.
  • Possibilità di ritirare le proposte di scambio.
  • Storico delle modifiche delle proposte di scambio.

🚀 Installazione

• Scaricare il file ingswproject-setup.exe dalla sezione Releases.
• Eseguire il file di setup e seguire le istruzioni a schermo.
• Prima di lanciare il programma, assicurarsi di avere configurato la connessione al database. Per fare questo, fare riferimento alla prossima sezione.

🔧 Configurazione della connessione al database

Il programma include uno tool per la configurazione automatica del database. Lo strumento viene lanciato automaticamente all'avvio del programma, se non è stata ancora configurata una connessione al database. In alternativa, è possibile lanciare lo strumento manualmente eseguendo il comando ingswproject.exe --dbtool.

In ogni caso, nel file di configurazione application.yaml disponibile nella cartella %APPDATA%/ingsw_project (Windows) o $HOME/.ingsw_project (Mac/Linux) è possibile specificare i datasource da utilizzare, seguendo la sintassi supportata da Ebean ORM.
Il programma utilizzerà il database di default indicato nel file, se non specificato diversamente utilizzando l'opzione -db (vedi Parametri opzionali).

📖 Utilizzo

📚 Parametri opzionali

Il programma accetta i seguenti parametri in input opzionali:

• -h o --help: Mostra l'elenco dei parametri supportati.
• -p o --platform: Specifica il frontend da utilizzare. Valori supportati: cli (default).
• -db o --database: Specifica il database da utilizzare (nome specificato in application.yaml).
• -u o --username: Se specificato, insieme al parametro -pw, permette di autenticarsi automaticamente al software in fase di avvio.
• -pw o --password: Password per l'autenticazione automatica.
• -l o --language: Specifica la lingua da utilizzare per l'interfaccia utente (codici ISO 639). Se non specificato oppure se la lingua non è supportata, verrà utilizzata la lingua di sistema.
• -v o --verbose: Abilita la modalità di logging avanzata degli errori.
• -dbt o --dbtool: Avvia lo strumento di configurazione del database.

Esempio di esecuzione tramite riga di comando:

ingswproject.exe -p cli -db my_database -u admin -pw admin -l en -v

💡 Requisiti

• Java 21 o superiore.

Per lo sviluppo:

• Ebean ORM per la gestione del database.
• Maven per la gestione del progetto.

🔍 FAQ

Qui troverai le risposte alle domande più frequenti. Per ulteriori domande, ti invitiamo ad aprire una nuova issue, specificando il problema riscontrato.

Mi è apparso l'errore This application requires a Java Runtime Environment.

Questo errore si verifica quando non è presente una versione di Java installata sul sistema.
Di default, l'installer dell'applicazione installa una versione di Java, quindi per prima cosa assicurati di aver installato il programma tramite l'installer ufficiale.
Se il problema persiste, segui queste istruzioni:

1. Apri la cartella di installazione dell'applicazione.
2. Verifica che sia presente la cartella jre all'interno della cartella di installazione.
3. Se la cartella jre non è presente, reinstalla l'applicazione.
4. Altrimenti, copia il percorso della cartella jre e segui le istruzioni presenti in questo articolo per impostare il percorso di Java.

Ho installato Java ma il programma non si avvia.

Potrebbe capitare che il programma non riesca a trovare la versione di Java installata sul sistema.
Per risolvere il problema, è necessario specificare manualmente il percorso di Java.
Per fare questo cerca la cartella di installazione di Java (di solito si trova in C:\Program Files\Java\ su Windows o /usr/lib/jvm/ su Linux) e copia il percorso.
Poi ti consigliamo di seguire le istruzioni presenti in questo articolo per impostare il percorso di Java.

Ogni volta che avvio il programma mi chiede di configurare il database.

Il programma richiede la configurazione del database quando non rileva una connessione già configurata.
Per risolvere il problema, assicurati di aver configurato correttamente il file application.yaml e di aver specificato il datasource da utilizzare.
Lo strumento di configurazione del database ti dirà il file dove è possibile modificare le impostazioni.

👤 Autori

• Pierpaolo Bonalda - p.bonalda@studenti.unibs.it - GitHub
• Shpetim Daiu - s.daiu@studenti.unibs.it - GitHub
• Nicolo' Rebaioli - n.rebaioli@studenti.unibs.it - GitHub

📄 Licenza

Questo progetto è concesso in licenza sotto la licenza GNU General Public License v3.0 - vedi il file LICENSE per i dettagli.

---

© 2025 Progetto realizzato per il corso di Ingegneria del Software, corso di laurea in Ing. Informatica, Università degli Studi di Brescia.