Applicazione mobile Flutter per la prenotazione di postazioni PC, con generazione di un QR Code associato a ciascuna prenotazione tramite chiamata a un backend REST.
Il progetto è uno scaffold Flutter avviato a partire dal template standard (flutter create) e successivamente esteso con una funzionalità di generazione QR Code. L'utente, tramite un pulsante, invia una richiesta al backend con l'ID di una prenotazione; il server restituisce i dati del codice QR corrispondente, che l'app è predisposta a mostrare a schermo (la visualizzazione vera e propria è al momento disattivata nel codice).
flutter_application_1/
├── lib/
│ ├── main.dart # Entry point generato dal template Flutter (counter demo)
│ └── MyApp.dart # Logica della PC Booking App (generazione QR Code)
├── pubspec.yaml # Dipendenze e configurazione del progetto
├── android/, ios/, web/, windows/, macos/, linux/ # Codice nativo per ciascuna piattaforma
└── test/
└── widget_test.dart # Test di base generato dal template
Il progetto contiene due file con logica di avvio in conflitto:
main.dartdefiniscevoid main()e una classeMyAppcon il classico contatore demo generato daflutter create.MyApp.dartdefinisce anch'essovoid main()e anch'esso una classeMyApp, ma con la vera logica applicativa (la "PC Booking App").
Poiché sono due file separati con la stessa classe MyApp e la stessa funzione main(), il progetto non compila così com'è finché entrambi i file sono importati insieme nello stesso build, e ad oggi è main.dart (il file standard generato dal template) a essere effettivamente eseguito, non la logica di prenotazione. Prima di proseguire lo sviluppo è necessario:
- Scegliere un solo file come entry point (tipicamente
main.dart). - Spostare la logica di
MyApp.dartdentromain.dart, oppure rinominare la classe inMyApp.dart(es.BookingApp) ed effettuare l'import esplicito damain.dart, richiamandola inrunApp().
- Flutter SDK (Dart >= 3.3.1, come da
pubspec.yaml) - Un IDE con supporto Flutter (Android Studio, VS Code con estensione Flutter, ecc.)
- Un backend raggiungibile su
http://localhost:3000/api/generateQRche risponda con un JSON contenente il campoqrCode, per testare la generazione del codice
| Pacchetto | Utilizzo |
|---|---|
http |
Esecuzione della richiesta POST verso il backend di generazione QR |
qr_flutter |
Rendering del QR Code a schermo (import presente, utilizzo attualmente commentato) |
fluttertoast |
Notifiche toast in caso di errore nella chiamata al backend |
cupertino_icons |
Icone in stile iOS |
flutter_lints |
Regole di lint raccomandate (dev dependency) |
- Assicurati di avere Flutter installato (
flutter --versionper verificare). - Clona il repository e posizionati nella cartella
flutter_application_1. - Installa le dipendenze:
flutter pub get
- Risolvi il conflitto tra
main.darteMyApp.dartdescritto sopra prima di lanciare l'app. - Avvia un backend locale sulla porta 3000 che esponga l'endpoint
POST /api/generateQR(accetta{"bookingId": "..."}e risponde con{"qrCode": "..."}), oppure aggiorna l'URL nel codice se il backend è ospitato altrove. - Avvia l'app:
flutter run
- L'utente apre l'app e vede un pulsante "Generate QR Code".
- Alla pressione, l'app invia una richiesta
POSTal backend con unbookingId(attualmente hardcoded come'your_booking_id'— da collegare a una vera selezione/prenotazione). - Se la richiesta ha successo (status 200), i dati del QR Code vengono salvati nello stato dell'app.
- Se la richiesta fallisce, viene mostrato un toast di errore ("Failed to generate QR Code") tramite
fluttertoast. - Durante la chiamata di rete viene mostrato un indicatore di caricamento (
CircularProgressIndicator).
- Flutter / Dart
- HTTP client (
httppackage) per la comunicazione con il backend - qr_flutter per la generazione/visualizzazione di QR Code
- fluttertoast per le notifiche non bloccanti
- Conflitto tra
main.darteMyApp.dart(vedi sezione dedicata sopra): il progetto non è nello stato in cui la logica di prenotazione viene effettivamente eseguita. - La visualizzazione del QR Code generato è commentata nel codice (
QrImage(data: qrCode)): la UI non mostra ancora il risultato della chiamata. - L'ID prenotazione (
bookingId) è hardcoded, non collegato a un flusso reale di selezione/prenotazione. - L'URL del backend (
http://localhost:3000) è cablato nel codice: andrebbe estratto in una configurazione (es. file.envo costante separata) per poter puntare facilmente ad ambienti diversi (sviluppo, staging, produzione). - Manca la gestione di eventuali timeout di rete o errori di parsing della risposta JSON.
- Il backend che espone
/api/generateQRnon fa parte di questo repository: è un progetto separato necessario per il funzionamento end-to-end dell'app.
Progetto realizzato a scopo di esercitazione personale.