netgescon-master/docs/00-transizione-linux/README-TRANSITION-COMPLETE.md

NETGESCON - README DI TRANSIZIONE

📋 PANORAMICA DEL PROGETTO

NETGESCON è un sistema di gestione condominiale sviluppato in Laravel, progettato per gestire:

• Stabili e condomini
• Anagrafica inquilini e proprietari
• Gestione amministratori
• Fatturazione e contabilità
• Reportistica e documenti

🎯 STATO ATTUALE

• ✅ Ambiente: Ubuntu 24.04 LTS
• ✅ Framework: Laravel 11.x
• ✅ Database: MySQL 8.0
• ✅ Server Web: Apache2
• ✅ PHP: 8.1+
• ✅ Accesso Remoto: RDP + VNC configurati
• ✅ IDE: VS Code + GitHub Copilot

---

🗂️ STRUTTURA DEL PROGETTO

/var/www/netgescon-complete/
├── laravel-app/                    # Applicazione Laravel principale
│   ├── app/
│   │   ├── Models/                 # Modelli Eloquent
│   │   ├── Http/Controllers/       # Controller
│   │   ├── Observers/              # Observer per auto-generazione codici
│   │   └── ...
│   ├── database/
│   │   ├── migrations/             # Migrazioni database
│   │   └── seeders/               # Dati di test
│   ├── resources/views/           # Template Blade
│   ├── routes/                    # Definizione rotte
│   ├── public/                    # Asset pubblici
│   ├── .env                       # Configurazione ambiente
│   └── composer.json              # Dipendenze PHP
├── docs/                          # Documentazione tecnica
│   ├── 00-transizione-linux/      # Guide migrazione
│   ├── 01-manuali-aggiuntivi/     # Manuali operativi
│   ├── 02-architettura-laravel/   # Architettura sistema
│   ├── 03-scripts-automazione/    # Script e tools
│   ├── images/                    # Screenshot e materiali visivi
│   └── ...
├── scripts/                       # Script di automazione
└── backups/                       # Backup del progetto

---

🚀 AVVIO RAPIDO

1. Accesso al Sistema

# RDP (Raccomandato per sviluppo)
mstsc /v:192.168.0.200:3389

# SSH (Per comandi rapidi)
ssh netgescon@192.168.0.200

2. Avvio Ambiente di Sviluppo

# Naviga nella directory del progetto
cd ~/netgescon/netgescon-laravel

# Avvia Laravel
php artisan serve --host=0.0.0.0 --port=8000

3. Accesso all'Applicazione

• URL Principale: http://192.168.0.200:8000
• Admin Panel: http://192.168.0.200:8000/admin
• Login: admin@example.com / password

---

🔧 CONFIGURAZIONE AMBIENTE

Database

# Configurazione in .env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=netgescon
DB_USERNAME=netgescon_user
DB_PASSWORD=netgescon_password

# Comandi utili
php artisan migrate              # Esegui migrazioni
php artisan db:seed             # Popola dati di test
php artisan migrate:fresh --seed # Reset completo DB

Server Web

# Apache configurazione
sudo a2ensite netgescon.conf
sudo systemctl reload apache2

# Permessi directory
sudo chown -R www-data:www-data ~/netgescon/netgescon-laravel
sudo chmod -R 755 ~/netgescon/netgescon-laravel

---

🎛️ FUNZIONALITÀ PRINCIPALI

📊 Dashboard

• Panoramica generale sistema
• Statistiche stabili e inquilini
• Notifiche e alert
• Grafici di riepilogo

🏢 Gestione Stabili

• Anagrafica stabili: Dati identificativi e catastali
• Struttura: Gestione scale, piani, unità immobiliari
• Amministratori: Assegnazione e gestione
• Documenti: Upload e gestione documentazione

👥 Gestione Persone

• Inquilini: Anagrafica completa, contratti, scadenze
• Proprietari: Gestione proprietà e quote millesimali
• Amministratori: Credenziali e abilitazioni
• Fornitori: Anagrafica e servizi

💰 Gestione Economica

• Fatturazione: Creazione e invio fatture
• Contabilità: Registrazione movimenti
• Budget: Previsioni e consuntivi
• Reportistica: Bilanci e rendiconti

🔐 Sicurezza e Accessi

• Autenticazione: Login multi-ruolo
• Autorizzazioni: Controllo accessi per funzione
• Audit Trail: Log delle operazioni
• Backup: Backup automatici configurabili

---

🛠️ STRUMENTI DI SVILUPPO

IDE Configurato

• VS Code con estensioni Laravel
• GitHub Copilot per assistenza AI
• PHP Intelephense per autocomplete
• Laravel Blade Snippets
• Git integration per version control

Testing

# Test unitari
php artisan test

# Test specifici
php artisan test --filter=StabileTest

