89 lines
3.3 KiB
Markdown
89 lines
3.3 KiB
Markdown
# 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')}*
|