227 lines
5.0 KiB
Markdown
227 lines
5.0 KiB
Markdown
# ✅ **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
|