248 lines
7.4 KiB
Markdown
248 lines
7.4 KiB
Markdown
# 🔄 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**
|
||
```bash
|
||
# 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`
|
||
```csv
|
||
# 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`
|
||
```csv
|
||
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)
|
||
```bash
|
||
# 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)
|
||
```javascript
|
||
// 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)
|
||
```bash
|
||
# 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**
|
||
```bash
|
||
# 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**
|
||
```bash
|
||
# Database stabile generale_stabile.mdb contiene:
|
||
- anni # Periodi gestione
|
||
- acqua_dett # Dettagli acqua
|
||
- Fatture # Fatture
|
||
- Bonifici # Pagamenti
|
||
- [altre tabelle...]
|
||
```
|
||
|
||
#### 🔄 **Script Import Automatico**
|
||
```python
|
||
# 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:
|
||
|
||
1. **📊 Visualizzazione Dati Legacy**
|
||
- Lista stabili importabili
|
||
- Anteprima dati per stabile
|
||
- Mappatura campi Gescon → NetGescon
|
||
|
||
2. **🔄 Controllo Importazione**
|
||
- Status import per stabile
|
||
- Verifica integrità dati
|
||
- Log operazioni import
|
||
|
||
3. **🔍 Confronto Dati**
|
||
- Vista side-by-side Gescon vs NetGescon
|
||
- Rilevamento differenze
|
||
- Validazione completezza
|
||
|
||
4. **⚙️ Configurazione Import**
|
||
- Mappatura personalizzata campi
|
||
- Filtri import selettivi
|
||
- Regole trasformazione dati
|
||
|
||
---
|
||
|
||
## 📋 **PROSSIMI STEP OPERATIVI**
|
||
|
||
### ✅ **Immediate (Oggi)**
|
||
1. ✅ Analisi struttura dati Gescon completata
|
||
2. 🔄 Creazione stabile GES00148 in NetGescon
|
||
3. 🔄 Sviluppo script import specifico
|
||
4. 🔄 Prima importazione dati base
|
||
|
||
### 📅 **Breve Termine (Settimana)**
|
||
1. Import completo dati contabili 2024/2025
|
||
2. Creazione menu "GESCON IMPORT"
|
||
3. Validazione dati importati
|
||
4. Testing funzionalità NetGescon con dati reali
|
||
|
||
### 🚀 **Medio Termine (Mese)**
|
||
1. Automazione import altri stabili
|
||
2. Sincronizzazione bidirezionale
|
||
3. Interfaccia comparazione dati
|
||
4. 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**
|