netgescon-day0/docs/sviluppo/stabili_import.md

Flusso rapido import MDB (DEV)

Regola aggiornata 08/04/2026

• Per unita, soggetti e diritti, il corrente non si costruisce piu dall'anno passato in --anno se esiste un'annualita legacy piu recente.

• Per 0021, lo snapshot corrente autorevole e 0004.

• Gli anni precedenti, come 0003, restano sorgente di cronologia e quadratura, ma non devono riaprire codici vecchi tipo A/0, A/42, A/43, A/215, A/216.

• Il matching tra staging e dominio va letto cosi:

  • condomin.cod_cond -> unita_immobiliari.legacy_cond_id
  • scala/interno -> codice mnemonico operatore e controllo di riconciliazione

• Le straordinarie con stesso codice su anni diversi restano distinte per anno/numero progressivo e vanno considerate aperte nella gestione in cui vengono lette.

• Usa solo /home/michele/netgescon/netgescon-laravel per i comandi (niente /var/www/netgescon).

• Carica lo staging gescon_import.condomin con mdb-tools:
  php artisan gescon:load-mdb --mdb="/mnt/gescon-archives/gescon/0021/0003/singolo_anno.mdb" --table=condomin --stabile=0021 --anno=0003 --truncate

• Reimporta le sole unità:
  php artisan gescon:import-full --stabile=0021 --anno=3 --mdb-condomin="/mnt/gescon-archives/gescon/0021/0003/singolo_anno.mdb" --solo=unita

• Prosegui con soggetti, diritti, millesimi (dopo l’import unità):

  • php artisan gescon:import-full --stabile=0021 --anno=3 --mdb-condomin="/mnt/gescon-archives/gescon/0021/0003/singolo_anno.mdb" --solo=soggetti
  • php artisan gescon:import-full --stabile=0021 --anno=3 --mdb-condomin="/mnt/gescon-archives/gescon/0021/0003/singolo_anno.mdb" --solo=diritti
  • php artisan gescon:import-full --stabile=0021 --anno=3 --mdb-condomin="/mnt/gescon-archives/gescon/0021/0003/singolo_anno.mdb" --solo=millesimi

• Se devi ricalcolare piano/scala: prima pulisci unita_immobiliari (e unita_pertinenze) per quello stabile, poi riesegui i due comandi sopra.

Esito corrente (stabile 0021 / anno 0003 in DEV)

• load-mdb condomin: 268 righe staging
• import-full --solo=unita: 212 record
• import-full --solo=soggetti: 55 record
• import-full --solo=diritti: creati 212, aggiornati 1, skip 55 (tot 213)
• import-full --solo=millesimi: intestazioni 0, dettagli inseriti 1919, aggiornati 88 (tot 2007)

Ripeti la stessa sequenza per gli altri anni/cartelle cambiando --stabile e --anno e il path del singolo_anno.mdb.

Verifica reale aggiornata (stabile 0021 / snapshot corrente 0004)

• import-full --solo=unita --anno=0004: 140 record processati, 138 aggiornati
• import-full --solo=soggetti --anno=0004: 2 record processati
• import-full --solo=diritti --anno=0004: 6 inseriti, 3 aggiornati, 270 ignorati
• QA netgescon:qa-unita-nominativi --stabile_id=25:
  • unita attive 214
  • unita senza nominativi 0
  • tutte le 214 unita attive mappano su condomin 0021/0004 tramite legacy_cond_id = cod_cond
  • solo 210 mappano ancora su 0003, confermando che 0004 e il riferimento corrente corretto
  • nessuna unita attiva con interno = 0
  • i vecchi codici A/0, A/42, A/43, A/215, A/216 non sono piu attivi; restano solo come righe soft-deleted storiche

Bonifica recapiti rubrica 08/04/2026

• nuovo comando operativo: php artisan gescon:bonifica-rubrica-canali --stabile=<codice> --apply
• scopo:
  • separare email/PEC multiple salvate in un solo campo
  • separare telefoni multipli e classificarli in telefono o cellulare
  • popolare rubrica_contatti_canali per PBX, Google Contacts e UI rubrica
• verifica reale su 0021:
  • 192 rubriche analizzate
  • 133 rubriche aggiornate
  • 360 canali creati
  • caso ATER (rubrica_id=2151) riallineato con 5 email e 2 telefoni distinti

Piloti anagrafici aggiuntivi 08/04/2026

0002 - Carlo Alberto Racchia 2

• anno autorevole: 2024 (0038)
• unita: 61
• soggetti: 52
• diritti: 82 inseriti
• QA stabile_id=8: nessuna anomalia bloccante
• nota importante:
  • cod_cond 62 nello snapshot autorevole e un record comune (CONDOMINIO (magazzino)) senza scala/interno/sub/piano
  • non va trattato come buco dati dell'unita privata ma come voce comune priva di identificativo fisico utile alla UI unita

0013 - Ottaviano 105 / Giulio Cesare 171

• anno autorevole: 2026 (0015)
• inizialmente l'import unita falliva per overflow di codice_unita
• fix applicato: compattazione deterministica del codice entro il limite varchar(20)
• esito finale:
  • unita: 26 processate, 12 aggiornate
  • soggetti: 50
  • diritti: 90 inseriti, 3 aggiornati, 39 ignorati
  • QA stabile_id=16: nessuna anomalia bloccante
• da modellare a livello dominio/UI:
  • unita legacy spezzate per proprietari multipli ma fisicamente/catastalmente uniche
  • futura unione per dati catastali con riparto quote/millesimi separato

0023 - Germanico 79 (legacy 8)

• anno autorevole: 2025 (0096)
• unita: 27 processate, 16 aggiornate
• soggetti: 20
• diritti: 25 inseriti, 15 aggiornati, 2 ignorati
• QA stabile_id=24: nessuna anomalia bloccante

il primo file da importare è /home/michele/netgescon/docs/02-architettura-laravel/Gescon/cartellestabili_e_anni.mdb qui trovi le prime info per le varie gestioni e cartelle

il secondo file è /home/michele/netgescon/docs/02-architettura-laravel/Gescon/dbc/Stabili.mdb qui trovi le indicazioni di tutti gli stabili

e poi da li trovi tutti gli archivi che sono principalmente 2 dentro le cartelle /home/michele/netgescon/docs/02-architettura-laravel/Gescon/0021/generale_stabile_sf.mdb per le info generali e /home/michele/netgescon/docs/02-architettura-laravel/Gescon/0021/0001/singolo_anno.ldb per i dati di ogni singolo anno, naturlmente sono tutti collegati tra di loro in varie maniere

Trovi dentro la cartella /home/michele/netgescon/docs/02-architettura-laravel/Gescon e ti trovi dentro la cartella Gescon da dove importare i dati, Per la visualizzazione delle gestioni puoi utilizzare il riferimento che ti allego come immagine mettendo la visualizzazione anche del periodo che trovi dentro la cartella 0021 nel file GENERALE_STABILI.MDB nella tabella anni e poi i relativi campi sono semplici da trovare

la cartella che devi considerare per l'importazione è la mappatura dei campi per la successiava automazione del sistema d'importazione è in docs 000-IMPORT

La costruzione delle viste è dei menù devi utilizzare il manuale 90-UI-interfaccia-unica I manuali per i database è 91-database dove trovi anche le credenziali.

Ci sono alcuni campi che dobbiamo tenre in considerazione per l'im portazione primo va c