feat: aggiornamenti alla documentazione e miglioramenti UI/UX

ai-prompts/00-welcome-agent.md

@@ -147,7 +147,8 @@ VotoFocolari/
 
 5. **Badge Duplicati**: Se lo stesso badge viene passato più volte di seguito, viene ignorato (no ricaricamento).
 
-6. **Success Modal Interrompibile**: Se durante il carosello di benvenuto si passa un nuovo badge, la modal si chiude e viene caricato subito il nuovo utente.
+6. **Success Modal Interrompibile**: Se durante il carosello di benvenuto si passa un nuovo badge, la modal si chiude e
+   viene caricato subito il nuovo utente.
 
 ---
 

ai-prompts/01-backend-plan.md

@@ -50,8 +50,8 @@ backend-mock/
 
 - [x] Password validatore (solo password, badge gestito dal frontend)
 - [x] Lista utenti mock con **badge reali**:
-    - `0008988288` - Marco Bianchi (Votante, ammesso)
-    - `0007399575` - Laura Rossi (Votante, ammessa)
+    - `0008988288` - Marco Bianchi (Convocato, ammesso)
+    - `0007399575` - Laura Rossi (Invitato, ammessa)
     - `0000514162` - Giuseppe Verdi (Tecnico, NON ammesso)
     - `0006478281` - **NON nel DB** (per test "non trovato")
 - [x] Estrarre dati in file JSON separato
@@ -60,9 +60,20 @@ backend-mock/
 
 **Nota:** I messaggi di benvenuto multilingua sono gestiti dal frontend con carosello.
 
-**TODO (da concordare con committenti):**
+**Ruoli Supportati:**
+| Ruolo | Descrizione |
+|-------|-------------|
+| `Convocato` | Con diritto di voto |
+| `Invitato` | Senza diritto di voto |
+| `Tecnico` | Staff tecnico |
+| `Staff` | Personale organizzativo |
 
-- Valutare se `login-validate` debba ricevere e verificare anche il badge del validatore
+**Logica Login-Validate:**
+
+- Il backend **DEVE** verificare la password
+- Il backend **PUÒ** opzionalmente verificare anche il badge (whitelist validatori)
+- Risposta 401 = password errata
+- Risposta 403 = badge non in whitelist (se implementato)
 
 ### 4. Routes API (`api/routes.py`)
 
@@ -175,10 +186,12 @@ curl -X POST http://localhost:8000/entry-request \
 Tutti i task sono stati implementati e testati.
 
 ### 📄 Documentazione API
+
 Per le specifiche complete da implementare nel backend reale, vedere:
 **`backend-mock/API_SPECIFICATION.md`**
 
 Questo documento contiene:
+
 - Descrizione completa di tutti gli endpoint
 - Schema request/response JSON
 - Codici di errore e gestione

ai-prompts/02-frontend-plan.md

@@ -81,9 +81,14 @@ Ottimizzata per tablet in orizzontale.
 - [x] `ActiveGateScreen.tsx` - varco attivo:
     - [x] Card utente (layout largo per tablet)
     - [x] **Schermata "badge non trovato"** con countdown barra visiva (30s)
+    - [x] **Pulsante "Annulla" nella schermata badge non trovato**
+    - [x] **Badge diverso durante errore "non trovato" → ricarica nuovo utente/errore**
     - [x] **Notifica badge validatore ignorato**
     - [x] NumLockBanner
-- [x] `SuccessModal.tsx` - conferma ingresso con carosello (**durata aumentata 8s**)
+- [x] `SuccessModal.tsx` - conferma ingresso con carosello:
+    - [x] **Carosello fullwidth** (nessun troncamento testo)
+    - [x] **Scorrimento lento** (più rilassato, meno ansioso)
+    - [x] **Durata aumentata 8s**
 - [x] `ErrorModal.tsx` - errore fullscreen
 - [x] `DebugScreen.tsx` - pagina diagnostica RFID
 
@@ -111,9 +116,10 @@ Ottimizzata per tablet in orizzontale.
 - [x] Componente `WelcomeCarousel.tsx`
 - [x] 10 lingue supportate
 - [x] **Animazione smooth sliding** (slide up/down)
-- [x] Scorrimento automatico (intervallo calcolato dinamicamente)
+- [x] Scorrimento automatico lento (più rilassato)
 - [x] Modale fullscreen verde
-- [x] **Durata totale: 8 secondi** (più rilassato)
+- [x] **Contenitore fullwidth** (nessun troncamento testo lungo)
+- [x] **Durata totale: 8 secondi**
 
 ### 10. Debug & Diagnostica
 
@@ -130,12 +136,12 @@ Ottimizzata per tablet in orizzontale.
 
 ## Badge di Test
 
-| Badge        | Nome           | Ruolo   | Ammesso       |
-|--------------|----------------|---------|---------------|
-| `0008988288` | Marco Bianchi  | Votante | ✅ Sì          |
-| `0007399575` | Laura Rossi    | Votante | ✅ Sì          |
-| `0000514162` | Giuseppe Verdi | Tecnico | ❌ No          |
-| `0006478281` | -              | -       | ⚠️ Non nel DB |
+| Badge        | Nome           | Ruolo     | Ammesso       |
+|--------------|----------------|-----------|---------------|
+| `0008988288` | Marco Bianchi  | Convocato | ✅ Sì          |
+| `0007399575` | Laura Rossi    | Invitato  | ✅ Sì          |
+| `0000514162` | Giuseppe Verdi | Tecnico   | ❌ No          |
+| `0006478281` | -              | -         | ⚠️ Non nel DB |
 
 ---