netgescon-day0/Miki-Bug-workspace/ACQUA-Acea/note_per_acquisizione_dati.md

allora dbbiamo lavorare con lo stabile nella cartella di GESCON la numero (0023) dentro trovi il file generale_stabile.mdb dove trovi dati nella tabella (anni) che ci da il vrifgerimento dell'anno e la cartella dove sono contenuti i dati, nell'importazione prevediamo subito di mettere chiusi perciò non visualizzabili se non nell'archivio di tutte le cartelle precedenti agli anni (2024 e 2025) quelle vecchie ci serfvono per archivio. Sempre nello stesso archivio troviamo la tabella (acqua_gen) dove troviamo le varie gestioni fatte e ripartite e qui trovi il punto di contatto con le altre tabelle (acqua_gen.rif_ute) dove trovi l'anno di gestione e (acqua_gen.ripart) e il totale ripartito per quella gestione dove trovo nel campo il totale delle fatture da ripartire (acqua_gen.di_cui_prop_consumi_euro) e nella colonna (acqua_gen.ripart_precedente) per agganciare in prima battuta le fatture ripartite (acqua_fatture) collegate con il campo (acua_fatture.rif_ute) e dentro la tabella (acqua_dett) e il relativo campo di colegamento (acqua_dett.rif_ute) e il campo (acqua_det.t_cod__cond) le letture dei consumi che trovi sono quele che possiamo utilizzare. Ti ricordo che abbiamo previsto che normalmente utilizziamo sempre il proprietario attuale (oggi c'è) ma dobbiamo tenere traccia nel tempo del passaggio di proprietà o cambio affitto (cambia l'inquilino), controlla la procedura che all'unità immobiliare sia correttamente collegato il nominativo (C o I) perciò tieni e metti questi dati per le letture dell'acqua come al solito per tutti gli stabili anzi controlliamo che siano allineati gli archivi anche per gli altri stabili e procediamo con l'importazione dello stabile (0023) a proposito cominciamo a gestire il tipo di Utenza (acqua_dett.tipo_utenza) che ci serve per gestire il tipo di tariffa da applicare e che troveremo nell'acquisizione dei PDF di questo stabile.

Operativo 0023 (06/03/2026)

• Comando import introdotto: php artisan gescon:import-acqua-legacy --stabile=0023
• Sorgente: /mnt/gescon-archives/gescon/0023/generale_stabile.mdb
• Tabelle lette: anni, acqua_gen, acqua_fatture, acqua_dett
• Risultato import:
  • acqua_dett processate: 593
  • letture aggiornate: 593 (dopo run iniziale)
  • letture con unita risolta: 43
  • letture senza match unita: 550
  • nominativi C/I sincronizzati: 12 (fonte legacy_acqua_dett)
  • gestioni storiche chiuse (< 2024): 198

Note tecniche:

• Il campo tipo_utenza di acqua_dett viene salvato nel payload raw della lettura per uso tariffario successivo.
• La tabella stabile_servizio_tariffe in questo ambiente richiede fattura_elettronica_id obbligatoria, quindi il caricamento tariffe legacy da acqua_gen viene saltato in sicurezza (no hard fail).
• Per i prossimi stabili usare lo stesso comando cambiando --stabile=<codice_cartella>.