# ⚑ NETGESCON - QUICK REFERENCE CARD ## Comandi Salvavita e Riferimenti Rapidi > **πŸ†˜ EMERGENZA:** Hai un problema? Inizia da qui! > **πŸ”— Master:** [`../00-INDICE-MASTER-NETGESCON.md`](../00-INDICE-MASTER-NETGESCON.md) > **πŸ“… Aggiornato:** 15/07/2025 --- ## 🚨 **EMERGENZE COMUNI** ### πŸ”₯ **Dashboard si sposta/salta dopo refresh** ```bash # FIX IMMEDIATO: Commenta riga loading-screen cd laravel/resources/views/components/layout sed -i 's/@include/{{-- @include/' universal.blade.php # La riga diventa: {{-- @include('components.layout.loading-screen') --}} ``` πŸ‘‰ **Dettagli:** [`manuals/INTERFACCIA-UNICA-TROUBLESHOOTING.md`](manuals/INTERFACCIA-UNICA-TROUBLESHOOTING.md) ### 🏠 **Errore "View [dashboard.guest] not found"** ```bash # Crea la view mancante mkdir -p laravel/resources/views/dashboard echo "@extends('layouts.app') @section('content')

Dashboard Guest

@endsection" > laravel/resources/views/dashboard/guest.blade.php ``` ### πŸ”‘ **Non riesco a loggarmi come admin** ```bash # Rigenera admin Miki cd laravel php artisan db:seed --class=MikiAdminSeeder # Login: admin@example.com / password ``` ### πŸ—„οΈ **Errore ruolo 'condomino' non trovato** ```bash # Rigenera ruoli cd laravel php artisan db:seed --class=RoleSeeder ``` --- ## πŸš€ **AVVIO SISTEMA** ### 🌐 **Start Laravel Server** ```bash cd laravel php artisan serve --host=0.0.0.0 --port=8000 # URL: http://localhost:8000 ``` ### πŸ”‘ **Credenziali Default** - **Email:** admin@example.com - **Password:** password - **Ruoli:** admin, super-admin ### πŸ—„οΈ **Database Reset** ```bash cd laravel php artisan migrate:fresh --seed ``` --- ## πŸ“ **FILE CRITICI** ### 🎨 **Layout e UI** | File | Scopo | Errore Comune | |------|-------|---------------| | `laravel/resources/views/components/layout/universal.blade.php` | Layout master | Loading screen sposta layout | | `laravel/resources/views/components/menu/sections/footer.blade.php` | Footer sidebar | Progress bar | | `laravel/resources/views/dashboard/guest.blade.php` | Dashboard guest | View not found | ### 🏒 **Gestione Stabili** | File | Scopo | Note | |------|-------|------| | `laravel/resources/views/admin/stabili/_form.blade.php` | Form stabili avanzata | Layout tab, multi-palazzine | | `laravel/app/Http/Controllers/Admin/StabileController.php` | Controller stabili | Gestione nuovi campi | | `laravel/app/Models/Stabile.php` | Model stabili | Nuovi campi JSON | ### πŸ”§ **Database e Seeder** | File | Scopo | Comando | |------|-------|---------| | `laravel/database/seeders/MikiAdminSeeder.php` | Admin Miki | `php artisan db:seed --class=MikiAdminSeeder` | | `laravel/database/seeders/RoleSeeder.php` | Ruoli sistema | `php artisan db:seed --class=RoleSeeder` | | `laravel/database/migrations/*_add_banking_and_palazzine_*.php` | Nuovi campi | `php artisan migrate` | --- ## πŸ”§ **COMANDI LARAVEL UTILI** ### πŸ—„οΈ **Database** ```bash # Migrate + Seed completo php artisan migrate:fresh --seed # Solo nuove migrazioni php artisan migrate # Seeder specifico php artisan db:seed --class=NomeSeeder # Rollback ultima migrazione php artisan migrate:rollback ``` ### 🧹 **Cache e Ottimizzazione** ```bash # Clear tutto php artisan optimize:clear # Clear specifici php artisan cache:clear php artisan config:clear php artisan view:clear php artisan route:clear ``` ### πŸ”§ **Debug** ```bash # ModalitΓ  debug php artisan serve --host=0.0.0.0 --port=8000 # Log in tempo reale tail -f storage/logs/laravel.log # Tinker (console interattiva) php artisan tinker ``` --- ## πŸ“‚ **DIRECTORY CHIAVE** ### 🎨 **Frontend** ``` laravel/resources/views/ β”œβ”€β”€ components/layout/ ← Layout universale β”œβ”€β”€ admin/stabili/ ← Gestione stabili β”œβ”€β”€ dashboard/ ← Dashboard varie └── layouts/ ← Layout base ``` ### πŸ”§ **Backend** ``` laravel/app/ β”œβ”€β”€ Http/Controllers/Admin/ ← Controller admin β”œβ”€β”€ Models/ ← Model Eloquent └── Providers/ ← Service provider ``` ### πŸ—„οΈ **Database** ``` laravel/database/ β”œβ”€β”€ migrations/ ← Migrazioni DB β”œβ”€β”€ seeders/ ← Seeder dati └── factories/ ← Factory test ``` --- ## πŸ› **TROUBLESHOOTING RAPIDO** ### ❌ **Errori Comuni** | Errore | Soluzione Rapida | |--------|------------------| | View not found | Controlla path in `resources/views/` | | Route not found | `php artisan route:list` | | Class not found | `composer dump-autoload` | | Permission denied | `chmod -R 755 storage bootstrap/cache` | | Database error | Controlla `.env` e connessione DB | ### πŸ”„ **Reset Completo** ```bash # ATTENZIONE: Cancella tutti i dati! cd laravel php artisan migrate:fresh --seed php artisan optimize:clear ``` --- ## πŸ“ž **SUPPORTO E RISORSE** ### πŸ“š **Documentazione Completa** - 🏠 **Master Index:** [`../00-INDICE-MASTER-NETGESCON.md`](../00-INDICE-MASTER-NETGESCON.md) - πŸ”§ **Troubleshooting:** [`manuals/INTERFACCIA-UNICA-TROUBLESHOOTING.md`](manuals/INTERFACCIA-UNICA-TROUBLESHOOTING.md) - πŸ“š **Bibbia Archivi:** [`manuals/ARCHIVI-DATABASE-BIBBIA.md`](manuals/ARCHIVI-DATABASE-BIBBIA.md) - πŸ“‹ **Checklist:** [`checklists/CHECKLIST-IMPLEMENTAZIONE.md`](checklists/CHECKLIST-IMPLEMENTAZIONE.md) ### πŸ“ **Log e Tracking** - πŸ“Š **Log Principale:** [`LOG-SVILUPPO.md`](LOG-SVILUPPO.md) - πŸ”₯ **Ultimo Fix:** [`logs/LOG-TEST-DASHBOARD-2025-07-15.md`](logs/LOG-TEST-DASHBOARD-2025-07-15.md) - πŸ“‚ **Tutti i Log:** [`logs/`](logs/) ### 🌐 **URL e Contatti** - **Sviluppo:** http://localhost:8000 - **Admin:** admin@example.com - **Team:** Michele (Lead Dev), Miki (Domain Expert) --- ## πŸ’‘ **TIPS & BEST PRACTICES** ### βœ… **Do's** - βœ… Sempre backup prima di modifiche importanti - βœ… Usa `php artisan optimize:clear` dopo modifiche config - βœ… Testa su ambiente locale prima di deploy - βœ… Documenta ogni fix nel log appropriato - βœ… Usa seeder per dati di test consistenti ### ❌ **Don'ts** - ❌ Non modificare direttamente file vendor/ - ❌ Non committare file .env - ❌ Non dimenticare di migrare dopo pull - ❌ Non cancellare backup senza conferma - ❌ Non ignorare errori in laravel.log --- > **🎯 REMEMBER:** Questo Γ¨ il tuo **primo punto di riferimento** per problemi rapidi! > **πŸ“– Per dettagli:** Consulta sempre la documentazione completa linkata sopra. --- **⚑ NetGescon Quick Reference** - Aggiornato 15/07/2025 **πŸ”— Master:** [`../00-INDICE-MASTER-NETGESCON.md`](../00-INDICE-MASTER-NETGESCON.md)