# 📚 INDICE MANUALI OPERATIVI NETGESCON

> **🎯 Manuali pratici** per utilizzo quotidiano sistema NetGescon  
> **🔗 Master Index:** [`../../00-INDICE-MASTER-NETGESCON.md`](../../00-INDICE-MASTER-NETGESCON.md)  
> **📅 Aggiornato:** 15/07/2025

---

## 🧭 **NAVIGAZIONE RAPIDA**

### 🆘 **EMERGENZA** (Leggi PRIMA in caso di problemi)
- ⚡ [`../QUICK-REFERENCE-CARD.md`](../QUICK-REFERENCE-CARD.md) - **Comandi salvavita**
- 🔧 [`INTERFACCIA-UNICA-TROUBLESHOOTING.md`](INTERFACCIA-UNICA-TROUBLESHOOTING.md) - **Fix layout/dashboard** 
- 📚 [`ARCHIVI-DATABASE-BIBBIA.md`](ARCHIVI-DATABASE-BIBBIA.md) - **Bibbia archivi**

### 📖 **DOCUMENTAZIONE TECNICA**
- 📋 [`../00-INDICE-GENERALE.md`](../00-INDICE-GENERALE.md) - Indice documentazione tecnica
- 🗺️ [`../ROADMAP.md`](../ROADMAP.md) - Piano sviluppo
- ✅ [`../checklists/CHECKLIST-IMPLEMENTAZIONE.md`](../checklists/CHECKLIST-IMPLEMENTAZIONE.md) - Task completati

---

## 📋 **MANUALI DISPONIBILI**

### 🔧 **INTERFACCIA E TROUBLESHOOTING**
| Manual | Descrizione | Stato | Link |
|--------|-------------|-------|------|
| 🎨 Interfaccia Unica | Fix layout, dashboard, sidebar | ✅ Completo | [`INTERFACCIA-UNICA-TROUBLESHOOTING.md`](INTERFACCIA-UNICA-TROUBLESHOOTING.md) |
| 🔄 Loading & Progress | Progress bar, fix spostamenti | ✅ Completo | Sezione in Interfaccia Unica |
| 🏠 Dashboard Guest | Fix view mancante | ✅ Completo | Sezione in Interfaccia Unica |

### 📊 **ARCHIVI E DATABASE**
| Manual | Descrizione | Stato | Link |
|--------|-------------|-------|------|
| 📚 Bibbia Archivi | Database, import, installazione | ✅ Completo | [`ARCHIVI-DATABASE-BIBBIA.md`](ARCHIVI-DATABASE-BIBBIA.md) |
| 🗄️ Import Dati | Procedura import archivi reali | ✅ Completo | Sezione in Bibbia Archivi |
| 💾 Backup | Procedure backup/restore | ✅ Completo | Sezione in Bibbia Archivi |

### 🏢 **GESTIONE STABILI**
| Manual | Descrizione | Stato | Link |
|--------|-------------|-------|------|
| 🏗️ Form Stabili | Form avanzata tab, multi-palazzine | ✅ Completo | Sezione in Interfaccia Unica |
| 🏦 Dati Bancari | Gestione IBAN, banche | ✅ Completo | Sezione in Form Stabili |
| 🏘️ Multi-Palazzine | Tabella Excel-like palazzine | ✅ Completo | Sezione in Form Stabili |

### 👥 **UTENTI E RUOLI**
| Manual | Descrizione | Stato | Link |
|--------|-------------|-------|------|
| 🔑 Amministratore | Setup admin Miki, ruoli | ✅ Completo | Sezione in Bibbia Archivi |
| 👤 Ruolo Condomino | Fix errore ruolo mancante | ✅ Completo | Sezione in Bibbia Archivi |
| 🛡️ Autenticazione | Sistema login/logout | 📋 In planning | TBD |

---

## ⚡ **QUICK START**

### 🚀 **Primo accesso al sistema:**
1. **Avvia Laravel:** `cd laravel && php artisan serve --host=0.0.0.0 --port=8000`
2. **Login:** admin@example.com / password
3. **Problemi?** 👉 [`INTERFACCIA-UNICA-TROUBLESHOOTING.md`](INTERFACCIA-UNICA-TROUBLESHOOTING.md)

### 🔧 **Problema layout/dashboard:**
1. **Dashboard si sposta?** 👉 Sezione "Fix Spostamento Layout" in troubleshooting
2. **Loading invasivo?** 👉 Sezione "Progress Bar Footer" in troubleshooting
3. **View guest mancante?** 👉 Sezione "Fix Dashboard Guest" in troubleshooting

### 📊 **Import dati archivi:**
1. **Preparazione:** 👉 [`ARCHIVI-DATABASE-BIBBIA.md`](ARCHIVI-DATABASE-BIBLIA.md) - Sezione "Installazione Pulita"
2. **Import:** 👉 Sezione "Import Dati Reali" in bibbia archivi
3. **Troubleshooting:** 👉 Sezione "Errori Comuni" in bibbia archivi

---

## 📝 **STRUTTURA MANUALI**

### 🎯 **Ogni manuale contiene:**
- **🎪 Panoramica** - Scopo e contesto
- **⚡ Quick Fix** - Soluzioni immediate
- **🔧 Procedure dettagliate** - Step-by-step
- **🚨 Troubleshooting** - Errori comuni
- **📋 Checklist** - Verifica completamento
- **🔗 Riferimenti** - Link correlati

### 📂 **Convenzioni file:**
- `MAIUSCOLO-CON-TRATTINI.md` per i manuali principali
- Sezioni numerate per navigazione rapida
- Link incrociati tra manuali
- Emoji per identificazione rapida sezioni

---

## 🔄 **AGGIORNAMENTI MANUALI**

### ✅ **Ultima modifica (15/07/2025):**
- ✅ Creato manuale Interfaccia Unica Troubleshooting
- ✅ Creato manuale Bibbia Archivi Database  
- ✅ Aggiornato Quick Reference Card
- ✅ Collegato all'Indice Master unificato

### 📋 **Prossimi manuali:**
- [ ] **GESTIONE-UNITA-IMMOBILIARI.md** - Gestione appartamenti
- [ ] **ANAGRAFICA-CONDOMINI.md** - Gestione proprietari
- [ ] **SISTEMA-CONTABILE.md** - Contabilità condominiale
- [ ] **REPORTS-STAMPE.md** - Report e stampe
- [ ] **BACKUP-RESTORE.md** - Procedure backup
- [ ] **API-USAGE.md** - Utilizzo API REST

---

## 📞 **SUPPORTO**

### 🆘 **In caso di problemi:**
1. **Step 1:** Controlla [`../QUICK-REFERENCE-CARD.md`](../QUICK-REFERENCE-CARD.md)
2. **Step 2:** Leggi il manuale specifico (tabella sopra)
3. **Step 3:** Consulta [`../logs/`](../logs/) per log recenti
4. **Step 4:** Controlla [`../../00-INDICE-MASTER-NETGESCON.md`](../../00-INDICE-MASTER-NETGESCON.md)

### 📧 **Contatti:**
- **Michele** - Lead Developer
- **Miki** - Domain Expert & Admin (admin@example.com)

---

> **💡 TIP:** Ogni volta che risolvi un problema, aggiorna il manuale corrispondente!  
> **🔄 Mantieni** questo indice sempre aggiornato con nuovi manuali.

---

**🏢 NetGescon** - Manuali Operativi  
**🔗 Master:** [`../../00-INDICE-MASTER-NETGESCON.md`](../../00-INDICE-MASTER-NETGESCON.md)
