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

📊 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

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

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:

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! 🚀