480e7eafbd
📋 Commit iniziale con: - ✅ Documentazione unificata in docs/ - ✅ Codice Laravel in netgescon-laravel/ - ✅ Script automazione in scripts/ - ✅ Configurazione sync rsync - ✅ Struttura organizzata e pulita 🔄 Versione: 2025.07.19-1644 🎯 Sistema pronto per Git distribuito
119 lines
5.0 KiB
Markdown
119 lines
5.0 KiB
Markdown
# 📚 MANUALE COMPLETO NETGESCON - INDICE GENERALE
|
|
*Documentazione Tecnica Unificata del Sistema di Gestione Condominiale*
|
|
|
|
**Versione:** 2.0 - Modulare
|
|
**Data:** 17 Luglio 2025
|
|
**Ambiente:** Linux Ubuntu 24.04 LTS + Laravel 11 + MySQL 8.0
|
|
|
|
---
|
|
|
|
## 📋 **STRUTTURA MODULARE DOCUMENTAZIONE**
|
|
|
|
### **PARTE I - ARCHITETTURA E SETUP**
|
|
- [**01-ARCHITETTURA-SISTEMA.md**](01-ARCHITETTURA-SISTEMA.md) - Stack tecnologico, MVC Laravel, Database Schema
|
|
- [**02-INSTALLAZIONE-CONFIGURAZIONE.md**](02-INSTALLAZIONE-CONFIGURAZIONE.md) - Setup automatico, requisiti, configurazione
|
|
- [**03-MIGRAZIONE-LINUX.md**](03-MIGRAZIONE-LINUX.md) - Multi-VM Proxmox, sincronizzazione ambienti
|
|
- [**04-DATABASE-STRUTTURE.md**](04-DATABASE-STRUTTURE.md) - Schema completo, migrazioni, modelli Eloquent
|
|
|
|
### **PARTE II - SVILUPPO E INTERFACCIA**
|
|
- [**05-INTERFACCIA-UNIVERSALE.md**](05-INTERFACCIA-UNIVERSALE.md) - **[PRIORITARIO]** Layout, navigazione AJAX, helper menu
|
|
- [**06-SISTEMA-MULTI-RUOLO.md**](06-SISTEMA-MULTI-RUOLO.md) - Spatie Permissions, middleware, dashboard condizionali
|
|
- [**07-API-INTEGRAZIONI.md**](07-API-INTEGRAZIONI.md) - REST API, JSON responses, integrazione esterna
|
|
- [**08-FRONTEND-UX.md**](08-FRONTEND-UX.md) - Bootstrap 5, JavaScript, responsive design
|
|
|
|
### **PARTE III - FUNZIONALITÀ BUSINESS**
|
|
- [**09-GESTIONE-STABILI-CONDOMINI.md**](09-GESTIONE-STABILI-CONDOMINI.md) - CRUD stabili, unità immobiliari, anagrafica
|
|
- [**10-SISTEMA-CONTABILE.md**](10-SISTEMA-CONTABILE.md) - Movimenti bancari, bilanci, report
|
|
- [**11-GESTIONE-DOCUMENTI.md**](11-GESTIONE-DOCUMENTI.md) - Upload, storage, categorizzazione
|
|
- [**12-COMUNICAZIONI-TICKET.md**](12-COMUNICAZIONI-TICKET.md) - Sistema ticket, notifiche, email
|
|
|
|
### **PARTE IV - AMMINISTRAZIONE**
|
|
- [**13-CONFIGURAZIONE-UTENTI.md**](13-CONFIGURAZIONE-UTENTI.md) - Gestione utenti, ruoli, permessi
|
|
- [**14-BACKUP-SICUREZZA.md**](14-BACKUP-SICUREZZA.md) - Strategie backup, sicurezza, SSL
|
|
- [**15-MONITORAGGIO-LOG.md**](15-MONITORAGGIO-LOG.md) - Log sistema, monitoring, performance
|
|
- [**16-TROUBLESHOOTING.md**](16-TROUBLESHOOTING.md) - Problemi comuni, soluzioni, FAQ
|
|
|
|
### **PARTE V - SVILUPPO AVANZATO**
|
|
- [**17-ROADMAP-SVILUPPI-FUTURI.md**](17-ROADMAP-SVILUPPI-FUTURI.md) - Funzionalità future, AI integration
|
|
- [**18-PROCEDURE-SVILUPPO.md**](18-PROCEDURE-SVILUPPO.md) - Workflow Git, code review, standard
|
|
- [**19-TESTING-QA.md**](19-TESTING-QA.md) - Unit testing, integrazione, QA procedures
|
|
- [**20-DEPLOY-PRODUZIONE.md**](20-DEPLOY-PRODUZIONE.md) - Deployment, staging, produzione
|
|
|
|
---
|
|
|
|
## 🎯 **PRIORITÀ COMPLETAMENTO**
|
|
|
|
### **FASE 1 - CORE INTERFACE** (Settimana 1)
|
|
1. ✅ **05-INTERFACCIA-UNIVERSALE.md** - Layout universale, navigazione AJAX
|
|
2. ✅ **06-SISTEMA-MULTI-RUOLO.md** - Ruoli, permessi, dashboard condizionali
|
|
|
|
### **FASE 2 - ARCHITETTURA BASE** (Settimana 2)
|
|
3. **01-ARCHITETTURA-SISTEMA.md** - Stack tecnologico completo
|
|
4. **02-INSTALLAZIONE-CONFIGURAZIONE.md** - Setup automatizzato
|
|
5. **04-DATABASE-STRUTTURE.md** - Schema DB completo
|
|
|
|
### **FASE 3 - FUNZIONALITÀ BUSINESS** (Settimana 3)
|
|
6. **09-GESTIONE-STABILI-CONDOMINI.md** - Core business logic
|
|
7. **10-SISTEMA-CONTABILE.md** - Contabilità e movimenti
|
|
8. **11-GESTIONE-DOCUMENTI.md** - Sistema documentale
|
|
|
|
### **FASE 4 - COMPLETAMENTO** (Settimana 4)
|
|
9. **Resto dei capitoli** - API, frontend, amministrazione, deployment
|
|
|
|
---
|
|
|
|
## 📖 **COME USARE QUESTA DOCUMENTAZIONE**
|
|
|
|
### **Per Sviluppatori Nuovi:**
|
|
1. Leggi **01-ARCHITETTURA-SISTEMA.md** per overview
|
|
2. Segui **02-INSTALLAZIONE-CONFIGURAZIONE.md** per setup
|
|
3. Studia **05-INTERFACCIA-UNIVERSALE.md** per interfaccia
|
|
4. Consulta **06-SISTEMA-MULTI-RUOLO.md** per permessi
|
|
|
|
### **Per Modifiche Interfaccia:**
|
|
1. **05-INTERFACCIA-UNIVERSALE.md** - Layout, menu, navigazione
|
|
2. **08-FRONTEND-UX.md** - Styling, JavaScript, responsive
|
|
3. **07-API-INTEGRAZIONI.md** - AJAX, REST API
|
|
|
|
### **Per Funzionalità Business:**
|
|
1. **09-GESTIONE-STABILI-CONDOMINI.md** - CRUD entità principali
|
|
2. **10-SISTEMA-CONTABILE.md** - Contabilità e report
|
|
3. **11-GESTIONE-DOCUMENTI.md** - Upload e gestione file
|
|
|
|
### **Per Amministrazione Sistema:**
|
|
1. **13-CONFIGURAZIONE-UTENTI.md** - Gestione utenti
|
|
2. **14-BACKUP-SICUREZZA.md** - Backup e sicurezza
|
|
3. **15-MONITORAGGIO-LOG.md** - Monitoring e troubleshooting
|
|
|
|
---
|
|
|
|
## 🔧 **CONVENZIONI DOCUMENTAZIONE**
|
|
|
|
### **Formato File:**
|
|
- Tutti i file in formato Markdown (.md)
|
|
- Struttura gerarchica con indici
|
|
- Codice evidenziato con syntax highlighting
|
|
- Screenshot e diagrammi dove necessario
|
|
|
|
### **Naming Convention:**
|
|
- Prefisso numerico per ordinamento
|
|
- Nome descrittivo in CAPS
|
|
- Estensione .md
|
|
|
|
### **Struttura Capitoli:**
|
|
```
|
|
# TITOLO CAPITOLO
|
|
## 1. Sottocapitolo
|
|
### 1.1 Sezione
|
|
#### 1.1.1 Dettaglio
|
|
```
|
|
|
|
### **Riferimenti Incrociati:**
|
|
- Link relativi tra capitoli
|
|
- Riferimenti a file di codice
|
|
- Esempi pratici con path completi
|
|
|
|
---
|
|
|
|
**🚀 INIZIAMO CON IL CAPITOLO PIÙ IMPORTANTE: INTERFACCIA UNIVERSALE**
|