# Architettura Straordinarie (Filament)

## Obiettivo
Gestire le spese straordinarie con una vista guidata per:
- Operazioni
- Preventivo
- Rate
- Incassi
- Consuntivo

## Punto UI
- Pagina stabile: `/admin-filament/condomini/stabile?tab=gestioni&gestioni_tab=straordinarie`
- Selezione gestione straordinaria e sotto-tab di dettaglio.

## Sorgenti dati legacy
Connessione: `gescon_import`

### 1) `prevent_straordinari`
- `n_stra`: identificativo gestione straordinaria
- `cod_spe`: codice voce spesa
- `importo_euro`: importo preventivo voce

### 2) `voc_spe`
- `cod`: codice voce
- `descriz`: descrizione voce
- `tabella`: codice tabella di riparto
- `preventivo_euro`: fallback preventivo
- `consuntivo_euro`: valore consuntivo

## Mappature operative
- Gestione straordinaria (`gestioni_contabili.numero_straordinaria`) ↔ `prevent_straordinari.n_stra`
- Voce spesa ↔ `prevent_straordinari.cod_spe = voc_spe.cod`
- Tabella riparto legacy ↔ `voc_spe.tabella` mappata su `tabelle_millesimali` locali

## Riparto con tabelle locali
La UI prova a risolvere la tabella con chiavi (ordine):
1. `tabelle_millesimali.codice_tabella`
2. `tabelle_millesimali.legacy_codice`
3. `tabelle_millesimali.nome_tabella`

Normalizzazione: confronto `UPPERCASE + TRIM`.

## Stato attuale implementazione
- Preventivo: tabella con voci + importi da `prevent_straordinari` (fallback `voc_spe.preventivo_euro`).
- Consuntivo: tabella con `voc_spe.consuntivo_euro`.
- Operazioni/Rate/Incassi: struttura pronta, integrazione completa da completare.

## Prossimi step
1. Collegare Operazioni a registrazioni/fatture legate a gestione straordinaria.
2. Collegare Rate a piano straordinario (numero rate, cadenza, scadenze, importi).
3. Collegare Incassi a rate emesse straordinarie.
4. Aggiungere controllo coerenza preventivo vs consuntivo.

## Note Open Source
- Tenere separata la logica di mapping legacy in service dedicato (consigliato).
- Evitare query complesse direttamente in Blade in una fase successiva (refactor suggerito).