netgescon-master/docs/11-CHECKLIST-IMPLEMENTAZIONE-CONTABILITA.md

📋 CHECKLIST OPERATIVA - IMPLEMENTAZIONE CONTABILITÀ AVANZATA

🎯 OBIETTIVO

Implementare sistema contabile in partita doppia con gestioni multiple (ORDINARIA, RISCALDAMENTO, STRAORDINARIA) e ritenute d'acconto, integrato con chiusura/riapertura contabile classica.

---

📤 FASE 1: TRASFERIMENTO DOCUMENTAZIONE

✅ Azioni da completare:

• Eseguire script transfer-docs-contabilita.sh
• Verificare presenza file sulla VM
• Aprire VS Code sulla VM con documentazione

🔧 Comandi:

# Su Windows
./scripts/transfer-docs-contabilita.sh

# Sulla VM
cd /var/www/netgescon
ls -la docs/
code docs/10-IMPLEMENTAZIONE-CONTABILITA-PARTITA-DOPPIA-GESTIONI.md

---

💾 FASE 2: IMPLEMENTAZIONE DATABASE

✅ Migration da creare:

• 2025_07_24_120000_add_gestioni_multiple_to_existing_tables.php
• 2025_07_24_120001_create_ripartizioni_gestioni_table.php
• 2025_07_24_120002_create_chiusure_riaperture_contabili_table.php

🔧 Comandi Laravel:

# Sulla VM
cd /var/www/netgescon
php artisan make:migration add_gestioni_multiple_to_existing_tables
php artisan make:migration create_ripartizioni_gestioni_table
php artisan make:migration create_chiusure_riaperture_contabili_table
php artisan migrate

---

🎨 FASE 3: IMPLEMENTAZIONE BACKEND

✅ Models da aggiornare/creare:

• Aggiornare GestioneContabile.php
• Aggiornare RegistrazioneContabile.php
• Creare RipartizioneGestione.php
• Creare ChiusuraRiaperturaContabile.php

✅ Controller da creare:

• ContabilitaAvanzataController.php
• Metodi: creaRegistrazione(), chiusuraGestione(), riaperturaGestione()

✅ Services da creare:

• ContabilitaService.php (logica calcoli)
• RipartizioneService.php (ripartizioni gestioni)
• ChiusuraContabileService.php (chiusura/riapertura)

---

🖥️ FASE 4: IMPLEMENTAZIONE FRONTEND

✅ Views da creare:

• resources/views/admin/contabilita/registrazione-avanzata.blade.php
• resources/views/admin/contabilita/gestioni-multiple.blade.php
• resources/views/admin/contabilita/chiusura-gestione.blade.php

✅ JavaScript da creare:

• public/js/contabilita-avanzata.js
• Funzioni: calcolo totali, verifica quadratura, ripartizioni
• Integrazione con form dinamici

✅ CSS da aggiornare:

• Stili per gestioni multiple (colori, icone)
• Layout per sezione ritenute
• Responsive design tabelle

---

🔗 FASE 5: INTEGRAZIONE SISTEMA ESISTENTE

✅ Route da aggiungere:

• Route gruppo /admin/contabilita-avanzata
• Route API per calcoli in tempo reale
• Route per export/import dati

✅ Middleware da configurare:

• Autorizzazioni per gestioni multiple
• Validazione accesso amministratori
• Rate limiting per API calcoli

---

🧪 FASE 6: TEST E VALIDAZIONE

✅ Test da eseguire:

• Test inserimento registrazione con gestioni multiple
• Test calcolo ripartizioni automatiche
• Test quadratura partita doppia
• Test chiusura/riapertura gestione
• Test integrazione con dati esistenti

✅ Validazioni:

• Controllo somma percentuali gestioni = 100%
• Verifica DARE = AVERE sempre
• Controllo calcoli ritenute d'acconto
• Validazione saldi apertura/chiusura

---

📊 FASE 7: IMPORTAZIONE DATI REALI

✅ Preparazione dati:

• Export dati da vecchio sistema
• Mapping campi vecchio → nuovo sistema
• Script importazione con validazioni
• Test con subset dati reali

✅ Sincronizzazione:

• Script sincronizzazione periodica
• Controllo integrità dati
• Log operazioni per audit
• Backup automatico prima import

---

🚀 CRONOGRAMA IMPLEMENTAZIONE

Settimana 1:

• ✅ Trasferimento documentazione
• ✅ Implementazione database (migration)
• ✅ Aggiornamento Models base

Settimana 2:

• ✅ Sviluppo Controller e Services
• ✅ Implementazione logica calcoli
• ✅ Test backend con API

Settimana 3:

• ✅ Sviluppo interfaccia utente
• ✅ Integrazione frontend-backend
• ✅ Test end-to-end

Settimana 4:

• ✅ Importazione dati reali
• ✅ Test con beta-tester
• ✅ Ottimizzazioni e fix

---

🔧 COMANDI RAPIDI

# SETUP INIZIALE VM
cd /var/www/netgescon
git pull origin main
composer install
npm install

# CREAZIONE MIGRATION
php artisan make:migration add_gestioni_multiple_to_existing_tables
php artisan make:model RipartizioneGestione
php artisan make:controller Admin/ContabilitaAvanzataController

# TEST DATABASE
php artisan migrate:status
php artisan migrate --pretend
php artisan migrate

# CACHE CLEAR
php artisan config:clear
php artisan cache:clear
php artisan route:clear

# AVVIO SERVIZI
php artisan serve --host=0.0.0.0 --port=8000
npm run dev

---

📞 CONTATTI E SUPPORTO

• Documentazione: /var/www/netgescon/docs/
• Log Laravel: storage/logs/laravel.log
• Database: MySQL netgescon_user:NetGescon2024!
• Backup: Prima di ogni modifica importante

---

🎯 NOTE OPERATIVE

1. 🔒 SICUREZZA: Sempre backup database prima modifiche strutturali
2. 📊 PERFORMANCE: Indici su campi più utilizzati (gestione_id, tipo_gestione)
3. 🔍 DEBUG: Utilizzare php artisan tinker per test rapidi
4. 📝 LOG: Loggare tutte le operazioni contabili per audit
5. ⚡ CACHE: Invalidare cache dopo modifiche strutturali

Pronto per l'implementazione! 🚀💰