153 lines
4.2 KiB
Markdown
Executable File
153 lines
4.2 KiB
Markdown
Executable File
# 📊 **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!** 🚀
|