netgescon-master/docs/02-architettura-laravel/specifiche/MENU_MAPPING.md

🎯 MENU MAPPING - NetGesCon Laravel

📅 Creato: 9 Luglio 2025
🔄 Ultimo aggiornamento: 9 Luglio 2025
🎯 Scopo: Mappa completa menu, pagine e collegamenti

---

🌳 STRUTTURA AD ALBERO MENU

NetGesCon Laravel
├── 🏠 Dashboard
│   ├── 📊 Panoramica Generale
│   ├── 📈 Statistiche Real-time  
│   ├── 🔔 Notifiche e Alert
│   └── ⚡ Azioni Rapide
│
├── 🏢 Gestione Stabili
│   ├── 📋 Lista Stabili
│   ├── ➕ Nuovo Stabile
│   ├── 🏠 Dettaglio Stabile
│   │   ├── 📄 Informazioni Generali
│   │   ├── 🏘️ Unità Immobiliari
│   │   ├── 👥 Soggetti Associati
│   │   ├── 📊 Tabelle Millesimali
│   │   └── 📑 Documenti Allegati
│   └── 🔧 Configurazioni
│
├── 🏠 Unità Immobiliari
│   ├── 📋 Lista Unità
│   ├── ➕ Nuova Unità
│   ├── 🔍 Ricerca Avanzata
│   ├── 📊 Dettaglio Unità
│   │   ├── 📄 Dati Catastali
│   │   ├── 👤 Proprietari/Inquilini
│   │   ├── 📋 Contratti Attivi
│   │   ├── 💰 Situazione Contabile
│   │   └── 📑 Documenti
│   └── 📈 Report Unità
│
├── 👥 Gestione Soggetti
│   ├── 📋 Anagrafica Completa
│   │   ├── 👤 Persone Fisiche
│   │   ├── 🏢 Persone Giuridiche
│   │   └── 🔍 Ricerca Globale
│   ├── ➕ Nuovo Soggetto
│   ├── 🏡 Proprietari
│   │   ├── 📋 Lista Proprietari
│   │   ├── 🔗 Quote Proprietà
│   │   └── 📊 Statistiche Proprietà
│   ├── 🏠 Inquilini
│   │   ├── 📋 Lista Inquilini
│   │   ├── 📄 Contratti Attivi
│   │   └── 📈 Storico Contratti
│   └── 📞 Rubrica Contatti
│
├── 📄 Contratti Locazione
│   ├── 📋 Lista Contratti
│   │   ├── ✅ Contratti Attivi
│   │   ├── ⏰ Scadenze Imminenti
│   │   ├── ❌ Contratti Scaduti
│   │   └── 📊 Statistiche Contratti
│   ├── ➕ Nuovo Contratto
│   ├── 🔍 Ricerca Contratti
│   ├── 📊 Dettaglio Contratto
│   │   ├── 📄 Dati Generali
│   │   ├── 💰 Condizioni Economiche
│   │   ├── 👥 Parti Contraenti
│   │   ├── 📅 Scadenze e Rinnovi
│   │   └── 📑 Allegati
│   └── 🛠️ Strumenti
│       ├── 📄 Genera Contratto
│       ├── 🧮 Calcolo Canoni
│       └── 📤 Esporta Dati
│
├── 💰 Contabilità
│   ├── 📊 Dashboard Contabile
│   │   ├── 💵 Situazione Cassa
│   │   ├── 📈 Entrate/Uscite
│   │   ├── 📋 Bilancio Sintetico
│   │   └── 🔔 Alert Finanziari
│   ├── 📝 Movimenti Contabili
│   │   ├── 📋 Lista Movimenti
│   │   ├── ➕ Nuovo Movimento
│   │   ├── 🔍 Ricerca Movimenti
│   │   └── 📊 Analisi Movimenti
│   ├── 🏦 Gestione Banche
│   │   ├── 📋 Conti Bancari
│   │   ├── 💳 Estratti Conto
│   │   ├── 🔄 Riconciliazione
│   │   └── 📄 Import Movimenti
│   ├── 📊 Piano dei Conti
│   │   ├── 📋 Lista Conti
│   │   ├── ➕ Nuovo Conto
│   │   ├── 🌳 Struttura Gerarchica
│   │   └── ⚙️ Configurazioni
│   ├── 📄 Bilanci e Report
│   │   ├── 📊 Bilancio Generale
│   │   ├── 📈 Conto Economico
│   │   ├── 💰 Situazione Patrimoniale
│   │   ├── 📋 Estratti Conto Stabili
│   │   └── 📑 Report Personalizzati
│   └── 💸 Gestione Fiscale
│       ├── 📄 Ritenute d'Acconto
│       ├── 📋 Modello F24
│       ├── 📊 Certificazione Unica
│       └── 📑 Modello 770
│
├── 📋 Gestioni Amministrative
│   ├── 📊 Dashboard Gestioni
│   │   ├── 🔧 Manutenzioni Attive
│   │   ├── 📅 Scadenze Imminenti
│   │   ├── 🚨 Emergenze
│   │   └── 📈 Statistiche Gestioni
│   ├── ➕ Nuova Gestione
│   ├── 🔍 Ricerca Gestioni
│   ├── 📂 Categorie Gestioni
│   │   ├── 🔧 Manutenzione
│   │   ├── 📋 Amministrativa
│   │   ├── 💰 Contabile
│   │   ├── ⚖️ Legale
│   │   └── 🏗️ Lavori Straordinari
│   ├── 📊 Dettaglio Gestione
│   │   ├── 📄 Informazioni Generali
│   │   ├── 📅 Timeline Attività
│   │   ├── 💰 Aspetti Economici
│   │   ├── 👥 Soggetti Coinvolti
│   │   └── 📑 Documenti Allegati
│   └── 📈 Report Gestioni
│
├── 📎 Allegati e Documenti
│   ├── 📊 Dashboard Documenti
│   │   ├── 📁 Categorie Documenti
│   │   ├── 🔍 Ricerca Rapida
│   │   ├── 📈 Statistiche Upload
│   │   └── 🔔 Documenti Scaduti
│   ├── ➕ Carica Documento
│   ├── 📂 Gestione Categorie
│   │   ├── 📄 Contratti
│   │   ├── 📋 Amministrativa
│   │   ├── 💰 Contabile
│   │   ├── ⚖️ Legale
│   │   ├── 🏗️ Tecnica
│   │   └── 📷 Foto e Media
│   ├── 🔍 Ricerca Avanzata
│   ├── 📊 Dettaglio Documento
│   │   ├── 📄 Informazioni Generali
│   │   ├── 👁️ Anteprima/Download
│   │   ├── 🔐 Permessi Accesso
│   │   ├── 📝 Note e Commenti
│   │   └── 📅 Storico Versioni
│   └── 🛠️ Strumenti
│       ├── 📤 Condivisione
│       ├── 🔄 Versionamento
│       └── 📊 Report Usage
│
├── 🎫 Sistema Tickets
│   ├── 📊 Dashboard Tickets
│   │   ├── 🔥 Urgenti
│   │   ├── ▶️ In Lavorazione
│   │   ├── ⏳ In Attesa
│   │   └── ✅ Risolti
│   ├── ➕ Nuovo Ticket
│   ├── 🔍 Ricerca Tickets
│   ├── 📂 Categorie
│   │   ├── 🔧 Manutenzione
│   │   ├── 🚨 Emergenze
│   │   ├── 📞 Reclami
│   │   ├── ℹ️ Informazioni
│   │   └── 💡 Suggerimenti
│   ├── 📊 Dettaglio Ticket
│   │   ├── 📄 Descrizione Problema
│   │   ├── 💬 Conversazione
│   │   ├── 👥 Soggetti Coinvolti
│   │   ├── ⏰ Timeline Attività
│   │   └── 📑 Allegati
│   └── 📈 Analytics Tickets
│
├── 📞 Comunicazioni
│   ├── 📊 Centro Comunicazioni
│   │   ├── 📧 Email
│   │   ├── 📄 PEC
│   │   ├── 📱 SMS
│   │   ├── 💬 WhatsApp
│   │   └── 🔔 Notifiche Push
│   ├── ➕ Nuova Comunicazione
│   ├── 👥 Gruppi Destinatari
│   │   ├── 🏢 Per Stabile
│   │   ├── 👤 Per Ruolo
│   │   ├── 🏠 Per Unità
│   │   └── 🎯 Personalizzati
│   ├── 📋 Registro Comunicazioni
│   │   ├── 📤 Inviate
│   │   ├── 📨 Ricevute
│   │   ├── ✅ Conferme Lettura
│   │   └── ❌ Non Consegnate
│   ├── 📄 Template Comunicazioni
│   │   ├── 📋 Convocazioni
│   │   ├── 💰 Estratti Conto
│   │   ├── 🔔 Solleciti
│   │   └── ℹ️ Informative
│   └── 📊 Statistiche Comunicazioni
│
├── 🖨️ Stampe e Report
│   ├── 📊 Centro Stampe
│   │   ├── 📄 Documenti Legali
│   │   ├── 💰 Report Contabili
│   │   ├── 📋 Report Gestionali
│   │   └── 📊 Statistiche
│   ├── 📄 Documenti Standard
│   │   ├── 📋 Contratti Locazione
│   │   ├── 📄 Convocazioni Assemblea
│   │   ├── 📊 Verbali Assemblea
│   │   ├── 💰 Estratti Conto
│   │   └── 📑 Certificazioni
│   ├── 💰 Report Finanziari
│   │   ├── 📊 Bilancio Generale
│   │   ├── 📈 Conto Economico
│   │   ├── 💰 Situazione Patrimoniale
│   │   ├── 📋 Movimenti Periodo
│   │   └── 📊 Analisi Costi
│   ├── 📋 Report Gestionali
│   │   ├── 📊 Situazione Stabili
│   │   ├── 👥 Anagrafica Soggetti
│   │   ├── 🏠 Report Unità
│   │   ├── 📄 Contratti Attivi
│   │   └── 🎫 Riepilogo Tickets
│   └── 🛠️ Stampe Personalizzate
│       ├── 📊 Report Builder
│       ├── 📄 Template Editor
│       └── 📅 Stampe Programmate
│
├── ⚙️ Configurazioni
│   ├── 🏢 Impostazioni Amministratore
│   │   ├── 📄 Dati Studio
│   │   ├── 💰 Parametri Contabili
│   │   ├── 📞 Contatti
│   │   └── 🔐 Sicurezza
│   ├── 🎨 Personalizzazione
│   │   ├── 🎨 Tema e Colori
│   │   ├── 📄 Logo e Branding
│   │   ├── 📧 Template Email
│   │   └── 🔔 Notifiche
│   ├── 👥 Gestione Utenti
│   │   ├── 📋 Lista Utenti
│   │   ├── ➕ Nuovo Utente
│   │   ├── 🔐 Ruoli e Permessi
│   │   └── 📊 Log Accessi
│   ├── 🔧 Configurazioni Sistema
│   │   ├── 📧 SMTP Email
│   │   ├── 📱 SMS Gateway
│   │   ├── 🏦 API Bancarie
│   │   └── 📄 Firma Digitale
│   ├── 🗃️ Gestione Database
│   │   ├── 🔄 Backup/Restore
│   │   ├── 📊 Statistiche DB
│   │   ├── 🧹 Pulizia Dati
│   │   └── 📈 Performance
│   └── 📊 Log di Sistema
│       ├── 🔍 Log Applicazione
│       ├── ⚠️ Errori e Warning
│       ├── 👤 Audit Trail
│       └── 📈 Performance Log
│
└── 🔐 Super Admin (Solo Super Admin)
    ├── 👑 Dashboard Super Admin
    │   ├── 📊 Panoramica Globale
    │   ├── 👥 Tutti gli Amministratori
    │   ├── 🏢 Tutti gli Stabili
    │   └── 📈 Statistiche Sistema
    ├── 👥 Gestione Amministratori
    │   ├── 📋 Lista Amministratori
    │   ├── ➕ Nuovo Amministratore
    │   ├── 🔐 Permessi Globali
    │   └── 📊 Report Attività
    ├── 🗃️ Archivi Condivisi
    │   ├── 📋 Piano Conti Standard
    │   ├── 🏛️ Comuni d'Italia
    │   ├── 🛣️ Vie e Indirizzi
    │   ├── ⚖️ Normative Condominio
    │   └── 📄 Template Documenti
    ├── 💰 Scritture Contabili Template
    │   ├── 📄 Registrazione Fatture
    │   ├── 💳 Gestione Incassi
    │   ├── 🏦 Import Movimenti Bancari
    │   └── 📊 Chiusure Contabili
    ├── 🧪 Test di Sistema
    │   ├── 🔍 Verifica Integrità DB
    │   ├── 🧮 Test Calcoli Contabili
    │   ├── 🔐 Audit Sicurezza
    │   ├── 📊 Performance Test
    │   └── 🔄 Backup Test
    ├── 📊 Monitoring e Statistiche
    │   ├── 📈 Performance Sistema
    │   ├── 👥 Utilizzo per Amministratore
    │   ├── 💾 Spazio Database
    │   ├── 🔍 Log Errori Globali
    │   └── 📊 Report Utilizzo
    └── ⚙️ Configurazioni Globali
        ├── 🔧 Parametri Sistema
        ├── 🛡️ Sicurezza Globale
        ├── 📧 Template Email Sistema
        ├── 🔄 Aggiornamenti
        └── 🐳 Deploy e Manutenzione

