netgescon-day0/docs/000-FILAMENT/04-FLOW-IMPORT.md

Flusso import completo (da zero)

1) Preparazione

• Verifica mdb-tools installati
• Verifica accesso a /mnt/gescon-archives/gescon/
• Verifica DB gescon_import esistente

2) Import staging per anno

Per ogni stabile e per ogni anno:

1. Carica condomin in staging (unità + nominativi)
2. Carica tabelle (legacy: tabelle), voc_spe, dett_tab
3. Carica operazioni, incassi
4. Carica straordinarie e preventivi straordinari
5. Carica dett_pers (addebiti personalizzati, I05)
6. Carica fraz_gen / fraz_dett (frazionamenti Z01/Z02)

Nota: il legacy replica tutto per anno → importare tutte le annualità.

3) Import sorgenti trasversali

• Stabili.mdb (anagrafica stabili)
• Fornitori.mdb
• generale_stabile.mdb (anni, emes_gen, emes_det, fatture)

4) Pipeline dominio

1. gescon:import-full --solo=stabili
2. gescon:import-full --solo=unita
3. gescon:import-full --solo=soggetti
4. gescon:import-full --solo=diritti
5. gescon:import-full --solo=millesimi
6. gescon:import-full --solo=voci
7. gescon:import-full --solo=banche
8. gescon:import-full --solo=operazioni
9. gescon:import-full --solo=rate
10. gescon:import-full --solo=incassi
11. gescon:import-full --solo=giroconti
12. gescon:import-full --solo=straord
13. gescon:import-full --solo=addebiti
14. gescon:import-full --solo=detrazioni

5) Enrichment

• StabileEnrichmentService: catasto + banca/posta

6) Verifiche post-import

• Stabili con codice_stabile + amministratore_id
• Unità con codice_unita univoco
• Soggetti deduplicati (CF/email)
• Tabelle con Tot_mm e collegamenti voc_spe
• Voci con tabella + percentuali proprietario/inquilino

7) Import movimenti banca

• Import XLSX Intesa in Casse/Banche → Movimenti
• Verifica presenza descrizione_estesa e match_data

8) Revisione contabile (post-import)

Usare dopo la sincronizzazione GESCON e import movimenti.

XX-01 · CED HOUSE (Estratti conto)

1. Aprire Revisione Contabile → Dettaglio revisione → tab Estratti conto
2. Estrarre TXT dai PDF (pdftotext -layout)
3. Verificare parsing sezioni (Riepilogo, Ordinaria 2023/2024, Straordinaria)
4. Importare righe e correggere eventuali segni -€

XX-02 · Conguagli

1. Aprire tab Conguagli nella revisione
2. Confrontare con dett_tab (Situazione Iniziale → Conguagli)
3. Segnalare eventuali scostamenti

XX-03 · Bilancio 2023

1. Aprire tab principale Bilancio 2023
2. Estrarre TXT dal PDF bilancio
3. Verificare:
   • Preventivo/Consuntivo (mastri/conti)
   • Conto Economico (Costi/Ricavi, versamenti)
   • Stato Patrimoniale
   • Crediti/Debiti verso fornitori