# 🏢 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

## � **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.)

### � **Area Finanziaria**

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

### � **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>