---

✅ STATUS IMPLEMENTAZIONE MENU

🏠 Dashboard - 🔄 IN CORSO (30%)

• 📊 Panoramica Generale - 🔄 Base implementata
• 📈 Statistiche Real-time - ❌ Non implementato
• 🔔 Notifiche e Alert - ❌ Non implementato
• ⚡ Azioni Rapide - ❌ Non implementato

🏢 Gestione Stabili - 🔄 IN CORSO (40%)

• 📋 Lista Stabili - ✅ Implementato
• ➕ Nuovo Stabile - ✅ Implementato
• 🏠 Dettaglio Stabile - 🔄 Parziale
• 🏘️ Unità Immobiliari - 🔄 Collegamento parziale
• 👥 Soggetti Associati - ❌ Non implementato
• 📊 Tabelle Millesimali - ❌ Non implementato

🏠 Unità Immobiliari - 🔄 IN CORSO (50%)

• 📋 Lista Unità - ✅ Implementato
• ➕ Nuova Unità - ✅ Implementato
• 🔍 Ricerca Avanzata - ❌ Non implementato
• 📊 Dettaglio Unità - 🔄 Base
• 👤 Proprietari/Inquilini - ❌ Collegamento mancante

👥 Gestione Soggetti - 🔄 IN CORSO (60%)

