{
    "componentChunkName": "component---src-templates-case-study-jsx",
    "path": "/codevmy/case-studies/mycorolla-la-loyalty-diventa-un-gioco-con-flutter-e-firebase",
    "result": {"pageContext":{"caseStudy":{"images":[],"cover":{"childImageSharp":{"fluid":{"src":"/static/d5cf6b5045bb8762a7706f90f6aa42ab/87438/a09404063b1bfb91dc38dfa3000a205b.png","srcSet":"/static/d5cf6b5045bb8762a7706f90f6aa42ab/0e8e4/a09404063b1bfb91dc38dfa3000a205b.png 200w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/f6195/a09404063b1bfb91dc38dfa3000a205b.png 400w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/87438/a09404063b1bfb91dc38dfa3000a205b.png 800w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/e6812/a09404063b1bfb91dc38dfa3000a205b.png 1200w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/6650f/a09404063b1bfb91dc38dfa3000a205b.png 1600w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/e2890/a09404063b1bfb91dc38dfa3000a205b.png 2149w","srcSetWebp":"/static/d5cf6b5045bb8762a7706f90f6aa42ab/e4239/a09404063b1bfb91dc38dfa3000a205b.webp 200w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/01f4a/a09404063b1bfb91dc38dfa3000a205b.webp 400w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/0c3ce/a09404063b1bfb91dc38dfa3000a205b.webp 800w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/0790f/a09404063b1bfb91dc38dfa3000a205b.webp 1200w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/a44d4/a09404063b1bfb91dc38dfa3000a205b.webp 1600w,\n/static/d5cf6b5045bb8762a7706f90f6aa42ab/f960a/a09404063b1bfb91dc38dfa3000a205b.webp 2149w","srcWebp":"/static/d5cf6b5045bb8762a7706f90f6aa42ab/0c3ce/a09404063b1bfb91dc38dfa3000a205b.webp"}}},"id":"Project_6af1ae7173fdce0015f8c41e","preview_image":{"childImageSharp":{"fluid":{"src":"/static/bc4f4a8a5264b9b8e17f27019464c2dc/e2764/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg","srcSet":"/static/bc4f4a8a5264b9b8e17f27019464c2dc/728b9/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg 200w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/aee8e/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg 400w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/e2764/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg 800w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/66b8e/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg 1200w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/23a1d/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg 1600w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/5d698/7d4a83e14598cc1ebaaabedbdaf5efe9.jpg 2800w","srcSetWebp":"/static/bc4f4a8a5264b9b8e17f27019464c2dc/e4239/7d4a83e14598cc1ebaaabedbdaf5efe9.webp 200w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/01f4a/7d4a83e14598cc1ebaaabedbdaf5efe9.webp 400w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/0c3ce/7d4a83e14598cc1ebaaabedbdaf5efe9.webp 800w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/0790f/7d4a83e14598cc1ebaaabedbdaf5efe9.webp 1200w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/a44d4/7d4a83e14598cc1ebaaabedbdaf5efe9.webp 1600w,\n/static/bc4f4a8a5264b9b8e17f27019464c2dc/bb840/7d4a83e14598cc1ebaaabedbdaf5efe9.webp 2800w","srcWebp":"/static/bc4f4a8a5264b9b8e17f27019464c2dc/0c3ce/7d4a83e14598cc1ebaaabedbdaf5efe9.webp"}}},"section":[{"title":null,"solution":[{"text":"Con decine di negozi, ristoranti e un vivace calendario di eventi, il [Parco Corolla](https://www.parcocorolla.it/) è uno dei centri commerciali più attivi della Sicilia. \n\nPer coinvolgere e premiare la propria community, il centro ha puntato fin da subito sulla gamification con **MyCorolla**, un'app che trasforma lo shopping in un gioco interattivo. Gli utenti esplorano la mappa 3D del parco con il proprio avatar, raccolgono monete e corolle, completano missioni giornaliere e convertono i punti accumulati in premi reali da ritirare nei negozi tramite QR code.  \n\nLa prima versione dell'applicazione, però, era stata sviluppata interamente in Unity: una scelta perfetta per la componente ludica, ma poco sostenibile per tutto il resto (dalle schermate 2D all'autenticazione, fino a notifiche push e manutenibilità). **Serviva quindi ripensare l'intera struttura** ed è esattamente quello che abbiamo fatto. Abbiamo messo **Flutter** al comando a guidare l'applicazione, lasciando a Unity un unico compito ben preciso, far girare la scena 3D.\n","title":null}]},{"title":"La sfida: due mondi da far coesistere ","solution":[{"text":"Mettere mano a un'app già usata ogni giorno da centinaia di persone non significa semplicemente riscrivere del codice per renderlo più pulito, funzionale e scalabile. C'erano account attivi, monete accumulate e un equilibrio delicato tra gioco e infrastruttura reale da non rompere. \nPer farlo bene, abbiamo dovuto far quadrare quattro vincoli ben precisi:\n\n- **Rifare senza spegnere**: sostituire app, backend e backoffice di un sistema in produzione, preservando account, progressi e valute virtuali degli utenti esistenti, senza possibilità di rollback, perché il runtime del backend legacy (Node 14) era ormai dismesso.\n- **Due mondi in una sola app**: far convivere Flutter e Unity nello stesso processo, con cicli di vita, memoria e canali di comunicazione da orchestrare al millimetro e un problema di performance che ha richiesto di scendere fino alle API di sistema (ne parliamo più avanti).\n- **Un'economia a prova di furbi**: monete, premi e missioni hanno valore reale nei negozi del parco; l'integrità dell'economia di gioco doveva essere garantita a livello architetturale, non affidata al client.\n- **Conformità europea**: residenza dei dati in EU, consenso al tracciamento conforme GDPR, cancellazione account completa.\n\n&nbsp;\n\n![CorollaAPP - immagini articolo03.jpg](https://assets.acadevmy.it/Corolla_APP_immagini_articolo03_ba7346a241.jpg)\n\n&nbsp;","title":null}]},{"title":"La soluzione: Flutter al comando, Unity al suo posto ","solution":[{"text":"La nuova app è costruita in **Flutter con architettura feature-first e state management Riverpod**: autenticazione (email, Google, Apple, Facebook), navigazione, shop, profilo, notifiche e tutte le interfacce 2D vivono nel mondo Flutter, tipizzato e testabile. La scena 3D (mappa del parco, avatar, raccolta oggetti)  è affidata a una singola istanza Unity embedded, montata una volta sola e messa in pausa quando non visibile, per non consumare batteria e memoria.\n\n","title":"Flutter master, Unity engine"},{"text":"Poco dopo l'integrazione del motore 3D è emerso un problema serio, e per certi versi controintuitivo. Dopo la prima visita alla mappa, tutte le schermate Flutter (news, missioni, shop, profilo) diventavano scattose nello scroll. E il fenomeno era più marcato sugli iPhone recenti che su quelli datati. In più, rientrando in mappa, un frame congelato restava visibile per circa un secondo.\n\nLa diagnosi ha richiesto di scendere fino al sistema operativo. Su iOS la view di Unity viene inserita nella gerarchia nativa, e Flutter deve ricomporre i propri layer attorno ad essa a ogni frame del display. Sui display ProMotion a 120 Hz questo lavoro di composizione raddoppia rispetto ai 60 Hz: è per questo che i telefoni più recenti soffrivano di più.\n\nLa causa principale, però, era un'altra. Il \"cuore\" di Unity su iOS è un timer di sistema agganciato al main thread. Continua a battere, e quindi a far renderizzare e presentare frame, anche quando la scena 3D non è visibile, sottraendo tempo di CPU e GPU proprio alle schermate Flutter.\n\nAbbiamo verificato direttamente sul codice sorgente dell'export Unity che le soluzioni standard erano tutte insufficienti. Abbassare il frame rate a 1–5 fps attenuava il problema senza risolverlo, perché ogni tick produce comunque un frame completo. La pause() del plugin su iOS 17+ non ferma davvero il rendering, perché il display link Metal obbliga il motore a presentare un frame a ogni battito. Smontare la view non serviva: il timer non è legato alla view, e il plugin la riattivava automaticamente.\n\nLa **soluzione** a cui siamo arrivati, battezzata \"deep sleep\", agisce alla radice: **invece di rallentare Unity, ne ferma l'orologio**. Un modulo nativo Swift, scritto senza toccare il codice del plugin, mette in pausa i display link del motore quando l'utente lascia la mappa. Il rendering si azzera completamente e l'ultimo frame resta visibile come immagine statica, a costo quasi nullo. Al rientro in mappa, il risveglio forza il primo battito entro circa 33 millisecondi.\n\nSul lato Flutter, l'orchestrazione gestisce i casi limite: sequenze con ordini critici, timer cancellabili, la riasserzione dello sleep dopo gli auto-resume del plugin, un comportamento dedicato per lo scroll sopra l'avatar. È stato previsto anche un flag di rollback, per tornare al comportamento precedente in caso di regressioni.\n\n0 fps rendering Unity fuori dalla mappa: orologio fermo, non solo rallentato ~33 ms rientro in mappa a scena viva, contro ~1 secondo prima del fix 120 Hz display ProMotion: il carico di composizione raddoppiato che ha originato il problema.\nLo scroll delle schermate Flutter è tornato ai livelli di un'app senza motore 3D, con meno consumo di batteria e pressione termica. L'intero percorso (problema, diagnosi, tentativi falliti e soluzione) è stato documentato nel dettaglio ed è entrato a far parte del patrimonio tecnico del team.\n","title":"La sfida nella sfida: quando i telefoni più potenti vanno peggio"},{"text":"Il principio architetturale centrale è la **Server-Authoritative Economy**: il client non può scrivere il proprio portafoglio. Ogni acquisto, premio o apertura di forziere passa da una Cloud Function che valida la richiesta, verifica i fondi ed esegue una transazione atomica. L'app osserva i cambiamenti in tempo reale e aggiorna di conseguenza l'interfaccia. A rafforzare il perimetro: Firebase App Check con attestazione del dispositivo, security rules anti-tampering e offuscamento del codice nelle build di produzione.\n\n- **Dual database**: Firestore per i dati strutturati (profili, acquisti, missioni, catalogo), Realtime Database per il wallet — valute e power-up scrivibili solo dalle Cloud Functions.\n- **Offline-first**: raccolte e azioni accodate localmente con UI ottimistica e sincronizzazione in batch, così l'app resta fluida anche con connettività instabile.\n- **Missioni \"dumb client\"**: le quest giornaliere e speciali sono generate e verificate dal backend; il client si limita a mostrarle e a tracciarne il progresso.\n\n\n&nbsp;\n\n![CorollaAPP - immagini articolo04.jpg](https://assets.acadevmy.it/Corolla_APP_immagini_articolo04_a938136684.jpg)\n","title":"Un'economia governata dal server"},{"text":"Il backend legacy contava 8 funzioni Node 14 di prima generazione. Lo abbiamo riscritto in **TypeScript strict su Node 22**: 30 Cloud Functions tra callable, trigger Firestore e Auth e job schedulati, con validazione degli input tramite Zod e suite di test Vitest, incluse le collisioni di naming tra generazioni gestite in fase di cutover. Tre job schedulati alimentano il re-engagement: promemoria scadenza premi, daily gift e riaggancio settimanale degli utenti inattivi.","title":"30 Cloud Functions"},{"text":"Il ponte tra gioco e mondo fisico è il **flusso di riscatto QR**. L'utente converte le valute in un premio e l'app genera un QR code. L'operatore lo scansiona dal backoffice, il backend valida e marca il riscatto, e l'app conferma all'istante restando in ascolto in tempo reale. Nessun passaggio manuale, nessuna possibilità di doppio utilizzo.\n\n&nbsp;\n\n![CorollaAPP - immagini articolo02.jpg](https://assets.acadevmy.it/Corolla_APP_immagini_articolo02_afd7d48162.jpg)\n\n\n&nbsp;","title":"Dal digitale al negozio: il riscatto via QR"},{"text":"Oltre alle notifiche push FCM e ai promemoria schedulati, l'app implementa un **geofencing nativo** (CoreLocation su iOS, Geofencing API su Android) che dà il benvenuto agli utenti all'arrivo al parco, anche ad app chiusa. Una feature piccola per l'utente, non banale per chi la sviluppa: richiede moduli nativi Swift e Kotlin che dialogano con Flutter.","title":"Notifiche intelligenti e geofencing"},{"text":"Il **go-live è stato un'operazione chirurgica documentata da runbook**. Le funzioni legacy sono state sostituite completamente, senza possibilità di rollback: la strategia adottata è stata fix-forward. La migrazione degli account ha preservato UID e hash delle password, quindi nessun utente ha dovuto ricreare l'account o reimpostare la password, e sono stati trasferiti anche progressi e valute virtuali. In una fase successiva l'intero progetto Firebase è stato migrato su region europea per garantire la residenza EU dei dati, con script dedicati per clonare Auth, Firestore, Realtime Database e Storage e gestione dei casi limite, come i token push non trasferibili tra progetti.\n\nSul fronte privacy, un banner di consenso iubenda con blocco preventivo dei tracker, e cancellazione account che rimuove in modo coordinato ogni dato dell'utente su tutti i database.\n","title":"Migrazione senza rete di sicurezza"}]},{"title":"Architettura e tecnologie","solution":[{"text":"- **App mobile**: Flutter con Riverpod, go_router e modelli immutabili (freezed); architettura feature-first con error handling a contratto; Unity embedded per la scena 3D; localizzazione it/en.\n- **Backend**: Firebase Cloud Functions (Node 22, TypeScript strict), Firestore + Realtime Database, Firebase Auth, Storage, App Check; validazione Zod, test Vitest, emulatori per lo sviluppo locale.\n- **Backoffice**: Next.js con React-Admin e Material-UI, Google SSO, Sentry + OpenTelemetry, test Vitest e Playwright, deploy su Vercel.\n- **Contenuti**: Directus come CMS headless condiviso con il portale web.\n- Delivery: CI/CD su GitLab e GitHub Actions, conventional commit, flavor dev/staging/produzione con progetti Firebase dedicati, secrets gestiti con dotenv-vault.-\n\n&nbsp;\n\n![CorollaAPP - immagini articolo01.jpg](https://assets.acadevmy.it/Corolla_APP_immagini_articolo01_d731eedd3c.jpg)\n\n&nbsp;","title":null}]},{"title":"Metodologia: spec-driven e AI-augmented","solution":[{"text":"Il progetto è governato da una \"costituzione\" tecnica versionata nel repository: standard di architettura, testing e collaborazione validi per tutti i sottoprogetti. Lo sviluppo segue un **approccio spec-driven** (ogni feature nasce da una specifica formale prima del codice) con TDD sul backend e BDD su app e frontend, e soglie di coverage esplicite per ogni layer.\n\nGli agenti AI sono parte del team: file di contesto machine-readable in ogni progetto li guidano su architettura e convenzioni, e ogni pull request dell'app mobile riceve una **code review automatica** da un agente AI, che affianca quella dei colleghi. Il risultato è un ciclo di sviluppo più rapido, con una qualità architetturale sorprendentemente uniforme su quattro codebase diverse.\n","title":null}]},{"title":"Risultati e impatto: cosa cambia per chi gioca e per chi gestisce il parco","solution":[{"text":"- **Ecosistema completo**: app, backend, backoffice e CMS progettati come un unico sistema coerente, al posto di componenti legacy stratificati.\n- **Migrazione trasparente**: account, progressi e valute preservati; nessuna azione richiesta agli utenti esistenti.\n- **Economia sicura**: valore reale dei premi protetto da un'architettura server-authoritative, non da controlli lato client.\n- **Operatività per il parco**: il personale gestisce premi, missioni e riscatti in autonomia dal backoffice.\n","title":null}]}],"slug":"mycorolla-la-loyalty-diventa-un-gioco-con-flutter-e-firebase","description":"La nuova app gamificata del Parco Corolla: **app mobile Flutter con mondo 3D integrato**, backend serverless e backoffice per la gestione operativa.\n","details":[{"value":"2026","name":"Anno:"},{"value":"Il Parco Corolla","name":"Committente:"},{"value":"Mobile App + Backend + Backoffice","name":"Prodotto:"},{"value":"Retail / Loyalty / Gamification","name":"Ambito: "},{"value":"Flutter, Dart, Unity, Firebase, Node.js, TypeScript, Next.js, React-Admin","name":"Tecnologie: "},{"value":"Sviluppo","name":"Tipologia:"}],"name":"MyCorolla: la loyalty diventa un gioco, con Flutter e Firebase","keywords":"Per il Parco Corolla abbiamo **reingegnerizzato l'intero ecosistema mobile**. La storica app in Unity è stata sostituita da un'app Flutter, che integra il cuore ludico 3D (mappa del parco e avatar) come motore embedded. Il tutto è sostenuto da un backend serverless su Firebase, con l'economia di gioco governata lato server, e da un backoffice per gestire premi, missioni e riscatti in negozio.\n","mobile":false,"category":"App","download":[]}}},
    "staticQueryHashes": ["63159454"]}