netgescon-day0/docs/GUIDA-IMPORT-DATI-REALI.md

153 lines
4.2 KiB
Markdown

# 📊 **GUIDA IMPORT DATI DAL VECCHIO PROGRAMMA**
## 🎯 **PANORAMICA**
Questa guida spiega come importare i dati dal tuo vecchio programma di gestione condominiale nel nuovo sistema NetGescon usando le API specifiche che ho analizzato dai tuoi file CSV e XML.
---
## 📁 **FORMATI SUPPORTATI**
### ✅ **PREFERITO: Formato CSV**
- Più leggibile e processabile
- Migliore per importazioni bulk
- Validazione più semplice
### 🔄 **ALTERNATIVO: Formato XML**
- Supportato per compatibilità
- Più verboso ma strutturato
---
## 👥 **DATI AMMINISTRATORI ESTRATTI**
Dal tuo CSV ho identificato **3 amministratori**:
### 🟢 **ATTIVO: Cecilia Tordini**
- **Codice**: TRDCCL74T52H501R
- **Email**: amm.condominialiroma@gmail.com
- **PEC**: cecilia.tordini@legalmail.it
- **Telefono**: 351 771 7626
- **Indirizzo**: Via Famagosta 6, 00192 ROMA
- **Gestisce**: Tutti i condomini attivi
### 🟡 **STORICO: Ignazio Vittorio Conforti**
- **Codice**: CNFGZV34E05E914T
- **Email**: ignaziovittorio.conforti@tin.it
- **PEC**: conforti.iv@pec.it
- **Telefono**: 335295285
- **Indirizzo**: Via Ottaviano 32, 00192 ROMA
### 🔴 **BACKUP: Michele Barone**
- **Codice**: BRNMHL69M11H501K
- **Indirizzo**: Viale delle Milizie 9a, 00192 ROMA
---
## 🏢 **DATI STABILI ESTRATTI**
Ho identificato **7 stabili attivi** con dati bancari completi:
| Codice | Denominazione | Codice Fiscale | IBAN | Banca |
|--------|---------------|----------------|------|-------|
| 908 | CARLO ALBERTO RACCHIA 2 | 80178220580 | IT97N0760103200000081932006 | POSTE ITALIANE |
| 13 | CATONE 34 - GERMANICO 85 - GRACCHI 32 | 80017140585 | IT26Z0306905077100000013753 | ISTITUTO SAN PAOLO |
| 17 | OTTAVIANO 105 - GIULIO CESARE 171 | 80212560587 | IT88A0503403214000000000707 | BANCO BPM |
| 145 | GERMANICO 96 | 80115200588 | IT09D0760103200000052670007 | Banca del Fucino |
| 146 | ANDREA DORIA 36 | 96194920581 | IT68K0306903388100000010425 | INTESA SAN PAOLO |
| 18 | GRACCHI 6 | 96002880589 | IT33X0760103200000094248804 | POSTE ITALIANE |
| 8 | GERMANICO 79 | 96063530586 | IT47O0103003203000063140165 | MONTE PASCHI DI SIENA |
---
## 🚀 **PROCESSO DI IMPORT**
### **Passo 1: Import Amministratori**
```bash
curl -X POST http://localhost:8000/api/v1/import/amministratori \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d @IMPORT-ESEMPIO-AMMINISTRATORI.csv
```
### **Passo 2: Import Stabili**
```bash
curl -X POST http://localhost:8000/api/v1/import/stabili \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d @IMPORT-ESEMPIO-STABILI.csv
```
---
## ✅ **VALIDAZIONE PRELIMINARE**
Prima dell'import definitivo, puoi validare i dati:
```bash
curl -X POST http://localhost:8000/api/v1/import/amministratori \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{"validate_only": true, "amministratori": [...]}'
```
---
## 🔧 **MAPPING CAMPI IDENTIFICATI**
### **Dal CSV al Database NetGescon:**
#### 📋 **Amministratori**
- `cf_amministratore``codice_amministratore` (primi 8 caratteri)
- `denominazione``denominazione`
- `email``email`
- `pec``pec`
- `telefono``telefono`
#### 🏠 **Stabili**
- `cod_stabile``cod_stabile_old` (riferimento legacy)
- `denominazione``denominazione`
- `indirizzo``indirizzo`
- `codice_fisc``codice_fiscale`
- `iban_bancario``iban_bancario`
- `num_condomini``num_condomini`
---
## 📈 **STATISTICHE DATI**
### **Amministratori:**
- Totale: 3
- Attivi: 2 (Tordini + Conforti)
- Inattivi: 1 (Barone)
### **Stabili:**
- Totale: 7 stabili
- Con IBAN: 7 (100%)
- Banche diverse: 5
- Condomini totali: ~350
- Scale totali: ~12
---
## 🎯 **PROSSIMI PASSI**
1. **Conferma la struttura dati** - I file CSV di esempio sono pronti
2. **Testa l'import** con `validate_only: true`
3. **Import amministratori** (prima gli admin)
4. **Import stabili** (poi gli stabili collegati)
5. **Verifica dati** importati nel database
---
## 📞 **SUPPORTO**
- **Formato preferito**: CSV (già preparato)
- **API pronte**: Endpoint di import configurati
- **Validazione**: Sistema di controllo errori integrato
- **Rollback**: Transazioni protette per sicurezza
**Il sistema è pronto per importare i tuoi dati reali!** 🚀