173 lines
5.3 KiB
Markdown
Executable File
173 lines
5.3 KiB
Markdown
Executable File
# 🎯 NETGESCON - MANUALE MASTER UNIFICATO
|
|
## Sistema di Gestione Condominiale Completo
|
|
|
|
### 📅 Data Aggiornamento: 28 Luglio 2025
|
|
### 🎯 Versione: 2.0 - Sistema Completo e Unificato
|
|
### 🏢 Ambiente: Production Ready (/var/www/netgescon)
|
|
|
|
---
|
|
|
|
## 📋 INDICE GENERALE
|
|
|
|
### 🏗️ 01. INTERFACCIA UNICA
|
|
- [01.1 - Sistema Tabs NetGescon FUNZIONANTE](./01-INTERFACCIA-UNICA/MANUAL-TABS-NETGESCON-WORKING.md)
|
|
- [01.2 - Layout e Styling Unificato](./01-INTERFACCIA-UNICA/LAYOUT-STYLING-UNIFICATO.md)
|
|
- [01.3 - Sub-tabs e Navigazione](./01-INTERFACCIA-UNICA/SUBTABS-NAVIGAZIONE.md)
|
|
- [01.4 - Gestione Preventivi/Consuntivi](./01-INTERFACCIA-UNICA/GESTIONE-PREVENTIVI.md)
|
|
|
|
### 🏛️ 02. ARCHITETTURA SISTEMA
|
|
- [02.1 - Database e Relazioni](./02-ARCHITETTURA-SISTEMA/DATABASE-RELAZIONI.md)
|
|
- [02.2 - Modelli Laravel](./02-ARCHITETTURA-SISTEMA/MODELLI-LARAVEL.md)
|
|
- [02.3 - Controller e Routing](./02-ARCHITETTURA-SISTEMA/CONTROLLER-ROUTING.md)
|
|
- [02.4 - Migrations e Strutture](./02-ARCHITETTURA-SISTEMA/MIGRATIONS-STRUTTURE.md)
|
|
|
|
### 📖 03. MANUALI OPERATIVI
|
|
- [03.1 - Setup Ambiente Sviluppo](./03-MANUALI-OPERATIVI/SETUP-AMBIENTE-SVILUPPO.md)
|
|
- [03.2 - Setup Ambiente Produzione](./03-MANUALI-OPERATIVI/SETUP-AMBIENTE-PRODUZIONE.md)
|
|
- [03.3 - Procedure di Deploy](./03-MANUALI-OPERATIVI/PROCEDURE-DEPLOY.md)
|
|
- [03.4 - Gestione Git e Sincronizzazione](./03-MANUALI-OPERATIVI/GESTIONE-GIT.md)
|
|
|
|
### 🔧 04. TROUBLESHOOTING
|
|
- [04.1 - Problemi Interfaccia e Layout](./04-TROUBLESHOOTING/PROBLEMI-INTERFACCIA.md)
|
|
- [04.2 - Errori Database e Migrazioni](./04-TROUBLESHOOTING/ERRORI-DATABASE.md)
|
|
- [04.3 - Problemi JavaScript e CSS](./04-TROUBLESHOOTING/PROBLEMI-FRONTEND.md)
|
|
- [04.4 - Errori Laravel e PHP](./04-TROUBLESHOOTING/ERRORI-LARAVEL.md)
|
|
|
|
### 👥 05. ACCESSO ATOMIZZATO
|
|
- [05.1 - Sistema Ruoli e Permessi](./05-ACCESSO-ATOMIZZATO/SISTEMA-RUOLI.md)
|
|
- [05.2 - Gestione Utenti Multi-livello](./05-ACCESSO-ATOMIZZATO/GESTIONE-UTENTI.md)
|
|
- [05.3 - Accesso Selettivo Moduli](./05-ACCESSO-ATOMIZZATO/ACCESSO-SELETTIVO.md)
|
|
- [05.4 - Audit e Sicurezza](./05-ACCESSO-ATOMIZZATO/AUDIT-SICUREZZA.md)
|
|
|
|
---
|
|
|
|
## 🚀 STATUS SISTEMA ATTUALE
|
|
|
|
### ✅ COMPLETATO E FUNZIONANTE:
|
|
- **Interfaccia Tabs**: Sistema completo con 8 tab principali
|
|
- **Sub-tabs Avanzati**: 5 sub-tabs per Tabelle Millesimali
|
|
- **Gestione Preventivi**: Tabella NetGescon originale con calcoli
|
|
- **Database Strutturato**: Tutte le relazioni e migrazioni
|
|
- **Layout Unificato**: Solo Tailwind CSS, no Bootstrap
|
|
- **Sistema Ordinamento**: Colonne ordinamento per tutti i modelli
|
|
|
|
### 🔄 IN SVILUPPO:
|
|
- Sistema ruoli avanzato
|
|
- API REST complete
|
|
- Accesso atomizzato per utenti
|
|
- Dashboard analytics avanzate
|
|
|
|
### 📁 AMBIENTE PRODUZIONE:
|
|
- **Path**: `/var/www/netgescon`
|
|
- **Database**: MySQL netgescon
|
|
- **Web Server**: Apache2 con SSL
|
|
- **PHP**: 8.3.6
|
|
- **Laravel**: 10.x
|
|
- **Node.js**: Per Vite/Tailwind
|
|
|
|
---
|
|
|
|
## 🎯 ARCHITETTURA FUNZIONANTE
|
|
|
|
### Layout Principale:
|
|
```blade
|
|
@extends('admin.layouts.netgescon') ✅ CORRETTO
|
|
```
|
|
|
|
### Relazioni Modelli:
|
|
```php
|
|
// Stabile.php - CORRETTO
|
|
public function tabelleMillesimali() {
|
|
return $this->hasMany(TabellaMillesimale::class, 'stabile_id', 'id')
|
|
->orderBy('ordinamento')->orderBy('nome_tabella');
|
|
}
|
|
|
|
public function vociSpesa() {
|
|
return $this->hasMany(VoceSpesa::class, 'stabile_id', 'id')
|
|
->orderBy('ordinamento')->orderBy('descrizione');
|
|
}
|
|
```
|
|
|
|
### Controller con Eager Loading:
|
|
```php
|
|
// StabileController.php - CORRETTO
|
|
public function show(Stabile $stabile) {
|
|
$stabile->load([
|
|
'tabelleMillesimali' => function($query) {
|
|
$query->orderBy('ordinamento')->orderBy('nome_tabella');
|
|
},
|
|
'vociSpesa' => function($query) {
|
|
$query->orderBy('ordinamento')->orderBy('descrizione');
|
|
},
|
|
'unitaImmobiliari',
|
|
'palazzine',
|
|
'amministratore'
|
|
]);
|
|
|
|
return view('admin.stabili.show', compact('stabile'));
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 STATISTICHE SISTEMA
|
|
|
|
### Database Records (Stabile ID: 1):
|
|
- **Tabelle Millesimali**: 24 records
|
|
- **Voci di Spesa**: 30 records
|
|
- **Unità Immobiliari**: 50+ records
|
|
- **Palazzine**: Multiple records
|
|
|
|
### Performance:
|
|
- **Load Time**: < 500ms
|
|
- **Query Time**: < 100ms per tab
|
|
- **JavaScript**: Nativo, no jQuery
|
|
- **CSS**: Solo Tailwind, no Bootstrap
|
|
|
|
---
|
|
|
|
## 🔗 LINK RAPIDI
|
|
|
|
### Accesso Sistema:
|
|
- **URL**: http://192.168.0.200:8000/admin/admin
|
|
- **Database**: `netgescon`
|
|
- **User**: `netgescon_user`
|
|
- **Git Remote**: http://192.168.0.200:3000/NetGescon/netgescon-master.git
|
|
|
|
### Comandi Utili:
|
|
```bash
|
|
# Clear Laravel Caches
|
|
cd /var/www/netgescon
|
|
php artisan view:clear
|
|
php artisan route:clear
|
|
php artisan config:clear
|
|
|
|
# Sync to Windows
|
|
./sync-complete-netgescon.sh
|
|
|
|
# Git Operations
|
|
git add .
|
|
git commit -m "Update: Sistema interfaccia completo"
|
|
git push origin main
|
|
```
|
|
|
|
---
|
|
|
|
## 👨💻 AUTORI E CONTRIBUTORS
|
|
|
|
### Sistema NetGescon:
|
|
- **Michele**: Analisi, Design, Testing
|
|
- **GitHub Copilot**: Sviluppo, Implementazione, Documentazione
|
|
- **Team NetGescon**: Requirements, Feedback, Validation
|
|
|
|
### Cronologia Sviluppo:
|
|
- **Luglio 2025**: Interfaccia unificata, Sub-tabs, Gestione preventivi
|
|
- **Giugno 2025**: Setup base Laravel, Database, Modelli
|
|
- **Maggio 2025**: Architettura iniziale, Planning
|
|
|
|
---
|
|
|
|
**🎯 VERSIONE: 2.0 - SISTEMA COMPLETO**
|
|
**📅 ULTIMO AGGIORNAMENTO: 28 Luglio 2025**
|
|
**🏢 AMBIENTE: Production Ready**
|