# 🔄 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**