• 📋 Anagrafica Completa - ✅ Implementato
• ➕ Nuovo Soggetto - ✅ Implementato
• 🏡 Proprietari - 🔄 Base
• 🏠 Inquilini - 🔄 Base
• 📞 Rubrica Contatti - ❌ Non implementato

📄 Contratti Locazione - ✅ COMPLETATO (80%)

• 📋 Lista Contratti - ✅ Implementato e testato
• ➕ Nuovo Contratto - ✅ Implementato e testato
• 🔍 Ricerca Contratti - 🔄 Base
• 📊 Dettaglio Contratto - 🔄 Parziale
• 🛠️ Strumenti - ❌ Non implementato

💰 Contabilità - ⏳ PIANIFICATO (10%)

• 📊 Dashboard Contabile - ❌ Non implementato
• 📝 Movimenti Contabili - ❌ Non implementato
• 🏦 Gestione Banche - ❌ Non implementato
• 📊 Piano dei Conti - ✅ Seeder base
• 📄 Bilanci e Report - ❌ Non implementato
• 💸 Gestione Fiscale - ⏳ Pianificato

📋 Gestioni Amministrative - ✅ COMPLETATO (80%)

• 📊 Dashboard Gestioni - ✅ Implementato e testato
• ➕ Nuova Gestione - ✅ Implementato e testato
• 🔍 Ricerca Gestioni - 🔄 Base
• 📂 Categorie Gestioni - ✅ Implementato
• 📊 Dettaglio Gestione - 🔄 Parziale

