Dal brief confuso al documento UX/UI

# PawSoul — documento UX/UI

## 1. Il prodotto in tre righe
PawSoul fa incontrare cani e gatti compatibili nello stesso quartiere e porta i
loro proprietari a fissare un incontro vero. Ci si iscrive, si registra il
proprio animale e si scorrono le schede degli altri: quando il mi piace è
reciproco si apre una conversazione. Un profilo può essere segnato come
disponibile per adozione, e allora compare anche a chi cerca un animale a cui
dare casa.

## 2. Problema, utente, lavoro da svolgere
Problema: si esce con il proprio animale tutti i giorni, negli stessi posti, e
non si conosce nessuno con cui farlo. L'animale si annoia, la persona pure.
Utente: chi ha un cane o un gatto, esce (o vorrebbe far socializzare l'animale)
con una certa regolarità, e non ha una rete di persone attorno. Secondario: chi
cerca casa a un animale — un canile, un privato.
Lavoro da svolgere: «quando esco con il mio animale da solo, voglio trovare
qualcuno di compatibile vicino a me, così la passeggiata diventa un incontro».
Assunzione dichiarata: il numero che conta è quanti incontri vengono fissati in
chat, non quanti iscritti ci sono. Il cliente non sapeva come misurarlo; lo
misuriamo come «conversazioni in cui compare una proposta di data o di luogo».

## 3. L'azione principale e il flusso
Azione principale: valutare una scheda e dire sì o no. È l'unico gesto che
l'app esiste per far ripetere; tutto il resto è conseguenza.
Flusso: apri → ti iscrivi → registri il tuo animale → vedi le schede → metti
mi piace → scatta il match → scrivi → proponi un incontro.
Il gesto vive in due modi equivalenti: il trascinamento e due pulsanti sotto la
scheda. Chi non capisce il trascinamento deve poter usare l'app lo stesso.

## 4. MVP: dentro e fuori
Dentro: registrazione di un animale, schede da scorrere, filtri per specie e
distanza, filtro solo adozione, match, conversazione, profilo pubblico
dell'animale, area personale con più animali propri.
Fuori, e scritto perché non si perda: mappa degli incontri, recensioni tra
utenti, badge di vaccinazione verificati, notifiche push, gruppi, strumenti di
gestione per i canili, qualsiasi pagamento.
Regola di taglio: si taglia in larghezza. Meno funzioni, ma nessuna schermata
raggiungibile lasciata a metà.

## 5. Le schermate (dieci) e come si raggiungono
1. Vetrina pubblica — spiega il prodotto e porta all'iscrizione. Da lì si
   raggiungono anche i profili degli animali in adozione.
2. Iscrizione — nome, email, password, città. Porta alla registrazione
   dell'animale.
3. Accesso — email e password. Porta alla bacheca.
4. Registrazione dell'animale — a passi: proprietario, specie, dati base,
   carattere (domande diverse per cane e per gatto), foto, cosa cerca, e la
   scheda finita mostrata come risultato.
5. Bacheca — a chi sei entrato: animale attivo, nuovi match, attività recente,
   scorciatoia alle schede.
6. Schede — la schermata principale. Mazzo, filtri, match a tutto schermo.
7. Match — elenco delle conversazioni. Su schermo grande, elenco e
   conversazione affiancati.
8. Conversazione — su telefono è una schermata a sé, raggiunta dall'elenco.
9. Profilo pubblico dell'animale — dalle schede, da un match, dalla vetrina.
10. Area personale — i miei animali, aggiungine uno, preferenze di ricerca,
    impostazioni, esci.
Navigazione: su telefono barra in basso a quattro voci (schede, match,
bacheca, profilo). Su schermo grande barra in alto.

## 6. Le decisioni chiuse
- Allegro ma non infantile → rimandata di proposito, convertita nei criteri
  del punto 7. Perdiamo il poter cominciare subito a disegnare.
- Tante funzioni ma semplice → si taglia in larghezza, le schermate restano
  tutte piene. Perdiamo funzioni che il cliente aveva in testa; restano
  scritte nella lista «fuori».
- Come Tinder ma non Tinder → si tiene il gesto, si cambia tutto il resto. Il
  modello è amicizia, non accoppiamenti. Non perdiamo niente se non la
  scorciatoia di copiare anche l'aspetto.
- Il pet o il proprietario → il pet è il profilo, il proprietario è l'utente e
  la conversazione è tra persone. Perdiamo un po' di simpatia, guadagniamo una
  chat comprensibile.
- I gatti adesso o dopo → adesso, perché è il modello dei dati e non una
  funzione. Perdiamo tempo ora, meno di quanto ne costerebbe rifarlo dopo.
- L'adozione → un interruttore sul profilo più un filtro, non un ruolo e non
  un pannello di gestione. Perdiamo gli strumenti da canile: se serviranno,
  saranno il progetto dopo.

## 7. Criteri della direzione estetica
Lo stile visivo NON è scelto in questo documento. Qualunque direzione si
prenda, deve passare questi quattro test:
1. Non-Tinder a colpo d'occhio: messa accanto a Tinder, una persona estranea
   al progetto deve dire che non è lo stesso prodotto.
2. Allegro senza infantile: deve reggere la parola «allegro» senza far pensare
   a un'app per bambini. Il cliente la mostra a un possibile investitore.
3. Le foto degli animali sono il contenuto: nessun trattamento che le riduca a
   sfondo, le copra o ne comprima lo spazio. Il muso è il prodotto.
4. Riconoscibile a 390px: su telefono deve restare sé stesso, non ripiegare su
   un aspetto generico.
Riferimenti dati dal cliente: Tinder (per il funzionamento, non per
l'aspetto), Duolingo (per il tono). Da evitare: le app bancarie, i grigi, i
testi piccoli.

## 8. Stati
Ogni schermata ha i suoi tre stati — vuoto, in caricamento, in errore — e
nessuno di questi è una schermata bianca.
- Schede, mazzo finito: «hai visto tutti quelli in zona», più il modo di
  allargare la distanza e di ricaricare.
- Match, nessun match: cosa fare per averne, con il collegamento alle schede.
- Conversazione senza messaggi: un suggerimento su come aprire, non uno spazio
  vuoto.
- Caricamento: sagome della stessa forma del contenuto vero, mai una rotella
  al centro dello schermo.
- Errore di rete: recuperabile, con il pulsante per riprovare.
- Primo avvio: il mazzo non è mai vuoto al primo accesso — c'è già un insieme
  di profili nella zona scelta durante la registrazione.

## 9. Responsive
Si progetta a 390px e si allarga. Su telefono: barra in basso, mazzo a tutta
larghezza, elenco match e conversazione su due schermate. Su schermo grande:
barra in alto, elenco e conversazione affiancati, mazzo centrato con i filtri
di lato. Ogni elemento toccabile è alto almeno 44px. Nessuna schermata può
diventare generica allargandosi.

## 10. Criteri di completamento
- Il flusso principale si percorre dall'inizio alla fine su un telefono:
  iscrizione, registrazione dell'animale, schede, match, conversazione.
- Nessun collegamento della demo porta a una schermata che non esiste o vuota.
- Le dieci schermate hanno contenuti veri, non testo segnaposto.
- La registrazione fa domande diverse per un cane e per un gatto.
- Il filtro per specie e quello per adozione funzionano e cambiano il mazzo.
- Tutti e tre gli stati esistono su ogni schermata.
- L'aspetto scelto passa i quattro test del punto 7.