# NetGesCon - Documentazione Unificata

## 📋 Panoramica del Progetto

NetGesCon è un sistema di gestione condominiale completo con interfaccia web unificata, autenticazione centralizzata e gestione dinamica dei permessi.

**🎯 STATO ATTUALE:** Preparazione per messa online prossima settimana con Docker deployment

## 📁 Struttura Documentazione

### 📋 `/docs/specifiche/` (PRIVATE - Solo team interno)
Contiene tutte le specifiche tecniche, requisiti, analisi e documentazione di sviluppo:
- **🎯 INDICE_PROGETTO.md** - **ENTRY POINT PRINCIPALE** 
- **MENU_MAPPING.md** - Mappatura completa menu e permessi
- **DATABASE_SCHEMA.md** - Schema database completo
- **API_ENDPOINTS.md** - Documentazione API completa
- **DOCKER_DEPLOYMENT.md** - Specifiche deployment (PRIORITÀ ALTA)
- **UI_COMPONENTS.md** - Componenti interfaccia unificata
- Altri 20+ file di specifiche tecniche dettagliate...

### 📊 `/docs/logs/` (PRIVATE - Solo team interno)
Log di sviluppo, test e problemi risolti:
- **PROGRESS_LOG.md** - Log dettagliato progresso sviluppo
- **TEST_PLAN.md** - Piano di test completo  
- **CREDENZIALI_TEST.md** - Credenziali per test
- Report di test e debugging vari

### ✅ `/docs/checklist/` (PRIVATE - Solo team interno)
Checklist operative e di controllo:
- **CHECKLIST_FINALE.md** - Checklist master per rilascio
- **CHECKLIST_MENU_CRUD.md** - Checklist conversione interfacce
- **CHECKLIST_INIZIALE.md** - Checklist setup iniziale

### 📖 `/docs/guide/` (PUBLIC - Accessibile esternamente)
Guide operative per utenti e sviluppatori esterni:
- **install-guide.md** - Guida installazione
- **api-guide.md** - Documentazione API per collaboratori esterni  
- **deploy-guide.md** - Procedura deployment base

## 🚀 Quick Start

1. **Per sviluppatori**: Inizia leggendo `/docs/specifiche/INDICE_PROGETTO.md`
2. **Per amministratori**: Consulta `/docs/guide/admin-guide.md`
3. **Per il deployment**: Segui `/docs/guide/deploy-guide.md`

## 🔧 Procedura di Aggiornamento Specifiche

### Per Team Interno:
1. Modifica i file in `/docs/specifiche/`
2. Aggiorna sempre `PROGRESS_LOG.md` con le modifiche
3. Mantieni aggiornato `INDICE_PROGETTO.md`
4. Committa solo i file essenziali (vedi `.gitignore`)

### Per Collaboratori Esterni:
1. Accesso solo ai file pubblici del repository
2. Le specifiche interne rimangono private
3. Documentazione API disponibile in `/docs/guide/api-guide.md`

## 📞 Contatti e Supporto

- **Sviluppatore principale**: Michele
- **Repository**: [GitHub Repository URL]
- **Documentazione tecnica**: `/docs/specifiche/`

## 🤝 **COME COMUNICARE CON L'AI**

### 📋 **Protocollo di Comunicazione**
Per garantire che l'AI segua sempre le nostre specifiche, usa questo formato:

```
NETGESCON-SPEC: [descrizione del task]
RIFERIMENTO: [file specifico da consultare]
OBIETTIVO: [cosa deve fare l'AI]
CONTESTO: [eventuali info aggiuntive]
```

### 🔑 **Parole Chiave Principali:**
- **NETGESCON-SPEC** - Consulta le specifiche
- **BIBBIA-PROGETTO** - Usa l'indice come riferimento
- **LAYOUT-UNIVERSALE** - Lavori su interfaccia Bootstrap
- **DOCKER-DEPLOY** - Preparazione deployment
- **MENU-DINAMICO** - Lavori su menu e permessi

### 📖 **Documentazione Completa:**
Leggi `/docs/PROTOCOLLO_COMUNICAZIONE.md` per i dettagli completi.

---
*Ultimo aggiornamento: ${new Date().toLocaleDateString('it-IT')}*
