App Mobile PWA Manutenzione

Manutentya come Progressive Web App mobile

Manutentya è una Progressive Web App (PWA) installabile su iPhone, Android e desktop senza passare dall'App Store o Google Play. Il tecnico installa l'app dal browser in 30 secondi e ottiene un'esperienza simile a un'app nativa: icona in home, fullscreen, notifiche push, scanner QR integrato, funzionamento offline.

Vantaggi della PWA rispetto a app native

• Niente App Store: nessuna review Apple/Google da attendere, niente account sviluppatore (€99/anno Apple, €25 Google).
• Una codebase per Android, iOS, desktop: niente sviluppo doppio.
• Aggiornamenti silenti: utenti sempre sull'ultima versione, senza popup "aggiorna l'app".
• Costi sviluppo ridotti e indipendenza dalle policy degli store.
• Funziona offline con cache intelligente del service worker.

Installazione su iPhone

1. Apri Safari e vai su https://tuoazienda.manutentya.it.
2. Tap sul pulsante Condividi (icona quadrata con freccia).
3. Scrolla giù e tap "Aggiungi a Home".
4. L'app appare con icona nella home come app nativa.
5. Apre fullscreen senza barra del browser.

Installazione su Android

Prompt automatico al secondo accesso: "Installa Manutentya". Tap → installazione in 5 secondi. Anche su Android l'esperienza è fullscreen come app nativa.

Safe-area iOS

I nuovi iPhone (iPhone X+) hanno notch e Dynamic Island che bloccano la zona superiore dello schermo. La PWA Manutentya rispetta automaticamente le safe-area iOS: i contenuti non finiscono sotto la barra di stato, i pulsanti sono accessibili senza gymnastiche del pollice.

Offline fallback

Se il tecnico è in cantiere senza connessione, la PWA mostra una pagina di fallback con:

• Lista degli ultimi ticket aperti consultabili (cached).
• Promemoria di sincronizzare al ritorno della connessione.
• Niente schermata bianca crash.

Quando torna la connessione, la PWA si sincronizza automaticamente.

Scanner QR integrato

Problema iOS: la fotocamera nativa di iOS apre i QR sempre nel browser Safari, non nella PWA installata. Manutentya risolve questo con uno scanner QR integrato dentro la PWA:

1. Apri Manutentya da home iPhone.
2. Tap "Scansiona QR" nello shortcut menu o pulsante in dashboard.
3. Si apre la fotocamera dentro l'app.
4. Scansione → la pagina del macchinario si apre nella PWA con sessione già autenticata.

UX continua e familiare. Su Android la fotocamera nativa apre direttamente nella PWA installata.

Shortcut PWA

Tieni premuta l'icona Manutentya in home → menu rapido con scorciatoie:

• Scansiona QR: apre direttamente lo scanner.
• I miei ticket: apre la lista ticket assegnati.
• Nuovo ticket: form di creazione veloce.

Riduce ulteriormente il tempo di accesso alle funzioni più usate.

Notifiche push

Combinato con il sistema di notifiche, la PWA installata riceve notifiche push native via OneSignal:

• Ticket assegnato.
• Ticket priorità alta aperto.
• Cambio stato richiesta acquisto.
• Allarme MES priorità alta.

Anche con app chiusa, il tecnico riceve la notifica come se fosse un'app nativa.

Tema chiaro e tema scuro

Due temi disponibili, selezionabili per utente dal profilo (preferenza salvata in DB):

Tema chiaro (default)

Stile gestionale pulito, sfondo bianco, pannelli grigio chiaro, accent blu. Adatto a uso in ufficio con illuminazione standard.

Tema scuro (Linear/Vercel-style)

Sfondo nero antracite, palette curata stile design system moderno (Linear, Vercel), accent indigo. Riduce affaticamento visivo per uso prolungato in ambienti poco illuminati (officine notturne, magazzini frigo).

Esperienza mobile-first

La UI è progettata per essere ottimale su mobile, non "responsive afterthought":

• Card list verticali per ticket invece di tabelle.
• Bottoni grandi adatti a guanti da lavoro.
• Swipe gestures per azioni rapide.
• Niente popup hover (incompatibili touch).
• Tipografia ottimizzata per ambienti rumorosi/luminosi.

Modulo incluso nel core di Manutentya, attivo per tutte le aziende. Si combina con il QR code macchinari per l'apertura ticket mobile in 30 secondi.