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

77 lines
2.5 KiB
Markdown

# 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