netgescon-day0/docs/00-MASTER-DOCS-UNIFICATI/04-TROUBLESHOOTING/README.md

🔧 TROUBLESHOOTING - NetGescon

Risoluzione Problemi e Debug

📋 CONTENUTI CATEGORIA:

🚨 PROBLEMI INTERFACCIA E LAYOUT

• Tabs non funzionanti
• Sub-tabs non visibili
• Layout CSS rotto
• JavaScript errors

🗄️ ERRORI DATABASE E MIGRAZIONI

• RECOVERY-GUIDE.md - ⭐ GUIDA RECOVERY
• Migrazioni fallite
• Relazioni non caricate
• Performance query lente

💻 PROBLEMI FRONTEND

• Tailwind CSS non compilato
• Vite build errors
• Assets non caricati
• JavaScript runtime errors

🐘 ERRORI LARAVEL E PHP

• Controller errors
• Model relationships
• Routing issues
• Permission denied

---

🚨 PROBLEMI COMUNI E SOLUZIONI

1. Tabs Tabelle Millesimali Vuoti

// PROBLEMA: Dati non visibili
// SOLUZIONE: Eager loading nel controller
$stabile->load([
    'tabelleMillesimali' => function($query) {
        $query->orderBy('ordinamento')->orderBy('nome_tabella');
    },
    'vociSpesa' => function($query) {
        $query->orderBy('ordinamento')->orderBy('descrizione');
    }
]);

2. Errore SQL Column ordinamento

# PROBLEMA: Column 'ordinamento' doesn't exist
# SOLUZIONE: Creare migrazione
php artisan make:migration add_ordinamento_to_tables

3. Layout CSS non applicato

# PROBLEMA: Styles non caricati
# SOLUZIONE: Build assets
npm run build
php artisan view:clear

4. Permessi di accesso

# PROBLEMA: Permission denied
# SOLUZIONE: Fix ownership
sudo chown -R www-data:www-data /var/www/netgescon
sudo chmod -R 755 /var/www/netgescon

---

🔍 DEBUGGING WORKFLOW

1. Check Logs:

# Laravel Logs
tail -f /var/www/netgescon/storage/logs/laravel.log

# Apache Logs  
tail -f /var/log/apache2/error.log

2. Database Debug:

-- Check data exists
SELECT COUNT(*) FROM tabelle_millesimali WHERE stabile_id = 1;
SELECT COUNT(*) FROM voci_spesa WHERE stabile_id = 1;

3. Clear All Caches:

cd /var/www/netgescon
php artisan view:clear
php artisan route:clear
php artisan config:clear
php artisan cache:clear

---

🛠️ STRUMENTI DEBUG

Laravel Debug:

• dd() - Dump and die
• Log::info() - Debug logging
• DB::enableQueryLog() - SQL queries
• php artisan tinker - Interactive shell

Browser Debug:

• F12 Developer Tools
• Console JavaScript errors
• Network tab for API calls
• Elements tab for CSS issues

---

📊 CHECKLIST RISOLUZIONE

✅ PRE-DEBUG:

• Check Laravel .env configuration
• Verify database connection
• Confirm file permissions
• Check Apache/PHP errors

🔍 DEBUGGING:

• Enable Laravel debug mode
• Check controller loading
• Verify model relationships
• Test database queries

✅ POST-FIX:

• Clear all caches
• Test functionality
• Verify performance
• Update documentation

---

📅 ULTIMO AGGIORNAMENTO: 28 Luglio 2025
🎯 STATUS: TROUBLESHOOTING ATTIVO