95 lines
5.0 KiB
Markdown
95 lines
5.0 KiB
Markdown
# 📥 Guida Import GESCON da Stabili.mdb (NetGescon 2025)
|
||
|
||
Questa guida spiega come importare i dati reali dal vecchio GESCON in NetGescon usando la pipeline artisan gescon:import-full, sfruttando Stabili.mdb per mappare Codice Fiscale del condominio, CF amministratore, dati catastali (foglio/particella/sub) e coordinate bancarie (IBAN/banca) quando presenti.
|
||
|
||
## Prerequisiti
|
||
|
||
- Linux con mdb-tools installati (mdb-export, mdb-tables)
|
||
- PHP 8.3+, Laravel 12.x
|
||
- Accesso alla cartella di staging che contiene Stabili.mdb e gli altri MDB/CSV esportati
|
||
- Backup DB prima di un import reale
|
||
|
||
## File sorgenti rilevanti
|
||
|
||
- docs/000-IMPORT/01-GESCON/stabili-mdb-schema.json – struttura MDB rilevata
|
||
- docs/000-IMPORT/01-GESCON/complete-mdb-schema.json – schema completo
|
||
- docs/IMPORT-ESEMPIO-STABILI.csv – esempio campi target (CF, IBAN, banca, ABI/CAB, intestazione)
|
||
|
||
## Campo → Mappatura (Stabili.mdb → NetGescon)
|
||
|
||
- denominazione → stabili.denominazione
|
||
- indirizzo, cap, citta, provincia → stabili.[indirizzo, cap, citta, provincia]
|
||
- codice_fiscale (condominio) → stabili.codice_fiscale
|
||
- cf_amministratore (se presente in staging) → stabili.cod_fisc_amministratore
|
||
- foglio/particella/sub (se presenti in staging) → stabili.[foglio, particella, subalterno]
|
||
- iban_bancario/iban_postale, banca, abi, cab, intestazione (se presenti in staging o CSV di supporto) → tabella dati_bancari associata allo stabile; visibile nella tab “Dati Bancari” dello Stabile
|
||
|
||
Note
|
||
- Se alcuni campi non sono direttamente in Stabili.mdb, la pipeline può attingere da tabelle/csv di staging. Tieni allineati i nomi col file IMPORT-ESEMPIO-STABILI.csv.
|
||
- I dati bancari vengono creati come conto collegato allo Stabile; l’IBAN sarà poi usato per import/riconciliare i movimenti bancari.
|
||
|
||
## Comando consigliato (artisan)
|
||
|
||
Usa la pipeline centralizzata con dry-run per validare, poi esegui l’import reale:
|
||
|
||
- Dry-run (nessuna scrittura):
|
||
- php artisan gescon:import-full --stabile=0024 --dry-run --solo=stabili
|
||
- php artisan gescon:import-full --stabile=0019 --dry-run --solo=stabili
|
||
|
||
- Import reale (scrive sul DB):
|
||
- php artisan gescon:import-full --stabile=0024 --solo=stabili
|
||
- php artisan gescon:import-full --stabile=0019 --solo=stabili
|
||
|
||
Opzioni principali
|
||
- --stabile=NNNN limita ad uno stabile legacy (es. 0024, 0019)
|
||
- --anno=YYYY delimita le gestioni/operazioni per anno
|
||
- --path=/percorso/staging punta alla cartella con MDB/CSV (se differente)
|
||
- --dry-run avvia in sola validazione
|
||
- --solo=<step> esegue solo uno step (stabili, unita, soggetti, diritti, millesimi, voci, operazioni, rate, incassi, giroconti, straord, addebiti, detrazioni)
|
||
- --reset-temp reset tabelle temporanee
|
||
- --no-views salta l’aggiornamento delle viste QA
|
||
|
||
## Sequenza completa tipica
|
||
|
||
1) Stabili – anagrafica + CF/CF-amministratore + catasto + dati bancari (se presenti)
|
||
2) Unità – unità immobiliari, interni e scale; palazzine derivate se mancanti
|
||
3) Soggetti – proprietari/inquilini con codici deterministici a 8 char
|
||
4) Diritti – proprietà/locazioni e quote
|
||
5) Millesimi – tabelle e dettagli per unità, con UI “Show” e “Configura”
|
||
6) Voci/Operazioni – voce spesa, prima nota, partita doppia
|
||
7) Rate/Incassi – emissione e registrazione incassi
|
||
8) Straordinarie/Addebiti/Detrazioni – componenti extra
|
||
|
||
## Verifiche post-import (QA)
|
||
|
||
- Stabile → Tab Dati Generali: vedi Codice Fiscale, CF Amministratore, Catasto (foglio/particella/sub)
|
||
- Stabile → Tab Dati Bancari: vedi IBAN, banca, saldo attuale (se caricato), API saldo attuale disponibile
|
||
- Tabelle Millesimali → pagina Dettaglio: verifica somma millesimi, per-unità, e azione “Bilancia”
|
||
- QA viste/ cruscotti: anomalie, duplicati, collegamenti mancanti
|
||
|
||
## Collegamento con conto bancario e riconciliazioni
|
||
|
||
- I conti creati nel tab Dati Bancari sono usati per importare estratti (CSV banca) e associare movimenti
|
||
- Le scritture contabili (partita doppia) includono chiavi per la riconciliazione con movimenti bancari; lo stato di quadratura viene aggiornato a valle del matching
|
||
|
||
## Esempi reali richiesti
|
||
|
||
- Stabile 147 (cartella legacy 0024)
|
||
- Dry-run: php artisan gescon:import-full --stabile=0024 --dry-run --solo=stabili
|
||
- Import: php artisan gescon:import-full --stabile=0024 --solo=stabili
|
||
|
||
- Stabile 146 “Andrea Doria” (cartella 0019)
|
||
- Dry-run: php artisan gescon:import-full --stabile=0019 --dry-run --solo=stabili
|
||
- Import: php artisan gescon:import-full --stabile=0019 --solo=stabili
|
||
|
||
## Troubleshooting rapido
|
||
|
||
- CF/IBAN mancanti: verifica i CSV di staging e il mapping con i nomi previsti in IMPORT-ESEMPIO-STABILI.csv
|
||
- Millesimi non allineati: usa l’azione “Bilancia” nella pagina della tabella
|
||
- Unità non abbinate: controlla i criteri scala/interno e normalizzazione cantine
|
||
|
||
Riferimenti
|
||
- docs/000-IMPORT/README-IMPORT-PROCESS.md – panoramica processo
|
||
- docs/000-IMPORT/RELAZIONI-COMPLETE-FLUSSO-FINANZIARIO.md – end-to-end contabilità↔banca
|
||
- docs/91-database/02-tabelle-collegate/contabilita.md – struttura scritture e riconciliazioni
|