netgescon-day0/docs/sviluppo/stabili_import.md

111 lines
6.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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