# 📥 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