7.4 KiB
Executable File
7.4 KiB
Executable File
🔄 IMPORTAZIONE DATI GESCON LEGACY
Sistema Automatizzato Import Multi-Tenant
📅 Data: 07 Agosto 2025
🎯 Target: Stabile 148 "SUPERCONDOMINIO MILIZIE 3"
🛠️ TOOLS GIÀ INSTALLATI E OPERATIVI
✅ MDB-Tools Attivi
# Tools per lettura database Microsoft Access
/usr/bin/mdb-tables # Lista tabelle
/usr/bin/mdb-export # Esporta dati CSV
/usr/bin/mdb-schema # Schema database
/usr/bin/mdb-ver # Versione file
📊 Struttura Dati Identificata
🏢 File Principale: cartellestabili_e_anni.mdb
# Struttura scoperta:
id,cod_stabile,Descrizione_stabile,Tipo_riga,cod_stabile_visibile,Descrizione_stabile_visibile,Cartella_stabile,Anno,Cartella_anno,Cartella_stabile_visibile
# Stabile Target 148:
293099,148,"SUPERCONDOMINIO MILIZIE 3","1.Stabile","148","SUPERCONDOMINIO MILIZIE 3","0021","2024","0001","0021"
293100,148,"SUPERCONDOMINIO MILIZIE 3","2.Anno",,,"0021","2025","0003",
🗂️ Mapping Cartelle
- Stabile 148 → Cartella
0021 - Anno 2024 → Cartella
0001 - Anno 2025 → Cartella
0003
📅 Gestioni Anno: generale_stabile.mdb/anni
id_anno,anno_o,anno_r,nome_dir,ordinarie_dal,ordinarie_al,riscald_dal,riscald_al
1,"2024","2024-25","0001","01/01/24 00:00:00","12/31/24 00:00:00","11/01/24 00:00:00","04/30/25 00:00:00"
3,"2025","2025-26","0003","01/01/25 00:00:00","12/31/25 00:00:00","11/01/25 00:00:00","04/30/26 00:00:00"
📂 ARCHIVIO DATI DISPONIBILE
🗃️ Percorsi Base
/home/michele/netgescon/docs/02-architettura-laravel/Gescon/
├── cartellestabili_e_anni.mdb # Master index stabili
├── 0021/ # Stabile 148
│ ├── generale_stabile.mdb # Info base stabile
│ ├── 0001/ # Anno 2024
│ └── 0003/ # Anno 2025
├── 0008/ # Altri stabili...
├── 0009/
└── [altre cartelle stabili...]
🎯 Stabile 148 - Struttura Completa
0021/
├── generale_stabile.mdb # Database principale stabile
├── anni.csv # Export anni già fatto
├── 0001/ # Gestione 2024
│ ├── [files dati 2024]
├── 0003/ # Gestione 2025
│ ├── [files dati 2025]
├── Documenti/ # Documenti stabile
├── Allegati/ # File allegati
└── [altri file...]
🔄 FLUSSO IMPORTAZIONE CORRETTO
📋 Processo 3-Fasi Stabilito
1️⃣ FASE ESTRAZIONE (Sistema Esistente)
# Usa script esistente per estrazione stabile 148 (cartella 0021)
cd /home/michele/netgescon/docs/000-IMPORT/03-SCRIPTS
./extract-stabile-0021.sh
# Output in: docs/000-IMPORT/02-CSV-ESTRATTI/STABILE_0021/
2️⃣ FASE MAPPING (Sistema Esistente)
// Usa importer esistente con mapping configurato
node complete-mdb-importer.js --stabile 0021 --target GES00148 --admin 00000000
// Legge da: docs/000-IMPORT/02-MAPPING/campo-mapping.json
3️⃣ FASE IMPORT DATABASE STABILE (Nuovo)
# Import nel database dedicato del singolo stabile
# Target: netgescon_stabile_GES00148 (non database principale)
mysql netgescon_stabile_GES00148 << 'EOF'
-- Import dati estratti nel database dedicato stabile
-- Tabelle: condomini, unita, movimenti, rate, etc.
EOF
🎯 Architettura Import Corretta
GESCON Legacy DB (MDB Files)
↓
📊 Sistema Import Esistente (docs/000-IMPORT/)
├── extract-stabile-0021.sh # Estrazione CSV
├── campo-mapping.json # Mapping campi
└── complete-mdb-importer.js # Processamento
↓
💾 Database Stabile Dedicato
└── netgescon_stabile_GES00148
├── stabili_ref # Riferimento base
├── condomini # Anagrafica condomini (da 'condomin')
├── unita # Unità immobiliari
├── movimenti # Contabilità (da 'incassi', 'rate')
├── fornitori # Fornitori
└── documenti # Allegati
🚀 IMPLEMENTAZIONE IMMEDIATA
✅ STEP 1: Creazione Stabile NetGescon
# 1. Crea record nel database principale
mysql netgescon -e "
INSERT INTO stabili (codice_stabile, denominazione, indirizzo, cap, citta, provincia, amministratore_id, created_at, updated_at)
VALUES ('GES00148', 'SUPERCONDOMINIO MILIZIE 3', 'Viale delle Milizie 3', '00192', 'Roma', 'RM', 3, NOW(), NOW());"
# 2. Crea struttura filesystem e database
php artisan netgescon:create-stabile-structure 00000000 GES00148 --force
🗂️ Struttura Risultante
storage/app/amministratori/00000000/stabili/GES00148/
├── documenti/
│ ├── amministrative/
│ ├── assemblee/
│ ├── bilanci/2024/, bilanci/2025/
│ ├── comunicazioni/
│ └── [altre categorie...]
├── database/backups/
├── logs/sistema/
├── reports/
└── temp/
3️⃣ FASE 3: Import Dati Specifici
📊 Tabelle da Importare
# Database stabile generale_stabile.mdb contiene:
- anni # Periodi gestione
- acqua_dett # Dettagli acqua
- Fatture # Fatture
- Bonifici # Pagamenti
- [altre tabelle...]
🔄 Script Import Automatico
# Uso importer esistente in netgescon-importer/
python3 advanced_importer.py --stabile 148 --target GES00148 --admin 00000000
🎯 MENU GESCON IMPORT
🖥️ Interfaccia Controllo
Creare sezione dedicata nel menu admin per:
-
📊 Visualizzazione Dati Legacy
- Lista stabili importabili
- Anteprima dati per stabile
- Mappatura campi Gescon → NetGescon
-
🔄 Controllo Importazione
- Status import per stabile
- Verifica integrità dati
- Log operazioni import
-
🔍 Confronto Dati
- Vista side-by-side Gescon vs NetGescon
- Rilevamento differenze
- Validazione completezza
-
⚙️ Configurazione Import
- Mappatura personalizzata campi
- Filtri import selettivi
- Regole trasformazione dati
📋 PROSSIMI STEP OPERATIVI
✅ Immediate (Oggi)
- ✅ Analisi struttura dati Gescon completata
- 🔄 Creazione stabile GES00148 in NetGescon
- 🔄 Sviluppo script import specifico
- 🔄 Prima importazione dati base
📅 Breve Termine (Settimana)
- Import completo dati contabili 2024/2025
- Creazione menu "GESCON IMPORT"
- Validazione dati importati
- Testing funzionalità NetGescon con dati reali
🚀 Medio Termine (Mese)
- Automazione import altri stabili
- Sincronizzazione bidirezionale
- Interfaccia comparazione dati
- Sistema backup/restore integrato
🛡️ SICUREZZA E BACKUP
📦 Strategia Backup
- Dati Originali: Read-only in area sviluppo
- Import Incrementale: Solo nuove modifiche
- Rollback: Possibilità ripristino pre-import
- Validazione: Controlli integrità automatici
🔒 Accesso Controlli
- Import: Solo utenti admin autorizzati
- Visualizzazione: Accesso limitato per stabile
- Modifica: Logging completo operazioni
- Audit: Tracciabilità completa modifiche
🔄 SISTEMA IMPORTAZIONE PRONTO
🛠️ Tools installati e operativi
📊 Struttura dati mappata e compresa
🎯 Pronto per import stabile 148