📎 Allegati e Documenti - ✅ COMPLETATO (80%)

• 📊 Dashboard Documenti - ✅ Implementato e testato
• ➕ Carica Documento - ✅ Implementato e testato
• 📂 Gestione Categorie - ✅ Implementato
• 🔍 Ricerca Avanzata - 🔄 Base
• 📊 Dettaglio Documento - 🔄 Parziale

🎫 Sistema Tickets - ❌ NON IMPLEMENTATO (0%)

• 📊 Dashboard Tickets - ❌ Non implementato
• ➕ Nuovo Ticket - ❌ Non implementato
• 🔍 Ricerca Tickets - ❌ Non implementato
• 📂 Categorie - ❌ Non implementato

📞 Comunicazioni - ❌ NON IMPLEMENTATO (0%)

• 📊 Centro Comunicazioni - ❌ Non implementato
• ➕ Nuova Comunicazione - ❌ Non implementato
• 👥 Gruppi Destinatari - ❌ Non implementato
• 📋 Registro Comunicazioni - ❌ Non implementato

🖨️ Stampe e Report - ⏳ PIANIFICATO (0%)

• 📊 Centro Stampe - ❌ Non implementato
• 📄 Documenti Standard - ❌ Non implementato
• 💰 Report Finanziari - ❌ Non implementato
• 📋 Report Gestionali - ❌ Non implementato

