netgescon-day0/docs

🏢 NetGescon - Sistema di Gestione Condominiale

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

📎 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 12.x + PHP 8.3+
• Database: MySQL/MariaDB
• Frontend: Bootstrap 5 + Blade Templates
• Sicurezza: Spatie Permissions + Custom Auth

🛠️ Installazione

📋 Prerequisiti

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

⚡ Setup rapido

1. Installa dipendenze PHP: composer install
2. Copia env e chiave: cp .env.example .env; php artisan key:generate
3. Migrazioni/seed: php artisan migrate:fresh --seed
4. Avvio server: php artisan serve --host=0.0.0.0 --port=8000

🔑 Primo Accesso

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

🧭 Documentazione & Indici

• 00-COPILOT-HANDOFF-MASTER.md – handoff immediato per riprendere il lavoro dopo crash o cambio turno.
• 00-INDICE-DOCS-UNIFICATA.md – indice generale aggiornato (sezione “Automation” per log auto-generati).
• docs/automation/ – commit log mensile, summary giornalieri e protocollo handoff automatici.
• 07-IMPORT-UNITA-IMMOBILIARI.md – blueprint operativo per importare unità e collegare proprietari/inquilini.
• 08-ANAGRAFICA-UNICA-UI.md – specifica UX della scheda anagrafica unica e relativi widget condominiali.

📁 Struttura Progetto (workspace)

• /var/www/netgescon – app Laravel principale (PHP 8.3, Laravel 12)
• /home/michele/netgescon/docs – documentazione completa (vedi indici sopra)
• /home/michele/netgescon/scripts – script import/export e riconciliazioni

✨ 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

---

Link rapidi

• Guida import GESCON (Stabili.mdb): docs/000-IMPORT/01-GESCON/GUIDA-IMPORT-GESCON-MDB.md
• Piano import unità → anagrafica unica: docs/07-IMPORT-UNITA-IMMOBILIARI.md
• Specifica UI anagrafica unica: docs/08-ANAGRAFICA-UNICA-UI.md

—

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