netgescon-master/docs

🏢 NetGescon - Sistema di Gestione Condominiale

Sistema Unificato per la gestione completa di condomini, stabili, unità immobiliari e amministrazione condominiale.

<EFBFBD> Descrizione

NetGescon è una piattaforma web sviluppata in Laravel per la gestione completa di condomini e amministrazioni condominiali. Il sistema offre funzionalità avanzate per:

• 🏢 Gestione Stabili - Anagrafica completa con dati catastali, bancari e multi-palazzine
• 👥 Anagrafica Condomini - Gestione proprietari, inquilini e deleghe
• 💰 Gestione Finanziaria - Conti, budget, spese e ripartizioni
• 📄 Documentale - Archiviazione digitale documenti e pratiche
• 📊 Reports - Bilanci, estratti conto, comunicazioni
• 🔐 Sicurezza - Sistema autenticazione multi-ruolo

<EFBFBD> Tecnologie

• Backend: Laravel 10.x + PHP 8.1+
• Database: MySQL/MariaDB
• Frontend: Bootstrap 5 + Blade Templates
• Sicurezza: Spatie Permissions + Custom Auth

🛠️ Installazione

📋 Prerequisiti

• PHP 8.1+
• Composer
• MySQL/MariaDB
• Node.js + NPM (per asset)

⚡ Setup Rapido

# Clone del repository
git clone [repository-url]
cd netgescon

# Setup Laravel
cd laravel
composer install
cp .env.example .env
php artisan key:generate

# Database
php artisan migrate:fresh --seed

# Avvio server
php artisan serve --host=0.0.0.0 --port=8000

🔑 Primo Accesso

• URL: http://localhost:8000
• Email: admin@example.com
• Password: password

📁 Struttura Progetto

netgescon/
├── laravel/                    # Applicazione Laravel principale
│   ├── app/                    # Logic applicazione
│   ├── resources/views/        # Template Blade
│   ├── database/              # Migrazioni e seeder
│   └── public/                # Assets pubblici
├── scripts/                   # Script Python import/export
├── backup/                    # Backup database
└── README.md                  # Questo file

✨ Funzionalità Principali

🏢 Gestione Stabili

• Anagrafica completa con dati catastali
• Multi-palazzine per complessi residenziali
• Gestione dati bancari e coordinate IBAN
• Upload documenti e planimetrie

👥 Anagrafica Condominiale

• Proprietari e inquilini
• Cariche e deleghe amministrative
• Storico variazioni quote millesimali
• Gestione incarichi (portiere, pulizie, etc.)

<EFBFBD> Area Finanziaria

• Conti correnti multipli
• Budget preventivi e consuntivi
• Ripartizione spese per criterio
• Estratti conto e solleciti

<EFBFBD> Reports e Stampe

• Bilanci consuntivi
• Situazione debitoria
• Comunicazioni personalizzate
• Export Excel/PDF

🔧 Comandi Utili

# Reset database completo
php artisan migrate:fresh --seed

# Solo seeder amministratore
php artisan db:seed --class=MikiAdminSeeder

# Clear cache
php artisan optimize:clear

# Debug in tempo reale
tail -f storage/logs/laravel.log

🤝 Contributi

Per contribuire al progetto:

1. Fork del repository
2. Creazione branch feature (git checkout -b feature/nome-feature)
3. Commit modifiche (git commit -am 'Aggiunta nuova feature')
4. Push del branch (git push origin feature/nome-feature)
5. Creazione Pull Request

📄 Licenza

Questo progetto è rilasciato sotto licenza MIT. Vedi il file LICENSE per i dettagli.

📞 Supporto

Per supporto tecnico o domande:

• Issues: Usa il sistema issues di GitHub
• Email: info@netgescon.it
• Documentazione: Disponibile nel repository

---

🏢 NetGescon - Sistema di Gestione Condominiale Unificato
📧 Info: info@netgescon.it | 🌐 Demo: https://demo.netgescon.it