⚙️ Configurazioni - 🔄 IN CORSO (20%)

• 🏢 Impostazioni Amministratore - 🔄 Base
• 🎨 Personalizzazione - ❌ Non implementato
• 👥 Gestione Utenti - 🔄 Base via seeder
• 🔧 Configurazioni Sistema - ❌ Non implementato

🔐 Super Admin - 🔄 IN CORSO (30%)

• 👑 Dashboard Super Admin - 🔄 Base
• 👥 Gestione Amministratori - 🔄 Seeder
• 🗃️ Archivi Condivisi - ❌ Non implementato
• 💰 Scritture Contabili Template - ❌ Non implementato
• 🧪 Test di Sistema - ❌ Non implementato

---

🔗 ROUTING E COLLEGAMENTI

✅ ROUTE IMPLEMENTATE

🏠 Dashboard

Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard');

🏢 Stabili

Route::resource('stabili', StabileController::class);
// GET    /stabili               - index  ✅
// GET    /stabili/create        - create ✅
// POST   /stabili               - store  ✅
// GET    /stabili/{id}          - show   ✅
// GET    /stabili/{id}/edit     - edit   ✅
// PUT    /stabili/{id}          - update ✅
// DELETE /stabili/{id}          - destroy✅

🏠 Unità Immobiliari

Route::resource('unita-immobiliari', UnitaImmobiliareController::class);
// GET    /unita-immobiliari               - index  ✅
// GET    /unita-immobiliari/create        - create ✅
// POST   /unita-immobiliari               - store  ✅
// GET    /unita-immobiliari/{id}          - show   ✅
// GET    /unita-immobiliari/{id}/edit     - edit   ✅
// PUT    /unita-immobiliari/{id}          - update ✅
// DELETE /unita-immobiliari/{id}          - destroy✅

👥 Soggetti

Route::resource('soggetti', SoggettoController::class);
// GET    /soggetti               - index  ✅
// GET    /soggetti/create        - create ✅
// POST   /soggetti               - store  ✅
// GET    /soggetti/{id}          - show   ✅
// GET    /soggetti/{id}/edit     - edit   ✅
// PUT    /soggetti/{id}          - update ✅
// DELETE /soggetti/{id}          - destroy✅

📄 Contratti Locazione

Route::resource('contratti-locazione', ContrattoLocazioneController::class);
// GET    /contratti-locazione               - index  ✅
// GET    /contratti-locazione/create        - create ✅
// POST   /contratti-locazione               - store  ✅
// GET    /contratti-locazione/{id}          - show   ✅
// GET    /contratti-locazione/{id}/edit     - edit   ✅
// PUT    /contratti-locazione/{id}          - update ✅
// DELETE /contratti-locazione/{id}          - destroy✅

📋 Gestioni

Route::resource('gestioni', GestioneController::class);
// GET    /gestioni               - index  ✅
// GET    /gestioni/create        - create ✅
// POST   /gestioni               - store  ✅
// GET    /gestioni/{id}          - show   ✅
// GET    /gestioni/{id}/edit     - edit   ✅
// PUT    /gestioni/{id}          - update ✅
// DELETE /gestioni/{id}          - destroy✅

