netgescon-day0/docs/00-MASTER-DOCS-UNIFICATI/03-MANUALI-OPERATIVI/INSTALLATION.md

🔧 Installazione Sistema Debug NetGescon

📋 Prerequisiti

Software Richiesto

• PHP: 8.2+
• Laravel: 11+
• Node.js: 18+ (per asset)
• Composer: 2.0+

Permessi Sistema

# Verifica permessi storage
chmod -R 775 storage/
chmod -R 775 bootstrap/cache/

# Verifica proprietario
chown -R www-data:www-data storage/
chown -R www-data:www-data bootstrap/cache/

---

🚀 Installazione

1. File già presenti

I file del sistema debug sono già installati in:

app/Debug/               # Sistema completo
resources/views/admin/debug/  # Dashboard  
docs/debug/              # Documentazione

2. Verifica Service Provider

Il DebugServiceProvider è registrato in bootstrap/providers.php:

return [
    App\Providers\AppServiceProvider::class,
    App\Debug\DebugServiceProvider::class,  // ✅ Presente
];

3. Verifica Route

Le route debug sono in routes/web.php:

// Sistema Debug
Route::prefix('debug')->name('debug.')->group(function () {
    Route::get('/', [App\Debug\Controllers\SystemDebugController::class, 'index'])
        ->name('index');
    // ... altre route
});

4. Test Comandi

# Verifica comandi disponibili
php artisan list | grep netgescon

# Output atteso:
# netgescon:debug         Sistema di debug avanzato
# netgescon:find-duplicates  Trova e gestisce view duplicate

---

🧪 Test Installazione

1. Test Console

# Test base
php artisan netgescon:debug --help

# Test scansione veloce
php artisan netgescon:debug --duplicates

2. Test Dashboard Web

# Avvia server
php artisan serve

# Visita dashboard  
# http://localhost:8000/admin/debug

3. Test Permessi

# Test scrittura log
php artisan netgescon:debug --report

# Verifica file creato
ls -la storage/logs/netgescon_debug_*.json

---

⚙️ Configurazione

1. Variabili Ambiente

Aggiungi a .env:

# Debug avanzato
DEBUG_SYSTEM_ENABLED=true
DEBUG_AUTO_CLEAN=false
DEBUG_BACKUP_KEEP_DAYS=30

2. Configurazione Laravel

In config/app.php:

'debug' => env('APP_DEBUG', false),  // Prod: false
'log_level' => env('LOG_LEVEL', 'debug'),

3. Personalizzazione Path

Se usi directory personalizzate, modifica in SystemAnalyzer.php:

protected $directories = [
    'resources/views' => 'active',
    'tua-directory-backup' => 'backup',  // Personalizza
];

---

🔐 Sicurezza

1. Protezione Route

Le route debug sono già protette:

Route::middleware(['role:admin|amministratore'])
    ->prefix('admin')
    ->group(function () {
        // Route debug qui
    });

2. Backup Directory

# Crea directory backup sicura
mkdir -p _DUPLICATES_MOVED/
chmod 750 _DUPLICATES_MOVED/
chown -R www-data:www-data _DUPLICATES_MOVED/

3. Log Rotation

Configura in /etc/logrotate.d/netgescon:

/var/www/netgescon/storage/logs/*.log {
    daily
    rotate 30
    compress
    delaycompress
    missingok
    notifempty
    create 644 www-data www-data
}

---

🚨 Troubleshooting Installazione

Errore: "Class not found"

# Rigenera autoload  
composer dump-autoload

# Clear cache
php artisan config:clear
php artisan cache:clear

Errore: "Route not defined"

# Verifica route esistenti
php artisan route:list | grep debug

# Clear route cache
php artisan route:clear

Errore: "Permission denied"

# Fix permessi
sudo chown -R $USER:www-data storage/
sudo chmod -R 775 storage/

Dashboard non carica

1. Verifica server attivo: php artisan serve
2. Controlla URL: http://localhost:8000/admin/debug
3. Verifica login come admin
4. Check log: tail -f storage/logs/laravel.log

---

📊 Verifica Post-Installazione

Checklist Completa

• ✅ Service Provider registrato
• ✅ Route debug funzionanti
• ✅ Comandi console disponibili
• ✅ Dashboard web accessibile
• ✅ Permessi directory corretti
• ✅ Log system scrivibile
• ✅ Backup directory creata

Test Funzionale

#!/bin/bash
echo "🔍 Test Sistema Debug NetGescon"

echo "1. Test comando base..."
php artisan netgescon:debug --help > /dev/null && echo "✅ OK" || echo "❌ FAIL"

echo "2. Test scansione..."
php artisan netgescon:debug --duplicates > /dev/null && echo "✅ OK" || echo "❌ FAIL"

echo "3. Test report..."
php artisan netgescon:debug --report > /dev/null && echo "✅ OK" || echo "❌ FAIL"

echo "4. Test dashboard (richiede browser)..."
curl -s http://localhost:8000/admin/debug > /dev/null && echo "✅ OK" || echo "⚠️ Server offline"

echo "🎉 Installazione verificata!"

---

🔄 Aggiornamenti

Procedura Update

# Backup configurazione
cp -r app/Debug/ app/Debug_backup/

# Pull nuovi file (se da repository)
git pull origin main

# Aggiorna dipendenze
composer dump-autoload

# Clear cache
php artisan config:clear
php artisan view:clear

# Test funzionamento
php artisan netgescon:debug --scan

Versioning

v1.0 - Release iniziale con dashboard e comandi base
v1.1 - Aggiunta report JSON e analytics
v1.2 - Integrazione CI/CD e monitoraggio automatico

---

📞 Supporto

In caso di problemi:

1. Controlla log: storage/logs/laravel.log
2. Verifica configurazione: php artisan config:show
3. Test ambiente: php artisan about
4. Debug modalità: APP_DEBUG=true in .env

Risorse utili:

• 📚 Documentazione: docs/debug/README.md
• 🐛 Debug log: storage/logs/netgescon_debug_*.json
• 🔧 Test script: docs/debug/test-installation.sh

---

🎯 Sistema Debug installato e pronto all'uso!