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

5.1 KiB
Executable File
Raw 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
  • 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

<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).
  • 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

🤝 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