netgescon-day0/docs

🏢 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

<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).
• 00-INDICE-LAVORO-DISTRIBUITO.md – indice operativo dei cantieri condivisi tra macchine, agent e stream tecnici.
• support/MANUALE-SVILUPPO-OPERATIVO.md – manuale operativo strutturale per sviluppo, update e continuita delle sessioni.
• support/RETE-DOCS-E-AGENT-OPERATIVITA.md – regole pratiche per distribuire docs/ via Gitea su tutte le macchine della rete e far lavorare gli agent come un unico gruppo.
• support/PBX-PANASONIC-STATO-OPERATIVO.md – stato tecnico e operativo dell integrazione Panasonic CTI/CSTA e dei prossimi test PBX.
• support/ARCHITETTURA-STORAGE-TENANCY.md – decisione architetturale su isolamento file per amministratore/stabile e valutazione pragmatica del modello Docker per stabile.
• support/BUG-RISOLTI-E-VALIDAZIONI.md – registro sintetico bug corretti, fix applicati e verifiche ancora da completare.
• support/CONTINUITA-SVILUPPO-AGENT.md – procedura minima per mantenere allineati manuale, note commit e sviluppo con agent.
• support/FORNITORE-OPERATIVITA-ROADMAP-2026-04.md – roadmap operativa fornitore/manutentore: rubrica unica, ticket interni, lavori ricorrenti, TecnoRepair, catalogo prodotti e seriali.
• support/GERMANICO79-POSTA-ACQUA-2026-04.md – runbook operativo per il blocco GERMANICO 79: Gmail ufficiale, sync anagrafiche, import acqua 2024 e prossima estensione ticket-letture.
• 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.)

<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

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: info@netgescon.it | 🌐 Demo: https://demo.netgescon.it