153 lines
5.1 KiB
Markdown
Executable File
153 lines
5.1 KiB
Markdown
Executable File
# 🏢 NetGescon - Sistema di Gestione Condominiale
|
||
|
||
> **Sistema Unificato** per la gestione completa di condomini, stabili, unità immobiliari e amministrazione condominiale.
|
||
|
||
## Nota Operativa Day0
|
||
|
||
Questo repository e questo workspace sono la sola base attiva di sviluppo, test, commit, push e distribuzione.
|
||
|
||
- Workspace attivo: `/home/michele/netgescon/netgescon-day0`
|
||
- Documentazione autorevole: `/home/michele/netgescon/netgescon-day0/docs`
|
||
- Repository Git da usare: `netgescon-day0`
|
||
- La cartella storica `netgescon-laravel` va considerata archivio tecnico e non base di lavoro corrente.
|
||
|
||
Se un documento riporta path o workflow precedenti, prevalgono sempre le regole Day0.
|
||
|
||
## 📎 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 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.
|
||
- `OPERATIVITA-STUDIO-COLLABORATORI-POSTA.md` – flusso operativo per collaboratori studio, filtri SMDR/Post-It e roadmap posta Google/IMAP via web.
|
||
- `ANAGRAFE-CONDOMINIALE-PORTALE-POSTA.md` – base tecnica e operativa per anagrafe self-service, recapiti email per servizio e primo aggancio posta-ticket.
|
||
|
||
## 📁 Struttura Progetto (workspace)
|
||
|
||
- `/home/michele/netgescon/netgescon-day0` – app Laravel principale e repository Git attivo
|
||
- `/home/michele/netgescon/netgescon-day0/docs` – documentazione attuale e autorevole
|
||
- `/home/michele/netgescon/netgescon-day0/scripts` – script operativi del workspace attivo
|
||
- `netgescon-laravel` – archivio storico, non base attiva per sviluppo o distribuzione
|
||
|
||
## ✨ **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
|
||
|
||
---
|
||
|
||
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>
|