189 lines
7.7 KiB
Markdown
Executable File
189 lines
7.7 KiB
Markdown
Executable File
# 🏢 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
|
||
|
||
## <20> **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).
|
||
- `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.)
|
||
|
||
### <20> **Area Finanziaria**
|
||
|
||
- Conti correnti multipli
|
||
- Budget preventivi e consuntivi
|
||
- Ripartizione spese per criterio
|
||
- Estratti conto e solleciti
|
||
|
||
### <20> **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: <info@netgescon.it> | 🌐 Demo: <https://demo.netgescon.it>
|