Ordina la tua merenda al bar della scuola con un click!
SmartBreak è un'innovativa applicazione web PWA (Progressive Web App) che rivoluziona gli ordini al bar della scuola, migliorando efficienza, comodità e sostenibilità per studenti, personale del bar ed istituzioni scolastiche.
Essa è stata progettata e sviluppata con il contributo degli studenti durante il corso PON "The AppFactory" tra dicembre 2020 e aprile 2021, nell'indirizzo "Informatica e Telecomunicazioni" presso l'IISS "C. Colamonico - N. Chiarulli" Acquaviva delle Fonti (BA)-Italy.
Esperto del progetto e sviluppatore: dr. Giovanni Ciriello
Tutor e sviluppatore: prof. Rino Andriano
La manutenzione e lo sviluppo ulteriore è attualmente affidato ad team di docenti e studenti sviluppatori della stessa scuola.
Realizzato un nuovo ramo di sviluppo demo su github e pubblicato all’indirizzo https://sbtest.colamonicochiarulli.it\ conterrà sempre la demo dell'ultima versione
- Acquista di nuovo - Possibilità di mettere nel carrello un precedente ordine (nello stesso intervallo di tempo in cui è possibile effettuarli), (805e0cc). Camilla Vaira - 5infA, Montenegro Claudio - 5infA, Rino Andriano
- Personalizzazione scuola (Amministratori) - Rino Andriano
Aggiunti nel file di configurazione .env i seguenti parametri che consentono ad altre scuole di configurare velocemente la home page di SmartBreak senza necessità di mettere mano al codice:- SCHOOL_NAME="Nome scuola"
- SCHOOL_ADDRESS="Via C. Colamonico, n. 5"
- SCHOOL_CITY="sede"
- SCHOOL_COUNTRY="Nazione"
- SCHOOL_URL="sito internet"
- SCHOOL_URL_PRIVACY="url link alla policy privacy"
- SCHOOL_URL_FACEBOOK="url pagina facebook"
- SCHOOL_URL_INSTAGRAM="url instagram"
- SCHOOL_URL_YOUTUBE="url canale youtube"
-
Home Page
- Aggiornato contenuti alle funzionalità della versione
- Recupera dal file di configurazione .env i dati della scuola e la fascia oraria per gli ordini e li integra nella Landing page
-
Layout - Fix su hamburger menu - Adesso è più facile cliccarlo su smartphone (e4d169b) Nicola Sergio - 5infA
-
Fai un'ordine - Nuovo pulsante sticky "Vai al riepilogo" (checkout-cart), durante lo scroll in fase di ordini (e4d169b) Nicola Sergio - 5infA, Rino Andriano
-
Importa-CSV (Amministratore) - Aggiunta la descrizione dei campi importabili e un file CSV di esempio per Classi e Studenti (86d1c0e) Costantino Tassielli - 5infA, Liuzzi Anthony
-
Config - Aggiunta alcuni parametri di configurazione in .ENV:
- MAX_UNITS_ORDABLE = num (numero max di pezzi ordinabili di un singolo prodotto per ogni ordine) -(77c2b23) Rino Andriano
-
Documentazione - Rino Andriano
- Aggiunti commenti nel file di configurazione .env.example
- Aggiunto un file INSTALL.md
- Aggiornato il file README.md e CHANGELOG.md
- Aggiunta una scheda descrittiva di SmartBreak in PDF
- Aggiunto un Tutorial in PDF, sulla preparazione delle immagini dei prodotti
-
Cancellazione ordini - Possibilità di cancellare gli ordini del giorno (nello stesso intervallo di tempo in cui è possibile effettuarli), (805e0cc). Giuseppe Giorgio - 5infA
-
Totale pezzi ordinati per classe - Aggiunto nella pagina Ordini per classe del bar manager, il totale dei pezzi ordinati (ddf3fc8). Costantino Tassielli - 5infA, Liuzzi Anthony
-
Listino prodotti Fuori dall'intervallo orario utile a fare gli ordini, viene comunque visualizzato il listino dei prodotti disponibili (c2a9dbc) - Gabriele Losurdo - 5InfA
-
Messaggi - Possibilità per l'amministratore di inviare messaggi agli utenti. CRUD dei Messaggi - Visualizzazione al login dell'ultimo messaggio non letto per il ruolo dell'utente (studente, manager, administrator) (7bd53dc) - Fabio Caccavone 5infA
-
Corretto il link sul logo per gli ospiti (non autenticati), ora vengono reindirizzati alla landing page (7167340) - Nicola Sergio - 5infA
-
Nella navbar adesso viene sempre visualizzato il numero degli articoli inseriti nel carrello ed il totale spesa, anche se si cambia funzionalità (Es. Statistiche)(5b780cb).Giuseppe Giorgio - 5infA
-
Fuori dall'intervallo degli ordini, non viene più visualizzato il carrello nella navbar(9daf168).Giuseppe Giorgio - 5infA
-
Layout - Rimossa la sidebar dalla pagina di login (e4d169b).
-
Avviso tempo utile per ordinare - Nella visualizzazione del Listino adesso visualizza anche lìintervallo di tempo nel quale è possibile effettuare ordini (c2a9dbc) - Gabriele Losurdo - 5InfA
-
Aggiunti tooltip sulle icone (vedi, Modifica, cancella) in tutte le pagine index dei vari CRUD di tutte le tabelle (31227ab) - Antony Liuzzi - 5infA
-
Documentazione - Aggiunti i file README.md and CHANGELOG.md - Nicola Sergio - 5infA
- Prevenzione del click compulsivo sul pulsante [Conferma Ordine] per evitare la creazione multipla dello stesso ordine(12e6b01).Rino Andriano
Funzionalità disponibili nella prima versione stabile
- Ogni studente, dopo l’autenticazione con account Google istituzionale, API Google (OAuth 2.0)., può ordinare da qualsiasi dispositivo mobile i prodotti che intende acquistare al Bar della scuola, tra quelli proposti e disponibili, consultando un’apposita lista fotografica di prodotti.
- L’applicazione compila automaticamente le liste delle ordinazioni giornaliere per classe, rendendo più semplice il processo di preparazione dell’ordine e la consegna dei prodotti.
- Fornisce statistiche agli studenti sui propri acquisti e al Bar sulle vendite
L'applicazione prevede la gestione di più sedi scolastiche, ciascuna con il proprio servizio BAR, ed è stata progettata e realizzata sulla base di 3 tipologie di utenti:
- Amministratore: il tecnico ICT della scuola, che amministra tutti gli aspetti relativi all'applicazione.
- Bar Manager: il responsabile del bar di una sede, che si occupa della preparazione fisica degli ordini.
- Studente: ogni singolo studente della scuola, che accede all'app con il proprio account istituzionale (Google for Education).
Nello specifico :
-
Amministratore:
- Gestione sedi scolastiche: può aggiungere, modificare ed eliminare le sedi scolastiche.
- Gestione utenti: può aggiungere, modificare e eliminare gli utenti Administrator e Bar Manager.
- Gestioni classi: può aggiungere, modificare e eliminare le classi. Il loro inserimento può essere eseguito anche mediante file CSV.
- Gestione studenti: può aggiungere, modificare e eliminare gli studenti. Il loro inserimento può essere eseguito anche mediante file CSV.
- Gestione categorie: può aggiungere, modificare e eliminare categorie dal catalogo dei prodotti.
- Gestione prodotti: può aggiungere, modificare ed eliminare prodotti dal catalogo.
- Statistiche: può visualizzare le statistiche sull'utilizzo dell'applicazione nelle varie sedi della scuola, filtrando i risultati per unità temporale (settimana, mese, anno).
-
Bar Manager:
- Gestione categorie: può aggiungere, modificare e eliminare categorie dal catalogo.
- Gestione prodotti: può aggiungere, modificare ed eliminare prodotti dal catalogo.
- Gestione giacenze: può aggiornare velocemente le quantità disponibili dei prodotti presenti nel listino.
- Ordini per prodotto: può visualizzare in un'unica tabella tutti gli ordini del giorno raggruppati per prodotto.
- Ordini per classe: può visualizzare gli ordini del giorno raggruppati per classe, impostando lo stato (complete o incomplete). Il Bar Manager non è in grado di visualizzare il dettaglio dei singoli utenti.
- Gestione delle disponibilità giornaliere: se lo desidera, può impostare per i prodotti una quantità disponibile giornalmente. Tramite un servizio di CRON, la giacenza viene impostata ogni giorno automaticamente alla disponibilità giornaliera (se è > di 0)
- Statistiche: può visualizzare le statistiche delle vendite dei prodotti e degli incassi del bar, filtrando i risultati per unità temporale (settimana, mese, anno).
-
Studente:
-
Fai un ordine: ogni singolo studente può effettuare ordinazioni al bar, scegliendo tra i prodotti disponibili e inserendo la quantità desiderata. Se si effettuano più ordni in un giorno verranno raggruppati automaticamente. Gli ordini possono essere effettuati solo in un intervallo orario (Es. 07:30-09:30)
-
I miei ordini: può visualizzare le proprie ordinazioni effettuate nel tempo, giorno per giorno.
-
Ordni della mia classe ogni studente può visualizzare la lista degli ordini della propria classe, alunno per alunno, con il dettaglio dei prodotti e del corrispettivo da pagare. Ciò è utile per il ritiro dei prodotti e la loro distribuzione nell'aula
-
Statistiche: può tenere sotto controllo le proprie spese, visualizzando le statistiche delle spese totalii e per categoria, filtrando i risultati per unità temporale (settimana, mese, anno).
-