171 lines
8.5 KiB
Markdown
Executable File
171 lines
8.5 KiB
Markdown
Executable File
# 📚 NETGESCON - DOCUMENTAZIONE UNIFICATA
|
||
## 🧭 Indice Completo Cartella DOCS
|
||
|
||
> **🎯 DOCUMENTAZIONE PRINCIPALE** del progetto NetGescon
|
||
> **📍 Posizione:** `~/netgescon/docs/`
|
||
> **🔄 Aggiornato:** 30/11/2025 - Log automatici & ripartenza import
|
||
|
||
---
|
||
|
||
## 🚀 Novità 30/11/2025
|
||
|
||
- **Log automatici disponibili** in `docs/automation/`: post-commit (`commit-log/`), snapshot giornalieri (`daily/`), protocollo handoff.
|
||
- **Indice README aggiornato** con collegamenti rapidi a import unità e scheda anagrafica.
|
||
- **Focus ripartenza import**: usa `docs/07-IMPORT-UNITA-IMMOBILIARI.md` + `docs/08-ANAGRAFICA-UNICA-UI.md` per riallineare pipeline e UI.
|
||
|
||
---
|
||
|
||
## 🤖 **DOCUMENTI CHIAVE PER GITHUB COPILOT/AI**
|
||
|
||
> **🎯 START HERE** - Se sei un altro GitHub Copilot che deve continuare questo progetto:
|
||
|
||
### 📋 **DOCUMENTI CHIAVE PRONTI**
|
||
1. [`00-COPILOT-HANDOFF-MASTER.md`](00-COPILOT-HANDOFF-MASTER.md) - **🤖 INIZIA QUI - Handoff completo**
|
||
2. [`00-COPILOT-MASTER-GUIDE.md`](00-COPILOT-MASTER-GUIDE.md) - **🤖 Guida completa per AI**
|
||
3. [`00-transizione-linux/README-TRANSITION-COMPLETE.md`](00-transizione-linux/README-TRANSITION-COMPLETE.md) - **🔑 Guida transizione completa**
|
||
4. [`00-transizione-linux/FEATURES-INVENTORY-COMPLETE.md`](00-transizione-linux/FEATURES-INVENTORY-COMPLETE.md) - **📊 Inventario funzionalità**
|
||
5. [`INVENTARIO-UNIFICAZIONE-FINALE.md`](INVENTARIO-UNIFICAZIONE-FINALE.md) - **📋 Report unificazione**
|
||
6. [`00-transizione-linux/DEPLOYMENT-GUIDE-COMPLETE.md`](00-transizione-linux/DEPLOYMENT-GUIDE-COMPLETE.md) - **🚀 Guida deployment**
|
||
|
||
### ⚡ **QUICK START WORKFLOW**
|
||
1. Leggi [`00-COPILOT-MASTER-GUIDE.md`](00-COPILOT-MASTER-GUIDE.md) per capire tutto il contesto
|
||
2. Controlla [`00-transizione-linux/README-TRANSITION-COMPLETE.md`](00-transizione-linux/README-TRANSITION-COMPLETE.md) per lo stato attuale
|
||
3. Usa [`INVENTARIO-UNIFICAZIONE-FINALE.md`](INVENTARIO-UNIFICAZIONE-FINALE.md) per vedere cosa è stato fatto
|
||
4. Continua lo sviluppo senza perdere dati/autenticazione/struttura
|
||
|
||
---
|
||
|
||
## 📂 STRUTTURA DOCUMENTAZIONE PRINCIPALE
|
||
|
||
### 📖 **DOCUMENTAZIONE CORE** (Cartella principale)
|
||
- [`00-PIANO-LAVORO-MASTER.md`](00-PIANO-LAVORO-MASTER.md) - **🚀 PIANO DI LAVORO COMPLETO**
|
||
- [`00-COPILOT-MASTER-GUIDE.md`](00-COPILOT-MASTER-GUIDE.md) - **🤖 GUIDA PER GITHUB COPILOT**
|
||
- [`00-MANUALE-COMPLETO-NETGESCON-UNIFICATO.md`](00-MANUALE-COMPLETO-NETGESCON-UNIFICATO.md) - **📖 Manuale principale**
|
||
- [`00-INDICE-MASTER-NETGESCON.md`](00-INDICE-MASTER-NETGESCON.md) - **🧭 Indice master progetto**
|
||
- [`INVENTARIO-UNIFICAZIONE-FINALE.md`](INVENTARIO-UNIFICAZIONE-FINALE.md) - **📋 Report unificazione**
|
||
- [`04-DATABASE-STRUTTURE.md`](04-DATABASE-STRUTTURE.md) - Strutture database
|
||
- [`05-INTERFACCIA-UNIVERSALE.md`](05-INTERFACCIA-UNIVERSALE.md) - Interfaccia universale
|
||
- [`06-SISTEMA-MULTI-RUOLO.md`](06-SISTEMA-MULTI-RUOLO.md) - Sistema utenti e ruoli
|
||
- [`07-API-INTEGRAZIONI.md`](07-API-INTEGRAZIONI.md) - API e integrazioni
|
||
- [`08-FRONTEND-UX.md`](08-FRONTEND-UX.md) - Frontend e UX
|
||
- [`docs/automation/HANDOFF-PROTOCOL.md`](automation/HANDOFF-PROTOCOL.md) - **📌 Checkout rapido dopo crash**
|
||
|
||
### 🐧 **00-TRANSIZIONE-LINUX** - *Materiali migrazione e transizione*
|
||
- [`README-TRANSITION-COMPLETE.md`](00-transizione-linux/README-TRANSITION-COMPLETE.md) - **🔑 GUIDA TRANSIZIONE COMPLETA**
|
||
- [`FEATURES-INVENTORY-COMPLETE.md`](00-transizione-linux/FEATURES-INVENTORY-COMPLETE.md) - **📊 INVENTARIO FUNZIONALITÀ**
|
||
- [`DEPLOYMENT-GUIDE-COMPLETE.md`](00-transizione-linux/DEPLOYMENT-GUIDE-COMPLETE.md) - **🚀 GUIDA DEPLOYMENT**
|
||
|
||
### 🛠️ **01-MANUALI-AGGIUNTIVI** - *Procedure e guide operative*
|
||
- `PROCEDURA_OPERATIVA.md` - Procedure operative standard
|
||
- `personalizzazione-tema.md` - Personalizzazione interfaccia
|
||
- `miki.md` - Note specifiche Miki
|
||
- `QUICK_REFERENCE_LARAVEL.md` - Reference rapido Laravel
|
||
- `checklist/` - Checklist operative
|
||
|
||
### 🏗️ **02-ARCHITETTURA-LARAVEL** - *Design e architettura sistema*
|
||
- `ARCHITETTURA_MODULARE_COMPLETATA.md` - **Architettura modulare**
|
||
- `RIEPILOGO_ARCHITETTURA_COMPLETATA.md` - **Riepilogo architettura**
|
||
- `PROTOCOLLO_COMUNICAZIONE.md` - Protocolli comunicazione
|
||
- `sidebar-modulare.md` - Sistema sidebar modulare
|
||
- `guide/` - Guide tecniche dettagliate
|
||
- `specifiche/` - Specifiche tecniche
|
||
|
||
### ⚙️ **03-SCRIPTS-AUTOMAZIONE** - *Script e automazione*
|
||
- `fix-vscode-install.sh` - **Fix installazione VS Code**
|
||
- `setup-*.sh` - Script setup ambiente
|
||
- `install-*.sh` - Script installazione componenti
|
||
- Altri script di automazione
|
||
|
||
### 💾 **04-MATERIALI-WINDOWS** - *Backup materiali Windows*
|
||
- Backup file temporanei Windows
|
||
- Materiali di transizione
|
||
|
||
### 📦 **05-BACKUP-UNIFICAZIONE** - *Backup processo unificazione*
|
||
- `DOCS-UNIFIED/` - Backup struttura precedente
|
||
|
||
### 🖼️ **IMAGES** - *Materiali visivi e screenshot*
|
||
- `danea-schermate/` - Screenshot DANEA
|
||
- `gescon-schermate/` - Screenshot GESCON
|
||
- `go-schermate/` - Screenshot GO
|
||
- `schermate-ufficiali/` - Screenshot ufficiali NetGescon
|
||
- `vm-setup/` - Screenshot setup VM
|
||
|
||
### 📁 **CARTELLE ESISTENTI** (Mantenute)
|
||
- `api/` - Documentazione API
|
||
- `000-IMPORT/` - Import dati (GESCON, CSV, MDB)
|
||
- [`000-IMPORT/README-IMPORT-PROCESS.md`](000-IMPORT/README-IMPORT-PROCESS.md) – Panoramica processo import
|
||
- [`000-IMPORT/01-GESCON/GUIDA-IMPORT-GESCON-MDB.md`](000-IMPORT/01-GESCON/GUIDA-IMPORT-GESCON-MDB.md) – Guida pratica import da Stabili.mdb (CF, catasto, bancari)
|
||
- `bug/` - **🐛 Gestione bug e problemi**
|
||
- `Bug UI Principale/` - Problemi interfaccia utente
|
||
- `Problemi da risolvere/` - Issue tracking
|
||
- `vista/` - Problemi visualizzazione
|
||
- `checklists/` - Checklist implementazione
|
||
- `logs/` - Log sviluppo e sessioni
|
||
- `manuals/` - Manuali dettagliati
|
||
- `moduli/` - Documentazione moduli
|
||
- `specifications/` - Specifiche tecniche
|
||
- `team/` - Documentazione team
|
||
- `versione/` - Gestione versioni
|
||
- `automation/` - Log automatici (commit mensili, summary giornalieri, protocollo handoff)
|
||
|
||
---
|
||
|
||
## 🏗️ Import Legacy & Anagrafica Unica
|
||
|
||
1. [`07-IMPORT-UNITA-IMMOBILIARI.md`](07-IMPORT-UNITA-IMMOBILIARI.md) – piano dettagliato per importare unità, soggetti, ruoli e pertinenze.
|
||
2. [`07-DATABASE-NETGESCON.md`](07-DATABASE-NETGESCON.md) – schema database con focus su tabelle `unita_immobiliari`, `proprieta`, `rubrica_*`.
|
||
3. [`08-ANAGRAFICA-UNICA-UI.md`](08-ANAGRAFICA-UNICA-UI.md) – specifica UX della scheda anagrafica con collegamento condominio ↔ unità ↔ soggetti.
|
||
4. [`GUIDA-IMPORT-DATI-REALI.md`](GUIDA-IMPORT-DATI-REALI.md) – procedure operative per portare i dataset reali nel nuovo flusso.
|
||
|
||
---
|
||
|
||
## 🎯 **NAVIGAZIONE RAPIDA PER SCENARIO**
|
||
|
||
### 🆘 **EMERGENZA/TROUBLESHOOTING**
|
||
1. [`00-MANUALE-COMPLETO-NETGESCON-UNIFICATO.md`](00-MANUALE-COMPLETO-NETGESCON-UNIFICATO.md)
|
||
2. [`01-manuali-aggiuntivi/QUICK_REFERENCE_LARAVEL.md`](01-manuali-aggiuntivi/QUICK_REFERENCE_LARAVEL.md)
|
||
3. [`logs/`](logs/) - Consultare log recenti
|
||
|
||
### 🚀 **PRIMO ACCESSO/ONBOARDING**
|
||
1. [`00-INDICE-MASTER-NETGESCON.md`](00-INDICE-MASTER-NETGESCON.md)
|
||
2. [`05-INTERFACCIA-UNIVERSALE.md`](05-INTERFACCIA-UNIVERSALE.md)
|
||
3. [`02-architettura-laravel/ARCHITETTURA_MODULARE_COMPLETATA.md`](02-architettura-laravel/ARCHITETTURA_MODULARE_COMPLETATA.md)
|
||
|
||
### 🔧 **SVILUPPO E MODIFICHE**
|
||
1. [`02-architettura-laravel/ARCHITETTURA_MODULARE_COMPLETATA.md`](02-architettura-laravel/ARCHITETTURA_MODULARE_COMPLETATA.md)
|
||
2. [`04-DATABASE-STRUTTURE.md`](04-DATABASE-STRUTTURE.md)
|
||
3. [`07-API-INTEGRAZIONI.md`](07-API-INTEGRAZIONI.md)
|
||
4. [`docs/automation/`](automation/) - Verifica log automatici prima di riprendere task sospesi
|
||
|
||
### 🐧 **DEPLOYMENT E LINUX**
|
||
1. [`03-scripts-automazione/`](03-scripts-automazione/) - Script setup
|
||
2. [`images/vm-setup/`](images/vm-setup/) - Screenshot configurazione
|
||
|
||
---
|
||
|
||
## 📊 **VANTAGGI STRUTTURA UNIFICATA**
|
||
|
||
### ✅ **Organizzazione**
|
||
- **Tutto in una cartella** - docs/ come punto unico
|
||
- **Categorizzazione chiara** - Sottocartelle per tipo materiale
|
||
- **Backward compatibility** - Struttura esistente mantenuta
|
||
- **Facilità navigazione** - Percorsi intuitivi
|
||
|
||
### 🤖 **Per GitHub Copilot/AI**
|
||
- **Contesto completo** - Accesso a tutto il materiale
|
||
- **Struttura logica** - AI comprende organizzazione
|
||
- **Cross-reference** - Collegamenti tra documenti
|
||
- **Onboarding ottimale** - Informazioni complete
|
||
|
||
---
|
||
|
||
> **💡 NOTA IMPORTANTE**
|
||
> Questa struttura **mantiene docs/ come standard** e **integra tutto il materiale** in modo organizzato.
|
||
> **Un'unica cartella, documentazione tracciata automaticamente, navigazione chiara.**
|
||
|
||
---
|
||
|
||
**🏢 NETGESCON** - Documentazione Unificata
|
||
**📅 Data Unificazione:** 18/07/2025
|
||
**🎯 Standard:** docs/ come riferimento principale
|