# 📋 **NetGesCon Laravel - Documentazione Maschere e Interfacce** ## 📍 **STATO DEL PROGETTO** - **Fase**: Business Logic Core completata - **Prossima fase**: Sviluppo interfacce utente responsive - **Livello**: Pronto per sviluppo controller e viste --- ## 🎯 **STRUTTURA VERIFICATA - COLLEGAMENTI FUNZIONALI** ### ✅ **Voci di Spesa → Tabelle Millesimali** Le voci di spesa sono correttamente collegate al sistema millesimale: ```php // VoceSpesa.php - Relazione con tabella millesimale public function tabellaMillesimaleDefault() { return $this->belongsTo(TabellaMillesimale::class, 'tabella_millesimale_default_id'); } // Collegamento alla ripartizione spese public function ripartizioniSpese() { return $this->hasMany(RipartizioneSpese::class); } ``` ### ✅ **Workflow Completo di Ripartizione** 1. **Voce Spesa** → definisce la spesa e tabella millesimale di default 2. **Ripartizione Spese** → calcola la ripartizione per ogni unità 3. **Dettaglio Ripartizione** → importo specifico per ogni unità 4. **Piano Rateizzazione** → gestione pagamenti dilazionati 5. **Rate** → singole scadenze di pagamento --- ## 🎨 **STANDARDIZZAZIONE SVILUPPO UI** ### **1. Struttura Base per Maschere Laravel** #### **A. Layout Base Responsive** ```php // resources/views/layouts/app.blade.php @yield('title', 'NetGesCon')
@include('partials.sidebar')
@yield('content')
@yield('scripts') ``` #### **B. Componenti Standard per Form** ```php // resources/views/components/form-input.blade.php @props(['name', 'label', 'type' => 'text', 'required' => false, 'value' => ''])
@error($name)
{{ $message }}
@enderror
``` #### **C. Componente Select per Relazioni** ```php // resources/views/components/form-select.blade.php @props(['name', 'label', 'options' => [], 'selected' => '', 'required' => false])
@error($name)
{{ $message }}
@enderror
``` --- ## 🏗️ **ARCHITETTURA CONTROLLER E VISTE** ### **1. Controller Standard Pattern** #### **A. Controller Base per Gestione CRUD** ```php // app/Http/Controllers/BaseController.php model::query(); // Filtri standard if ($request->has('search')) { $query = $this->applySearch($query, $request->search); } if ($request->has('stabile_id')) { $query->where('stabile_id', $request->stabile_id); } $items = $query->paginate(20); return view("{$this->viewPath}.index", compact('items')); } abstract protected function applySearch($query, $search); public function create() { return view("{$this->viewPath}.create", $this->getFormData()); } public function store(Request $request) { $this->validateRequest($request); DB::beginTransaction(); try { $item = $this->model::create($request->validated()); DB::commit(); return redirect() ->route("{$this->routePrefix}.show", $item) ->with('success', 'Elemento creato con successo'); } catch (\Exception $e) { DB::rollBack(); return back()->with('error', 'Errore durante la creazione: ' . $e->getMessage()); } } abstract protected function validateRequest(Request $request); abstract protected function getFormData(); } ``` #### **B. Controller Specifico per Voci di Spesa** ```php // app/Http/Controllers/VoceSpesaController.php where(function($q) use ($search) { $q->where('codice', 'LIKE', "%{$search}%") ->orWhere('descrizione', 'LIKE', "%{$search}%"); }); } protected function validateRequest(Request $request) { return $request->validate([ 'stabile_id' => 'required|exists:stabili,id', 'descrizione' => 'required|string|max:255', 'tipo_gestione' => 'required|in:ordinaria,straordinaria,speciale', 'categoria' => 'required|string', 'tabella_millesimale_default_id' => 'nullable|exists:tabelle_millesimali,id', 'ritenuta_acconto_default' => 'nullable|numeric|between:0,100', 'attiva' => 'boolean', 'ordinamento' => 'nullable|integer' ]); } protected function getFormData() { return [ 'stabili' => Stabile::pluck('denominazione', 'id'), 'tabelleMillesimali' => TabellaMillesimale::pluck('denominazione', 'id'), 'categorie' => VoceSpesa::getCategorieStandard(), 'tipiGestione' => VoceSpesa::getTipiGestione() ]; } } ``` --- ## 🎯 **MASCHERE PRINCIPALI DA IMPLEMENTARE** ### **1. Gestione Voci di Spesa** - **Lista**: Filtri per stabile, categoria, tipo gestione - **Dettaglio**: Visualizzazione completa con storico ripartizioni - **Creazione/Modifica**: Form con validazione e selezione tabella millesimale ### **2. Gestione Ripartizione Spese** - **Wizard di Ripartizione**: Step-by-step per calcolo automatico - **Anteprima Ripartizione**: Visualizzazione prima della conferma - **Gestione Esenzioni**: Interfaccia per escludere unità specifiche ### **3. Gestione Rate** - **Piano Rateizzazione**: Creazione piani di pagamento - **Calendario Scadenze**: Vista calendario con rate in scadenza - **Gestione Pagamenti**: Registrazione e storico pagamenti ### **4. Dashboard Amministratore** - **Riepilogo Finanziario**: Grafici e statistiche - **Scadenze Imminenti**: Alert per rate in scadenza - **Stato Ripartizioni**: Monitoraggio ripartizioni aperte --- ## 🔧 **STRUMENTI E INTEGRAZIONI** ### **1. Validazione Client-Side** ```javascript // public/js/netgescon.js class NetgesconValidator { static validateRipartizione(form) { const importo = parseFloat(form.importo_totale.value); const tabellaId = form.tabella_millesimale_id.value; if (importo <= 0) { this.showError('L\'importo deve essere maggiore di zero'); return false; } if (!tabellaId) { this.showError('Seleziona una tabella millesimale'); return false; } return true; } static showError(message) { // Implementazione notifica errore } } ``` ### **2. API JSON per Interazioni Ajax** ```php // app/Http/Controllers/Api/RipartizioneSpesaController.php public function calcolaAnteprima(Request $request) { $voceSpesa = VoceSpesa::find($request->voce_spesa_id); $importoTotale = $request->importo_totale; $ripartizione = new RipartizioneSpese(); $anteprima = $ripartizione->calcolaAnteprimaRipartizione( $voceSpesa, $importoTotale, $request->tabella_millesimale_id ); return response()->json([ 'success' => true, 'anteprima' => $anteprima, 'totale_calcolato' => $anteprima->sum('importo_calcolato') ]); } ``` --- ## 🎨 **TEMI CSS PERSONALIZZATI** ### **1. Variabili CSS NetGesCon** ```css /* public/css/netgescon.css */ :root { --primary-color: #2c3e50; --secondary-color: #3498db; --success-color: #27ae60; --warning-color: #f39c12; --danger-color: #e74c3c; --light-bg: #f8f9fa; --dark-text: #2c3e50; } .card-netgescon { border: none; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); } .btn-netgescon { border-radius: 6px; padding: 8px 16px; font-weight: 500; } .table-netgescon { border-collapse: separate; border-spacing: 0; } .table-netgescon th { background-color: var(--light-bg); border-bottom: 2px solid var(--primary-color); font-weight: 600; } ``` --- ## 🔌 **PLUGIN SYSTEM ARCHITECTURE** ### **1. Struttura Base per Plugin** ```php // app/Plugins/PluginInterface.php interface PluginInterface { public function register(): void; public function boot(): void; public function getMenuItems(): array; public function getRoutes(): array; public function getViews(): array; } // app/Plugins/BasePlugin.php abstract class BasePlugin implements PluginInterface { protected $name; protected $version; protected $description; public function register(): void { // Registrazione servizi base } abstract public function boot(): void; } ``` ### **2. Plugin Manager** ```php // app/Services/PluginManager.php class PluginManager { protected $plugins = []; public function loadPlugin($pluginClass) { $plugin = new $pluginClass(); $plugin->register(); $plugin->boot(); $this->plugins[] = $plugin; } public function getMenuItems() { $items = []; foreach ($this->plugins as $plugin) { $items = array_merge($items, $plugin->getMenuItems()); } return $items; } } ``` --- ## 📊 **PROSSIMI STEP IMPLEMENTATIVI** ### **Fase 1: Implementazione Controller e Viste Base** 1. Creazione controller per VoceSpesa, RipartizioneSpese, Rate 2. Implementazione viste index, create, edit, show 3. Configurazione rotte e middleware ### **Fase 2: Interfacce Avanzate** 1. Wizard ripartizione spese con preview 2. Dashboard amministratore con grafici 3. Calendario scadenze interattivo ### **Fase 3: Integrazioni** 1. Sistema notifiche (email, SMS) 2. Export PDF/Excel 3. API REST per app mobile --- ## 🎯 **CHECKLIST SVILUPPO** ### **Backend** - [x] Modelli Eloquent completi - [x] Relazioni verificate - [x] Migration funzionali - [ ] Controller CRUD - [ ] Validazione form - [ ] API endpoints ### **Frontend** - [ ] Layout responsive - [ ] Componenti riutilizzabili - [ ] Validazione client-side - [ ] Interfacce wizard - [ ] Dashboard grafici ### **Integrazioni** - [ ] Sistema notifiche - [ ] Export documenti - [ ] Plugin system - [ ] Mobile API --- **Aggiornato**: 2025-01-27 **Versione**: 1.0 **Prossimo update**: Dopo implementazione primi controller