feat: setup iniziale sistema controllo accessi Focolari

Struttura progetto:
- Backend mock Python (FastAPI) con API per gestione varchi
- Frontend React + TypeScript + Vite + Tailwind CSS
- Documentazione e piani di sviluppo

Backend (backend-mock/):
- API REST: /info-room, /login-validate, /anagrafica, /entry-request
- Dati mock: 7 utenti, validatore (999999/focolari)
- CORS abilitato, docs OpenAPI automatiche
- Configurazione pipenv per ambiente virtuale

Frontend (frontend/):
- State machine completa per flusso accesso varco
- Hook useRFIDScanner per lettura badge (pattern singolo)
- Componenti UI: Logo, Button, Input, Modal, UserCard, Timer
- Schermate: Loading, Login, ActiveGate, Success/Error Modal
- Design system con colori Focolari
- Ottimizzato per tablet touch

Documentazione (ai-prompts/):
- Welcome guide per futuri agenti
- Piano sviluppo backend e frontend con checklist

DA COMPLETARE:
- Hook RFID multi-pattern (US/IT/altri layout tastiera)
- Pagina /debug per diagnostica in loco
- Logging console strutturato

README.md

@@ -0,0 +1,51 @@
+# 🗳️ Focolari Voting System
+
+Sistema di controllo accessi per le assemblee di voto del **Movimento dei Focolari**.
+
+## 📖 Descrizione
+
+Applicazione web ottimizzata per tablet che gestisce i varchi d'ingresso alle sale votazione. Il sistema utilizza lettori RFID USB (che emulano tastiera) per identificare validatori e partecipanti.
+
+## 🏗️ Struttura Progetto
+
+```
+VotoFocolari/
+├── ai-prompts/       # Documentazione sviluppo e prompt
+├── backend-mock/     # API mock in Python FastAPI
+└── frontend/         # App React + TypeScript + Tailwind
+```
+
+## 🚀 Quick Start
+
+### Backend
+```bash
+cd backend-mock
+pipenv install
+pipenv run start
+# Server: http://localhost:8000
+# Docs API: http://localhost:8000/docs
+```
+
+### Frontend
+```bash
+cd frontend
+npm install
+npm run dev
+# App: http://localhost:5173
+```
+
+## 📚 Documentazione
+
+Per dettagli tecnici, consulta la cartella `ai-prompts/`:
+- `00-welcome-agent.md` - Panoramica progetto
+- `01-backend-plan.md` - Piano sviluppo backend
+- `02-frontend-plan.md` - Piano sviluppo frontend
+
+## 🔐 Credenziali Test
+
+- **Badge Validatore:** `999999`
+- **Password:** `focolari`
+
+## 📄 Licenza
+
+Progetto privato - Movimento dei Focolari