# ✅ **CHECKLIST IMPORT NETGESCON**

## 🎯 **PRE-IMPORT SETUP**

### **1. Ambiente di Sviluppo**
- [ ] Server Laravel NetGescon attivo (http://localhost:8000)
- [ ] Database MySQL configurato e aggiornato
- [ ] API endpoint `/api/v1/import/*` funzionanti
- [ ] Node.js installato (>= 14.0.0)
- [ ] Dipendenza axios installata (`npm install axios`)

### **2. Configurazione Script**
- [ ] File `.env` creato in `03-SCRIPTS/` 
- [ ] Credenziali API configurate correttamente
- [ ] Permessi file script eseguibili
- [ ] Log directory scrivibile

### **3. Dati Preparati**
- [ ] `amministratori.json` - 1 amministratore attivo (Tordini)
- [ ] `stabili.json` - 7 stabili con dati bancari completi
- [ ] `campo-mapping.json` - Mapping campi verificato
- [ ] Validazione preliminare superata

---

## 🚀 **ESECUZIONE IMPORT**

### **STEP 1: Validazione Locale** ⏳
```bash
cd docs/000-IMPORT/03-SCRIPTS/
node validation-checker.js
```

**Controlli:**
- [ ] Codici fiscali formato corretto
- [ ] Email amministratore valida
- [ ] IBAN stabili formato corretto
- [ ] CAP e province italiane valide
- [ ] Riferimenti amministratore-stabili corretti

**Risultato Atteso:** ✅ Validation PASSED

---

### **STEP 2: Test API Connection** ⏳
```bash
node import-runner.js --validate-only
```

**Controlli:**
- [ ] Login API NetGescon riuscito
- [ ] Token authentication ottenuto
- [ ] Endpoint import raggiungibili
- [ ] Validazione API remota superata

**Risultato Atteso:** ✅ API Connection OK

---

### **STEP 3: Import Amministratore** ⏳
```bash
node import-runner.js --step=admin
```

**Operazioni:**
- [ ] Creazione utente Cecilia Tordini
- [ ] Assegnazione ruolo "amministratore"  
- [ ] Generazione password temporanea
- [ ] Creazione record amministratore
- [ ] Collegamento utente-amministratore

**Risultato Atteso:** ✅ 1 amministratore importato

---

### **STEP 4: Import Stabili** ⏳
```bash
node import-runner.js --step=stabili
```

**Operazioni:**
- [ ] Import 7 stabili con dati completi
- [ ] Collegamento a amministratore Tordini
- [ ] Configurazione dati bancari (IBAN)
- [ ] Mappatura comuni italiani
- [ ] Validazione codici fiscali stabili

**Risultato Atteso:** ✅ 7 stabili importati

---

## 📊 **VERIFICA POST-IMPORT**

### **Database Check**
```sql
-- Verifica amministratori
SELECT * FROM users WHERE tipo_utente = 'amministratore';
SELECT * FROM amministratori;

-- Verifica stabili
SELECT s.*, a.denominazione as admin_nome 
FROM stabili s 
JOIN amministratori a ON s.amministratore_id = a.user_id;

-- Conta record
SELECT 
  (SELECT COUNT(*) FROM users WHERE tipo_utente = 'amministratore') as amministratori,
  (SELECT COUNT(*) FROM stabili) as stabili;
```

### **Controlli Funzionali**
- [ ] Login amministratore via web interface
- [ ] Visualizzazione lista stabili
- [ ] Accesso dettaglio singolo stabile
- [ ] Modifica dati stabile
- [ ] Visualizzazione dati bancari

---

## 🔍 **TROUBLESHOOTING**

### **Errore: Connection Refused**
```bash
# Verifica server Laravel
php artisan serve --host=0.0.0.0 --port=8000

# Test manuale API
curl http://localhost:8000/api/v1/auth/login
```

### **Errore: Authentication Failed**
```bash
# Controlla credenziali
cat .env | grep NETGESCON_

# Verifica utente admin esiste
php artisan db:seed --class=UserSeeder
```

### **Errore: Validation Failed**
```bash
# Dettagli errori
node validation-checker.js > errors.log
cat errors.log | grep ERROR

# Fix dati manualmente
nano ../01-GESCON/amministratori.json
```

### **Errore: Duplicate Entry**
```bash
# Reset tabelle se necessario
php artisan migrate:refresh --seed
```

---

## 📈 **STATISTICHE ATTESE**

### **Dati Import**
- **Amministratori**: 1 (Cecilia Tordini)
- **Stabili**: 7 con 336 unità totali
- **IBAN Configurati**: 7 (5 banche diverse)
- **Tempo Stimato**: ~30 secondi

### **Banche Gestite**
- POSTE ITALIANE (2 stabili)
- ISTITUTO SAN PAOLO (1 stabile)
- BANCO BPM (1 stabile)
- Banca del Fucino (1 stabile)
- INTESA SAN PAOLO (1 stabile)
- MONTE PASCHI DI SIENA (1 stabile)

---

## 🎯 **NEXT STEPS POST-IMPORT**

### **Immediati**
- [ ] Cambio password amministratore default
- [ ] Configurazione PEC stabili
- [ ] Test invio comunicazioni
- [ ] Verifica stampe documenti

### **Successivi**
- [ ] Import unità immobiliari per ogni stabile
- [ ] Import anagrafica condomini/proprietari
- [ ] Import movimenti contabili storici
- [ ] Configurazione automazioni

---

## 🔒 **BACKUP & RECOVERY**

### **Prima dell'Import**
```bash
# Backup database
mysqldump netgescon > backup_pre_import.sql

# Backup files
tar -czf backup_files.tar.gz storage/app
```

### **Rollback se Necessario**
```bash
# Restore database
mysql netgescon < backup_pre_import.sql

# Re-run migrations
php artisan migrate:refresh --seed
```

---

## ✅ **COMPLETAMENTO**

Una volta completati tutti gli step:

- [ ] Import amministratore ✅
- [ ] Import stabili ✅  
- [ ] Verifica database ✅
- [ ] Test login web ✅
- [ ] Funzionalità base operative ✅

**🎉 IMPORT COMPLETATO CON SUCCESSO!**

**Prossimo:** Import unità immobiliari e condomini