# RoBenz – Patch v1.1

Aggiornamento del progetto esistente su ro-benz.it con:
- Design system verde (era blu)
- Bottoni/icone per tipo carburante (era menu a tendina)
- Footer con link verdi
- Grafica generale ottimizzata e omogenea
- Sistema statistiche completo (dashboard, grafici banda prezzi, top 10 mese)
- Seeder 30 giorni storico con dati realistici basati sui prezzi reali live

---

## Struttura patch

```
robenz-update/
├── resources/views/
│   ├── layouts/app.blade.php              ← SOSTITUISCE (header verde, nav con Statistiche)
│   ├── components/
│   │   ├── fuel-selector.blade.php        ← NUOVO (bottoni carburante)
│   │   ├── station-card.blade.php         ← SOSTITUISCE (design verde)
│   │   └── price-chart.blade.php          ← SOSTITUISCE (palette verde)
│   ├── stations/
│   │   ├── index.blade.php                ← SOSTITUISCE (usa fuel-selector)
│   │   └── show.blade.php                 ← SOSTITUISCE (migliorata)
│   └── stats/
│       └── index.blade.php                ← NUOVO (dashboard statistiche)
├── app/
│   ├── Http/Controllers/
│   │   └── StatsController.php            ← NUOVO
│   ├── Models/
│   │   └── DailyStat.php                  ← NUOVO
│   ├── Services/
│   │   └── StatsService.php               ← NUOVO
│   └── Console/
│       ├── Commands/ComputeStats.php       ← NUOVO
│       └── Kernel.php                     ← SOSTITUISCE (aggiunge stats:compute)
├── database/
│   ├── migrations/
│   │   ├── 2024_01_01_000003_create_price_history_table.php  ← NUOVO (safe se già esiste)
│   │   └── 2024_01_02_000001_create_daily_stats_table.php    ← NUOVO
│   └── seeders/
│       └── MonthlyHistorySeeder.php        ← NUOVO (30gg storico realistico)
└── routes/web.php                          ← SOSTITUISCE (aggiunge /statistiche e API)
```

---

## Applicazione sul server

### 1. Carica i file (da locale)

```bash
# Dal tuo computer, nella cartella dove hai scompattato robenz-update/
rsync -av robenz-update/ utente@server:/var/www/robenz/ \
  --exclude='.gitkeep'
```

oppure via git:
```bash
# Sul server
cd /var/www/robenz
git pull
# copia manualmente i file della patch nelle cartelle corrette
```

### 2. Sul server: migra e attiva

```bash
cd /var/www/robenz

# Nuove migrazioni (price_history se mancante + daily_stats)
php artisan migrate

# Invalida cache Laravel
php artisan cache:clear
php artisan config:cache
php artisan route:cache
php artisan view:clear

# Genera storico 30 giorni dai prezzi REALI già in DB
php artisan db:seed --class=MonthlyHistorySeeder

# Calcola aggregati statistici (fatto già dal seeder, ma per sicurezza)
php artisan stats:compute --province=RO --days=31

# Ottimizza
php artisan optimize
```

### 3. Permessi (se necessario)

```bash
sudo chown -R www-data:www-data /var/www/robenz/storage
sudo chown -R www-data:www-data /var/www/robenz/bootstrap/cache
```

---

## Nuove funzionalità

### Dashboard Statistiche → /statistiche
- Card riassuntive per ogni carburante (avg, min, max, delta vs ieri)
- Grafico banda prezzi (min/avg/max) provinciale con selezione periodo
- Top 10 distributori più economici nel mese (media storica)

### Nuovi comandi Artisan

```bash
# Calcola aggregati del giorno corrente
php artisan stats:compute --province=RO

# Rebuild completo degli ultimi 90 giorni
php artisan stats:compute --province=RO --days=90

# Seeder storico (SOLO in sviluppo/staging)
php artisan db:seed --class=MonthlyHistorySeeder
```

### Scheduler aggiornato
Il Kernel ora esegue in sequenza:
- 09:15 → `fuel:sync` (scarica nuovi prezzi MIMIT)
- 10:00 → `stats:compute` (ricalcola aggregati del giorno)

---

## Note importanti

**Il MonthlyHistorySeeder** cancella e rigenera price_history e daily_stats per la
provincia RO prima di inserire i nuovi dati. **Non eseguirlo in produzione con dati
storici reali che vuoi conservare.** In produzione, usa `stats:compute --days=90`
per il rebuild degli aggregati a partire dallo storico reale già accumulato.

**Il componente `fuel-selector`** sostituisce il `<select>` nel form filtri.
Il vecchio componente `fuel-tabs.blade.php` può essere eliminato o lasciato ignorato.
