# 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