480e7eafbd
📋 Commit iniziale con: - ✅ Documentazione unificata in docs/ - ✅ Codice Laravel in netgescon-laravel/ - ✅ Script automazione in scripts/ - ✅ Configurazione sync rsync - ✅ Struttura organizzata e pulita 🔄 Versione: 2025.07.19-1644 🎯 Sistema pronto per Git distribuito
134 lines
3.7 KiB
Markdown
134 lines
3.7 KiB
Markdown
# 🏢 NetGescon - Sistema di Gestione Condominiale
|
||
|
||
> **Sistema Unificato** per la gestione completa di condomini, stabili, unità immobiliari e amministrazione condominiale.
|
||
|
||
## <20> **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
|
||
|
||
## <20> **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**
|
||
```bash
|
||
# 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.)
|
||
|
||
### <20> **Area Finanziaria**
|
||
- Conti correnti multipli
|
||
- Budget preventivi e consuntivi
|
||
- Ripartizione spese per criterio
|
||
- Estratti conto e solleciti
|
||
|
||
### <20> **Reports e Stampe**
|
||
- Bilanci consuntivi
|
||
- Situazione debitoria
|
||
- Comunicazioni personalizzate
|
||
- Export Excel/PDF
|
||
|
||
## 🔧 **Comandi Utili**
|
||
|
||
```bash
|
||
# 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 |