# Bug risolti e validazioni

## Obiettivo

Questa sezione tiene separato il materiale di fix dal manuale generale. Qui annotiamo:

- bug corretti
- fix applicato
- stato della verifica
- eventuali controlli ancora da fare su staging

## Registro sintetico

### Ripristino bootstrap pannello admin

- Problema: `AdminFilamentPanelProvider.php` era stato corrotto da una modifica incompleta e impediva il bootstrap corretto.
- Fix applicato: ripristino struttura PHP e riallineamento del provider.
- Stato: [U] risolto localmente, bootstrap Laravel nuovamente valido.

### Token CTI Panasonic e lettura configurazione piu robusta

- Problema: il flusso staging poteva fallire per risoluzione non coerente del token CTI.
- Fix applicato: `PanasonicCstaController` riallineato a `config/cti.php` con risoluzione piu robusta.
- Stato: [P] implementato e verificato in locale; su staging resta da completare la validazione end-to-end del canale reale.

### Mismatch stabile/anno in Ordinarie

- Problema: la pagina `gescon/ordinarie` poteva mostrare dati non coerenti con stabile e anno scelti nella topbar.
- Fix applicato: default anno dal contesto condiviso e centralizzazione risoluzione codice legacy stabile.
- Stato: [P] implementato e validato a livello codice; da verificare sul caso reale staging con dati utente specifici.

### Filtri acqua e servizi non coerenti con la gestione attiva

- Problema: in `condomini/servizi-utenze` e archivio letture la selezione anno/stabile non era sempre rispettata in tutte le query.
- Fix applicato: applicazione del filtro anno attivo e del contesto stabile ai blocchi acqua principali.
- Stato: [P] implementato e testato sintatticamente; serve verifica funzionale con dati annuali reali su staging.

### Tracciato tecnico SMDR e CSTA mescolato

- Problema: una sola vista tecnica rendeva meno chiaro distinguere fallback SMDR da eventi CTI/CSTA ricchi.
- Fix applicato: nuovi tab distinti in `strumenti/post-it-gestione` e vista click-to-call dedicata.
- Stato: [U] implementato; da usare come base per test operativi PBX e future integrazioni provider-agnostic.

## Validazioni eseguite nell ultimo ciclo

- `php artisan list` eseguito con esito positivo dopo gli ultimi fix applicativi
- controlli sintattici PHP sulle classi modificate senza errori
- diagnostica editor senza errori sui file toccati

## Validazioni ancora aperte

- verificare su staging la nuova tab `CTI / CSTA e Click-to-Call`
- verificare il caso reale di mismatch stabile/anno con dati staging
- usare il filtro annuale acqua per l estrazione effettiva delle fatture e confermare il perimetro dati

## Regola di aggiornamento

Ogni bug corretto va aggiornato qui in quattro righe:

1. problema osservato
2. fix applicato
3. stato verifica locale
4. stato verifica staging o nodi remoti