# 📋 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:**
```bash
# 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:**
```bash
# 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**

```bash
# 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! 🚀💰**