📎 Allegati

Route::resource('allegati', AllegatoController::class);
// GET    /allegati               - index  ✅
// GET    /allegati/create        - create ✅
// POST   /allegati               - store  ✅
// GET    /allegati/{id}          - show   ✅
// GET    /allegati/{id}/edit     - edit   ✅
// PUT    /allegati/{id}          - update ✅
// DELETE /allegati/{id}          - destroy✅

❌ ROUTE DA IMPLEMENTARE

🎫 Tickets

Route::resource('tickets', TicketController::class);
Route::get('tickets/categoria/{categoria}', [TicketController::class, 'byCategoria']);
Route::patch('tickets/{id}/stato', [TicketController::class, 'cambiaStato']);

💰 Contabilità

Route::prefix('contabilita')->group(function () {
    Route::resource('movimenti', MovimentoContabileController::class);
    Route::resource('conti-bancari', ContoBancarioController::class);
    Route::resource('piano-conti', PianoContiController::class);
    Route::get('bilancio', [ContabilitaController::class, 'bilancio']);
    Route::get('estratti-conto', [ContabilitaController::class, 'estrattiConto']);
});

📞 Comunicazioni

Route::prefix('comunicazioni')->group(function () {
    Route::resource('comunicazioni', ComunicazioneController::class);
    Route::resource('gruppi', GruppoComunicazioneController::class);
    Route::get('registro', [ComunicazioneController::class, 'registro']);
    Route::post('invio-massivo', [ComunicazioneController::class, 'invioMassivo']);
});

🖨️ Stampe

Route::prefix('stampe')->group(function () {
    Route::get('contratto/{id}', [StampaController::class, 'contratto']);
    Route::get('estratto-conto/{stabile}', [StampaController::class, 'estrattoConto']);
    Route::get('bilancio/{stabile}', [StampaController::class, 'bilancio']);
    Route::get('convocazione/{assemblea}', [StampaController::class, 'convocazione']);
});

---

🧪 TEST COLLEGAMENTI

✅ TEST DA FARE

🔗 Link Verification

• Tutti i menu principale: Verificare che portino alle pagine corrette
• Breadcrumb navigation: Test navigazione gerarchica
• Internal links: Collegamento tra entità (Stabile → Unità → Soggetti)
• Form submissions: Test submit e redirect
• Error pages: 404, 403, 500 corrette

🎯 User Journey Testing

• Amministratore: Workflow completo gestione stabile
• Condomino: Accesso dati propri e restrizioni
• Fornitore: Area limitata e permessi
• Guest: Solo lettura funzionante

📱 Responsive Testing

• Mobile menu: Hamburger menu funzionante
• Tablet navigation: Touch-friendly
• Desktop: Hover states e dropdown

---

⚠️ PROBLEMI NOTI

🚨 CRITICI

• ❌ Menu Contabilità: Route non implementate, porta a 404
• ❌ Sistema Tickets: Completamente mancante
• ❌ Comunicazioni: Non implementato

⚠️ MINORI

• ⚠️ Search functionality: Ricerca base mancante in molte sezioni
• ⚠️ Filters: Filtri avanzati non implementati
• ⚠️ Pagination: Su liste lunghe potrebbe servire

🔄 IN PROGRESS

• 🔄 Super Admin dashboard: Base presente ma da completare
• 🔄 User permissions: Test granularità permessi
• 🔄 Switch utente: Funzionalità da implementare

---

📋 PROSSIMI PASSI

🎯 PRIORITÀ IMMEDIATE

1. 🔗 Test tutti i link esistenti - Verificare che non ci siano 404
2. 🎫 Implementare sistema Tickets - CRUD base
3. 💰 Route Contabilità - Almeno pagine placeholder
4. 🔍 Ricerca globale - Search box header

📊 MILESTONE PROSSIMA SETTIMANA

• ✅ Tutti i menu principali funzionanti (no 404)
• ✅ Search basic implementata
• ✅ Switch utente per Michele funzionante
• ✅ Test journey per tutti i ruoli

---

🔄 Aggiornare questo mapping ad ogni nuova route/menu implementato
🧪 Testare tutti i collegamenti prima di ogni deploy
📱 Verificare responsive su tutti i menu