# Coverage
php artisan test --coverage

Debugging

# Log Laravel
tail -f storage/logs/laravel.log

# Debug queries
php artisan tinker
DB::enableQueryLog();
# ... esegui operazioni ...
DB::getQueryLog();

---

📁 SCRIPT UTILI

Setup Sviluppo

# Script nella cartella 03-scripts-automazione/
./docs/03-scripts-automazione/setup-complete-environment.sh

Backup

# Backup completo
./docs/03-scripts-automazione/manage-database.sh

Sincronizzazione

# Sync con repository remoto
./docs/03-scripts-automazione/sync-bidirectional.sh

---

🔍 RISOLUZIONE PROBLEMI

Problemi Comuni

1. Errori di Permessi

sudo chown -R www-data:www-data ~/netgescon/netgescon-laravel
sudo chmod -R 755 ~/netgescon/netgescon-laravel
sudo chmod -R 775 storage bootstrap/cache

2. Errori Database

# Ricrea database
php artisan migrate:fresh --seed

# Reset configurazione
php artisan config:clear
php artisan cache:clear

3. Errori Composer

# Rigenera autoload
composer dump-autoload

# Installa dipendenze mancanti
composer install

4. Errori Laravel

# Pulisci cache
php artisan optimize:clear

# Rigenera chiavi
php artisan key:generate

Log e Debugging

# Log Laravel
tail -f ~/netgescon/netgescon-laravel/storage/logs/laravel.log

# Log Apache
sudo tail -f /var/log/apache2/error.log

# Log MySQL
sudo tail -f /var/log/mysql/error.log

---

📚 DOCUMENTAZIONE

Manuali Disponibili

• 📖 Manuale Principale: docs/00-MANUALE-COMPLETO-NETGESCON-UNIFICATO.md
• ⚙️ Manuali Aggiuntivi: docs/01-manuali-aggiuntivi/
• 🏗️ Architettura: docs/02-architettura-laravel/

Documentazione Tecnica

• Strutture Database: docs/04-DATABASE-STRUTTURE.md
• Interfaccia Universale: docs/05-INTERFACCIA-UNIVERSALE.md
• Sistema Multi-Ruolo: docs/06-SISTEMA-MULTI-RUOLO.md

Immagini e Screenshot

• Screenshot Debug: docs/images/
• Setup VM: docs/images/vm-setup/
• Schermate Ufficiali: docs/images/schermate-ufficiali/

---

🔄 WORKFLOW DI SVILUPPO

1. Feature Development

# Crea nuovo branch
git checkout -b feature/nome-feature

# Sviluppa e testa
# ... sviluppo ...
php artisan test

# Commit e push
git add .
git commit -m "Add: nuova feature"
git push origin feature/nome-feature

2. Code Review

• Usa GitHub PR per review del codice
• Esegui test automatici
• Valida con GitHub Copilot

3. Deploy

# Deploy su staging
./docs/03-scripts-automazione/quick-deploy.sh

# Deploy su produzione (dopo test)
./docs/03-scripts-automazione/setup-complete-environment.sh

---

🎯 ONBOARDING CHECKLIST

Per Nuovi Sviluppatori

• Accesso RDP/SSH configurato
• VS Code + Copilot installato
• Progetto clonato e dipendenze installate
• Database configurato e migrato
• Test eseguiti con successo
• Documentazione letta
• Primo commit effettuato

Per GitHub Copilot/AI

• Struttura progetto analizzata
• Modelli e relazioni compresi
• Pattern architetturali identificati
• Test suite esaminata
• Documentazione API studiata
• Convenzioni di codice apprese

---

📞 SUPPORTO E CONTATTI

Risorse di Aiuto

• GitHub Copilot: Assistenza in tempo reale nel codice
• Laravel Docs: https://laravel.com/docs
• Stack Overflow: Tag laravel per domande specifiche

Comandi di Emergenza

# Restart completo servizi
sudo systemctl restart apache2 mysql

# Reset ambiente sviluppo
./docs/03-scripts-automazione/repair-database.sh

# Backup di emergenza
./docs/03-scripts-automazione/manage-database.sh

---

📈 ROADMAP E TODO

Immediate (Prossime 2 settimane)

• Completare test suite
• Implementare API REST complete
• Aggiungere validazione frontend
• Ottimizzare performance query

Breve Termine (1-2 mesi)

• Interfaccia mobile-responsive
• Sistema notifiche email
• Integrazione sistemi contabili
• Report avanzati

Lungo Termine (3-6 mesi)

• App mobile nativa
• Integrazione IoT (smart meters)
• AI per previsioni economiche
• Multi-tenant architecture

---

📝 Ultimo aggiornamento: 18 Luglio 2025 🤖 Documentazione unificata in cartella docs/