# 📊 **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!** 🚀