netgescon-day0/docs/00-IMPORT/01-GESCON/ARCHITETTURA-COMPLETA-GESCON.md

170 lines
5.8 KiB
Markdown

# ARCHITETTURA COMPLETA GESCON - Mappatura per NetGescon
## 📊 **STRUTTURA GESCON IDENTIFICATA**
### **🏗️ Architettura Database:**
```
GESCON/
├── dbc/ # DATABASE CENTRALI
│ ├── Stabili.mdb # Anagrafica condomini (MASTER)
│ └── Fornitori.mdb # Anagrafica fornitori (MASTER)
├── [CODICE_STABILE]/ # DIRECTORY SPECIFICHE PER STABILE
│ ├── generale_stabile.mdb # Fatture, comunicazioni, F24
│ ├── [ANNO_DIR]/ # Sottodirectory per anno gestione
│ │ └── singolo_anno.mdb # Rate, incassi, assemblee, bilanci
│ └── Documenti/
│ └── documenti.mdb # Allegati e documenti
├── parti_comuni.mdb # Parti comuni condominiali
├── proposte.mdb # Proposte assemblee
└── ravv.mdb # Ravvedimenti e sanzioni
```
## 🎯 **FILE PRINCIPALI IDENTIFICATI**
### **1. Stabili.csv - 14 condomini**
🏢 **ANAGRAFICA CONDOMINI COMPLETA**
**Campi principali identificati (150+ campi):**
```
Campo 1: id_interno Campo 2: cod_stabile (908, 909, 912, etc.)
Campo 3: denominazione Campo 4: indirizzo
Campo 5: cap Campo 6: citta
Campo 7: provincia Campo 8: codice_fiscale_cond
Campo 9: cf_amministratore Campo 10: scale
Campo 11: n_interni Campo 12: codice_directory (0002, 0008, etc.)
Campo 13-36: flags gestione Campo 37: intestazione_stampe
Campo 38: flag_attivo Campo 39: codice_conto_bancario
Campo 40: denominazione_banca Campo 41: autorizzazione
Campo 42-45: coordinate bancarie Campo 46: numero_conto
Campo 47: denominazione_conto Campo 48-52: coordinate postali
Campo 53: ccp_descrizione Campo 54-58: coordinate intesa
Campo 59-63: dati_amministratore Campo 64-68: residenza_amministratore
Campo 69-79: comunicazioni Campo 80: indirizzo_corrispondenza
Campo 81: iban_principale Campo 82-147: dati_aggiuntivi
Campo 148: data_ultima_modifica Campo 149: flag_backup
```
### **2. Database per Stabile 0021 (Racchia 2)**
#### **A. generale_stabile.mdb - Gestione Generale**
-**Già analizzato**: 16 tabelle, 10K+ record
- **Fatture**: 28 fatture fornitori
- **Rate emesse**: 7.122 rate dettaglio
- **Comunicazioni**: 2.954 destinatari email/PEC
- **F24**: 20 versamenti fiscali
#### **B. 0001/singolo_anno.mdb - Anno 2024**
- **53 tabelle** per gestione completa anno
- **Tabelle principali**:
- `condomin`: Anagrafica condomini dello stabile
- `rate`: Rate emesse nell'anno
- `incassi`: Pagamenti ricevuti
- `Assemblee`: Verbali e delibere
- `rendite_condominiali`: Bilanci
- `Detrazioni_fiscali`: Gestione fiscale
- `foglio_riscossioni`: Riconciliazione bancaria
#### **C. 0003/singolo_anno.mdb - Anno 2025**
- **Struttura identica** a 2024
- **53 tabelle** per nuovo anno gestione
## 🔄 **MAPPATURA COMPLETA PER NETGESCON**
### **Step 1: Anagrafica Base**
```
dbc/Stabili.mdb → netgescon.stabili
dbc/Fornitori.mdb → netgescon.fornitori
```
### **Step 2: Configurazione Gestioni**
```
*/anni.csv → netgescon.anni_gestione
```
### **Step 3: Gestione per Stabile**
```
[COD]/generale_stabile.mdb:
├── Fatture → netgescon.fatture_fornitori
├── emes_gen → netgescon.emissioni_rate
├── emes_det → netgescon.rate_dettaglio
├── F24 → netgescon.versamenti_fiscali
├── Elenco_destinatari_* → netgescon.comunicazioni
└── Corrisp_inviata → netgescon.corrispondenza
```
### **Step 4: Gestione Annuale**
```
[COD]/[ANNO]/singolo_anno.mdb:
├── condomin → netgescon.condomini_stabile
├── rate → netgescon.rate_annuali
├── incassi → netgescon.incassi_pagamenti
├── Assemblee → netgescon.assemblee_verbali
├── rendite_condominiali → netgescon.bilanci_rendiconti
├── Detrazioni_fiscali → netgescon.detrazioni_fiscali
└── foglio_riscossioni → netgescon.riconciliazione_bancaria
```
## 📈 **VOLUME DATI STIMATO**
### **Stabile 0021 (Esempio):**
- **Condomini**: ~60-70 unità
- **Rate emesse**: 7.122 record
- **Fatture**: 28 fornitori
- **Incassi**: Migliaia di pagamenti
- **Comunicazioni**: 2.954 destinatari
### **Sistema Completo (14 stabili):**
- **Volume totale stimato**: 100K+ record
- **Rate/Incassi**: 50K+ transazioni
- **Fatture**: 500+ fatture
- **Comunicazioni**: 20K+ invii
## 🎯 **PRIORITÀ IMPORTAZIONE**
### **Fase 1: Infrastruttura** ⭐⭐⭐
1. Stabili.csv → Anagrafica condomini completa
2. dbc/Fornitori.mdb → Fornitori centralizzati
3. */anni.csv → Configurazione gestioni
### **Fase 2: Dati Operativi** ⭐⭐
4. generale_stabile.mdb → Fatture e comunicazioni
5. singolo_anno.mdb/rate → Sistema rate
6. singolo_anno.mdb/incassi → Pagamenti e riconciliazione
### **Fase 3: Gestione Avanzata** ⭐
7. Assemblee e delibere
8. Bilanci e rendiconti
9. Detrazioni fiscali
10. Documenti allegati
## 🔧 **STRATEGIA ANTI-DUPLICAZIONE**
### **Controlli Univocità:**
- **Stabili**: `cod_stabile` + `codice_directory`
- **Fornitori**: `cod_forn` + `codice_fiscale`
- **Rate**: `n_emissione` + `cod_cond` + `anno`
- **Incassi**: `data_pagamento` + `importo` + `riferimento`
### **Tabelle Temporanee:**
```sql
CREATE TABLE import_log (
tabella VARCHAR(50),
record_id INT,
data_import TIMESTAMP,
status ENUM('pending', 'imported', 'duplicate', 'error')
);
```
## ✅ **FASI SUCCESSIVE**
1. **Completare mappatura Stabili.csv** (150 campi)
2. **Analizzare condomin table** per anagrafica unità
3. **Mappare rate/incassi** per riconciliazione bancaria
4. **Creare script import sequenziale** con controlli
5. **Testare su stabile 0021** prima di import globale
La struttura GESCON è **estremamente completa** e pronta per migrazione totale verso NetGescon!