Descrizione

JFXPRJCT è una applicazione desktop sviluppata in JAVAFX dal gruppo SPT per il progetto del corso di Programmazione Internet. L'obiettivo finale è creare un'applicazione multiutente per l'apprendimento e l'allenamento delle conoscenze del linguaggio Java.

Funzionamento

Utilizzo

Struttura progetto

Il progetto è strutturato in due macropacchetti, resources contenente tutte le risorse (immagini, file, scene) e java contenente i file java da compilare.

I file java sono divisi a loro volta per momento di esecuzione all'interno dell'applicazione, ossia access, dashboard, exercise e general per quelli che gestiscono operazioni generali richiamate in più momenti dell'esecuzione. Per ogni cartella è presente un controller, che connette backend e frontend, e un interrogatore db che si occupa delle interrogazioni al database necessarie.

Struttura database

È un database relazionale SQlite locale serverless con tre tabelle:

• Users contenente nei record gli utenti che si registrano, con chiave primaria idUser
• Exercises contenente nei record gli esercizi, con chiave primaria idExercise
• DoneExercises che riflette l'associazione M:N Utente ha svolto Esercizio, in ogni record è presente idUser e idExercise

Librerie esterne

Per l'esecuzione dell'applicazione è richiesta l'installazione di tre librerie esterne:

• javafx per le componenti grafiche
• slf4j-api e slf4j-nop per il sistema di logging
• sqlite-jdbc per la connessione al database

Regole di sviluppo

• nomi variabili esclusivamente in inglese seguendo regola camelCase
• commenti codice, commit e readme in italiano
• gli issue, quando aperti, vanno contrassegnati con le etichette appropriate, una che distingua fra bug, feature e enhancement e una seconda che specifichi quale aspetto è coinvolto (ux, ui, database, codice).

Crediti

All'interno del progetto ci siamo serviti della palette NordTheme e dell'immagine di Pawel Czerwinski