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

4.1 KiB

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.