netgescon-day0/docs/000-FILAMENT/13-ARCHITETTURA-STRAORDINARIE.md

57 lines
2.0 KiB
Markdown

# 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).