Manuale di utilizzo e guida ai test.

01 · Installazione

Installare la PWA sul telefono

Il link da condividere con i tester è https://quietrules.app. Non occorre un account QuietRules.

02 · PWA

Cosa si può provare adesso

La PWA è utile per verificare l’esperienza pubblica prima della distribuzione negli store.

• Lingua automatica: italiano, inglese, cinese semplificato e hindi in base alle preferenze del dispositivo.
• Installazione: icona QuietRules e apertura in modalità app.
• Navigazione: Home, Regole, Privacy e Stato dalla barra inferiore sui telefoni.
• Responsive design: testi, pulsanti e schede leggibili in verticale e orizzontale.
• Uso offline: dopo una prima apertura online, le pagine principali devono riaprirsi anche senza rete.
• Aggiornamenti: quando è pronta una nuova versione compare una notifica discreta con il comando Aggiorna.

La PWA non crea ancora regole operative, non modifica la modalità Focus e non intercetta le notifiche del telefono.

03 · App nativa

Usare la build iOS

Questa sezione riguarda la build installata da Xcode su un iPhone autorizzato. Con un profilo Apple personale l’installazione è temporanea e può richiedere un nuovo avvio da Xcode dopo circa sette giorni.

Schermate principali

• Home: riepilogo dello stato e accesso rapido alle funzioni principali.
• Regole: elenco, creazione, modifica, prova, importazione ed esportazione delle regole.
• Profili: scelta del contesto attivo, per esempio Lavoro, Concentrazione profonda o Personale.
• Riepilogo: raccoglie le interruzioni rimandate quando la piattaforma lo consente.
• Cronologia: mostra cosa è stato valutato o eseguito e perché.

Creare una regola

1. Apri Regole e scegli il comando per aggiungerne una.
2. Assegna un nome comprensibile.
3. In QUANDO, scegli l’evento che avvia la valutazione.
4. In SE, aggiungi le condizioni che devono essere vere.
5. In ALLORA, scegli l’azione desiderata.
6. Controlla lo stato della piattaforma, salva e usa Prova regola prima di affidarti al risultato.

QuietRules mostra anche le funzioni non disponibili: non sono errori nascosti, ma limiti dichiarati della piattaforma o della build corrente.

04 · Esempi

Tre regole da provare

Alcuni eventi o azioni possono richiedere permessi e non tutte le piattaforme espongono le stesse possibilità. Usa sempre lo stato mostrato dall’app come riferimento.

05 · Collaudo

Checklist rapida per tester

• Il sito si apre da quietrules.app senza errori.
• La lingua corrisponde a quella preferita sul dispositivo.
• L’icona è corretta e la PWA si installa.
• Dall’icona, la PWA si apre senza la normale barra del browser.
• La barra inferiore è visibile e tutti i comandi raggiungono la sezione giusta.
• I testi non si sovrappongono e nessun pulsante esce dallo schermo.
• Dopo la prima visita online, la PWA riapre le pagine già salvate senza connessione.
• Dopo un aggiornamento, il messaggio discreto compare e il comando Aggiorna carica la nuova versione.
• I collegamenti non chiedono l’accesso al repository GitHub privato.

06 · Feedback

Come segnalare un problema

Una buona segnalazione permette di riprodurre il problema. Invia, quando possibile, uno screenshot insieme a queste informazioni:

07 · Privacy

Permessi e accessi

• Il sito pubblico non rende pubblico il codice: il repository GitHub rimane privato.
• La PWA non richiede un account QuietRules e non consente l’accesso al repository.
• Le regole e la cronologia dell’app sono progettate per restare sul dispositivo.
• I permessi di calendario, posizione o notifiche devono essere richiesti solo quando una funzione ne ha bisogno.
• Un tester può rifiutare un permesso; QuietRules deve mostrare il limite senza nasconderlo.

08 · FAQ

Domande frequenti