michele/netgescon-day0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
30b4f89a7b
netgescon-day0/docs/00-IMPORT/CHECKLIST-IMPORT.md

5.0 KiB
Executable File
Raw Blame History

✅ 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 ⏳

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 ⏳

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 ⏳

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 ⏳

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

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

# 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

# Controlla credenziali
cat .env | grep NETGESCON_

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

Errore: Validation Failed

# Dettagli errori
node validation-checker.js > errors.log
cat errors.log | grep ERROR

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

Errore: Duplicate Entry

# 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

# Backup database
mysqldump netgescon > backup_pre_import.sql

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

Rollback se Necessario

# 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