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

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