michele/netgescon-day0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
netgescon-day0/docs/README.md

7.7 KiB
Executable File
Raw Permalink Blame History

🏢 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

🧭 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).
  • support/MANUALE-SVILUPPO-OPERATIVO.md – manuale operativo strutturale per sviluppo, update e continuita delle sessioni.
  • 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