netgescon-day0/docs/000-IMPORT/01-GESCON/GUIDA-IMPORT-GESCON-MDB.md

143 lines
4.1 KiB
Markdown

# Guida Import GESCON da MDB
## Obiettivo
Usare `Stabili.mdb` come sorgente di controllo iniziale per decidere quali stabili importare, con una finestra dati prudente e verificabile prima della distribuzione operativa.
## Sorgenti da considerare
### 1. Metadati stabili
- `dbc/Stabili.mdb`
- campi chiave attesi:
- `cod_stabile`
- `nome_directory`
- campo CF stabile/condominio valorizzato
### 2. Dati annuali per stabile
- `<cod_stabile>/<anno>/singolo_anno.mdb`
- tabelle minime da validare:
- `condomin`
- `operazioni`
- `rate`
- `incassi`
- `dett_tab`
- `voc_spe`
- `straordinarie`
### 3. Dati trasversali stabile
- `<cod_stabile>/generale_stabile.mdb`
- utile per verifiche aggiuntive su rate emesse, casse e dati generali
## Regole operative di preselezione
Importare nello smoke test solo gli stabili che rispettano tutte queste condizioni:
1. lo stabile esiste in `Stabili.mdb`
2. il campo CF stabile/condominio e valorizzato
3. `cod_stabile` e presente e usabile come codice mnemonico principale
4. `nome_directory` e presente e punta a una cartella archivio esistente
## Regole di naming e archivio
- codice stabile operativo: usare `stabile.cod_stabile`
- cartella archivio stabile: usare `stabile.nome_directory`
- cartella dominio NetGescon: usare sempre il codice univoco/canonico dello stabile
- sincronizzazione documentale: mantenere mapping stabile tra codice canonico NetGescon e cartella legacy, cosi da poter allineare anche Google Drive
## Finestra temporale smoke test
Per il primo passaggio operativo non importare tutto lo storico.
### Import base
- anno corrente legacy piu recente disponibile
- anno precedente
### Import esteso solo per straordinarie
- includere fino a 5 anni indietro
- fermarsi prima se non esistono MDB annuali o non esistono righe utili nelle tabelle straordinarie
### Storico oltre la finestra base
- da importare solo su richiesta o quando serve per quadrature, estratti conto storici o audit mirati
## Copertura minima richiesta per rendere operativo il sistema
Lo smoke test deve confermare che per ogni stabile selezionato siano importabili almeno:
1. nominativi completi da `condomin`
2. unita immobiliari e riferimenti scala/interno/piano
3. collegamenti proprietario/inquilino/comproprietari
4. voci spesa e tabelle millesimali essenziali
5. rate e incassi degli ultimi 2 anni
6. straordinarie degli ultimi 5 anni, se presenti
Questo e il minimo per attivare senza dati monchi:
- ticket
- letture acqua
- CRM/rubrica unica
- estratti conto da cellulare
- pagamento online rate condominiali
## Smoke Test pratico per stabile
Per ogni stabile filtrato da `Stabili.mdb` eseguire questa checklist.
### A. Controllo metadati
- `cod_stabile` valorizzato
- `nome_directory` valorizzato
- CF stabile valorizzato
- cartella legacy esistente
### B. Controllo annualita
- individuato ultimo anno disponibile
- individuato anno precedente disponibile
- individuate eventuali annualita straordinarie fino a -5 anni
### C. Controllo file
- esiste `singolo_anno.mdb` per ogni anno scelto
- se presente, esiste `generale_stabile.mdb`
- `Stabili.mdb` leggibile senza errori
### D. Controllo tabelle minime
- `condomin` leggibile
- `operazioni` leggibile
- `rate` leggibile
- `incassi` leggibile
- `dett_tab` leggibile
- `voc_spe` leggibile
- `straordinarie` leggibile o assente in modo coerente
### E. QA dominio post-import
- stabile creato/aggiornato correttamente
- unita importate
- rubrica/nominativi deduplicati
- rate/incassi coerenti per gli anni caricati
- nessun crash nelle pagine operative principali
## Raccomandazione di rollout
Ordine consigliato:
1. caricare elenco candidati da `Stabili.mdb`
2. filtrare solo stabili con CF valorizzato
3. per ciascuno verificare `nome_directory`
4. importare ultimi 2 anni
5. importare straordinarie fino a 5 anni
6. eseguire QA per stabile/anno
7. abilitare progressivamente ticket, letture, CRM e consultazione mobile
## Nota importante
La tabella staging `gescon_import.stabili` non va usata come unica base per questa preselezione se i CF risultano non materializzati. In quel caso la fonte corretta per lo smoke test resta il `Stabili.mdb` reale.