netgescon-day0/docs/00-IMPORT/01-GESCON/analisi-anni-mdb.md

154 lines
5.0 KiB
Markdown

# Analisi Completa Archivi Gescon - Struttura Anni e Database MDB
## 📊 File anni.csv - Gestioni Ordinarie e Riscaldamento
### Struttura Identificata:
```
Campo 1: id_anno (1, 3)
Campo 2: anno_o (2024, 2025) - Anno Ordinario
Campo 3: anno_r (2024-25, 2025-26) - Anno Riscaldamento
Campo 4: nome_dir (0001, 0003) - Codice Directory/Gestione
Campo 5-6: Selezione e descrizione (vuoti)
Campo 7: ordinarie_dal (01/01/24, 01/01/25) - Inizio Gestione Ordinaria
Campo 8: ordinarie_al (31/12/24, 31/12/25) - Fine Gestione Ordinaria
Campo 9: riscald_dal (01/11/24, 01/11/25) - Inizio Riscaldamento
Campo 10: riscald_al (30/04/25, 30/04/26) - Fine Riscaldamento
Campi 11-46: Descrizioni e importi fatture mensili (vuoti)
Campi 47-49: Voci compenso, IVA, RDA (vuoti)
```
### Significato Operativo:
- **Directory 0001**: Gestione 2024 (ordinaria + riscaldamento)
- **Directory 0003**: Gestione 2025 (ordinaria + riscaldamento)
- **Periodi separati**: Ordinaria (gen-dic) vs Riscaldamento (nov-apr)
## 🗄️ Database MDB generale_stabile.mdb
### Tabelle Principali Identificate:
#### **1. Tabelle Anagrafiche**
- `anni` - Configurazione gestioni annuali
- `770_ST` - Dati fiscali stabili
- `770_ST2` - Dati fiscali aggiuntivi
#### **2. Tabelle Fatturazione**
- `Fatture` - Fatture fornitori con dettaglio completo
- `Fatt_Multiple_E` - Fatture multiple emesse
- `Fatt_Multiple_dett` - Dettaglio fatture multiple
- `F24` - Modelli F24 per versamenti
#### **3. Tabelle Acqua/Utilities**
- `acqua_dett` - Dettaglio consumi acqua
- `acqua_dett_parz` - Consumi parziali
- `Acqua_Fatture` - Fatture acqua
- `acqua_gen` - Dati generali acqua
#### **4. Tabelle Comunicazioni**
- `Elenco_destinatari_email` - Email destinatari
- `Elenco_destinatari_PEC` - PEC destinatari
- `Elenco_destinatari_SMS` - SMS destinatari
- `Elenco_destinatari_Fax` - Fax destinatari
- `protoc_EMail`, `Protoc_PEC`, `Protoc_SMS` - Protocolli comunicazioni
#### **5. Tabelle Gestione**
- `Bonifici` - Bonifici bancari
- `emes_det`, `emes_gen` - Emissioni rate
- `Corrisp_inviata` - Corrispondenza inviata
- `Registro_Nomina_Revoca_Amm` - Registro amministratori
## 🎯 Mappatura per NetGescon
### Tabella `anni` → `anni_gestione`
```json
{
"csv_mapping": {
"id_anno": 0,
"anno_ordinario": 1,
"anno_riscaldamento": 2,
"codice_directory": 3,
"periodo_ordinario_inizio": 6,
"periodo_ordinario_fine": 7,
"periodo_riscaldamento_inizio": 8,
"periodo_riscaldamento_fine": 9
},
"netgescon_fields": {
"id": "id_anno",
"anno": "anno_ordinario",
"denominazione": "anno_riscaldamento",
"codice_gestione": "codice_directory",
"data_inizio_ordinaria": "periodo_ordinario_inizio",
"data_fine_ordinaria": "periodo_ordinario_fine",
"data_inizio_riscaldamento": "periodo_riscaldamento_inizio",
"data_fine_riscaldamento": "periodo_riscaldamento_fine"
}
}
```
### Tabella `Fatture` → `fatture_fornitori`
```json
{
"mdb_fields": {
"id_fatture": "ID univoco fattura",
"id_stabile": "Riferimento stabile",
"Cod_fornitore": "Codice fornitore",
"Data_fattura": "Data emissione",
"Data_pagamento": "Data pagamento",
"Num_fattura": "Numero fattura",
"Descrizione_sintetica": "Descrizione breve",
"Imponibile": "Importo imponibile",
"Importo_iva": "IVA",
"Totale_fattura": "Totale finale",
"id_anno": "Anno gestione"
}
}
```
## 🔧 Script di Importazione Automatica
### Strategia di Import:
1. **Analisi anni.csv** → Configurazione gestioni
2. **Lettura MDB** → Estrazione dati tabelle principali
3. **Mappatura dati** → Conversione verso NetGescon
4. **Validazione** → Controllo integrità referenziale
5. **Import MySQL** → Caricamento finale
### Comando per Estrazione Completa:
```bash
# Estrai tutte le tabelle in CSV
for table in $(mdb-tables generale_stabile.mdb); do
mdb-export generale_stabile.mdb "$table" > "${table}.csv"
done
```
## ✅ Prossimi Passi
1. **✅ Analizzare Stabili.csv** per mappatura condomini
2. **✅ Estrarre tabelle MDB** complete in CSV
3. **✅ Creare mapping dettagliato** per ogni tabella
4. **🔄 Completare mappatura JSON** per importazione Windows
5. **🔄 Validare dati** con controlli di integrità
## 🎯 **RISULTATI ESTRAZIONE STABILE 0021**
**Volume dati identificato:**
- **Condomini 2024**: 225 unità immobiliari
- **Condomini 2025**: 229 unità immobiliari
- **Rate 2024**: 4.769 rate emesse
- **Rate 2025**: 2.917 rate emesse
- **Incassi 2024**: 439 pagamenti
- **Incassi 2025**: 64 pagamenti
- **Fatture totali**: 28 fornitori
- **Comunicazioni**: 2.954 destinatari email/PEC
**Riconciliazione bancaria pronta per NetGescon**:
- Rate emesse vs incassi ricevuti
- Tracciabilità completa pagamenti
- Sistema codici univoci per matching
La struttura mostra un sistema completo di gestione condominiale con:
- **Gestioni separate** per ordinaria e riscaldamento
- **Archivi organizzati** per directory/anno
- **Tracciabilità completa** di fatture e pagamenti
- **Sistema comunicazioni** multi-canale integrato
- **Riconciliazione bancaria** automatica pronta