# 🗳️ 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/
├── dev.sh            # Script sviluppo (install, dev, server, build, ...)
├── ai-prompts/       # Documentazione sviluppo e prompt
├── backend-mock/     # API mock in Python FastAPI
│   └── static/       # Frontend buildato (generato)
└── frontend/         # App React + TypeScript + Tailwind
```

## 🚀 Quick Start

### Setup Iniziale

```bash
./dev.sh install
```

### Sviluppo (hot reload)

```bash
./dev.sh dev
# Backend API: http://localhost:8000
# Frontend Dev: http://localhost:5173
```

### Produzione Locale

```bash
./dev.sh server
# App completa: http://localhost:8000
```

### Altri Comandi

```bash
./dev.sh build      # Solo build frontend
./dev.sh backend    # Solo backend (API)
./dev.sh frontend   # Solo frontend dev
./dev.sh shell      # Shell pipenv backend
./dev.sh clean      # Pulisce build e cache
./dev.sh help       # Mostra tutti i comandi
```

## 📚 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`

## 🔍 Debug

Accedi a `/debug` per diagnostica RFID in tempo reale.

## 📄 Licenza

Progetto privato - Movimento dei Focolari