feat: aggiornamenti alla documentazione e miglioramenti UI/UX

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