# 🏢 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` - Remote Git principale: `origin -> ssh://git@192.168.0.53:2222/michele/netgescon-day0.git` - Branch operativo corrente: `main` - 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. ## Flusso operativo reale Git -> Gitea -> Staging Il flusso di aggiornamento attivo di NetGescon non prevede deploy manuali ad hoc da terminale verso staging come canale principale. Pipeline da seguire: 1. sviluppo e test nel workspace `netgescon-day0` 2. commit locale Git sul repository `netgescon-day0` 3. push su Gitea interno (`origin`) 4. allineamento di staging dal repository Gitea 5. stesso meccanismo per gli altri siti/nodi Regole operative: - la fonte di verita del codice e Gitea - staging va aggiornato allineando il codice pubblicato su Gitea - ogni documento che suggerisce un deploy diretto macchina -> staging va considerato superato, salvo emergenze operative - la distribuzione commerciale multi-canale non e ancora il flusso attivo principale ## Stato distribuzione attuale - modello attivo: distribuzione unica via Git/Gitea - canali commerciali `free` e `licensed`: infrastruttura prevista ma non ancora flusso operativo principale - il valore `free` presente in alcune config va interpretato oggi come placeholder tecnico, non come conferma del modello commerciale definitivo ## 📎 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:** - **Email:** - **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 ``` ## Git e collaborazione Flusso minimo consigliato: 1. aggiornare il workspace attivo `netgescon-day0` 2. verificare stato con `git status` 3. creare commit coerenti e leggibili 4. fare push su `origin` 5. allineare staging dal repository Gitea Quando serviranno branch dedicati, release o tag, vanno gestiti sempre dentro Gitea e non con copie manuali fuori flusso. ## Licenza e distribuzione - esiste una infrastruttura di distribuzione gia predisposta nel codice - il modello commerciale definitivo non va dato per concluso solo leggendo le config correnti - fino a nuova decisione operativa, la documentazione deve descrivere prima il flusso Git/Gitea reale e solo dopo gli scenari futuri ## Supporto e riferimenti - documentazione operativa: `docs/` - repository autorevole: Gitea interno - issue tracking e flusso di aggiornamento: da riallineare al sistema Gitea interno --- 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: | 🌐 Demo: