# 🤝 PROTOCOLLO DI COMUNICAZIONE NETGESCON

## 📋 Come Comunicare con l'AI per il Progetto

### 🎯 **PAROLE CHIAVE ESSENZIALI**

Quando mi fai richieste, usa queste parole chiave per essere sicuro che io segua sempre le nostre specifiche:

#### 🔑 **Parole Chiave Principali:**
- **"NETGESCON-SPEC"** - Indica che devo consultare le specifiche
- **"BIBBIA-PROGETTO"** - Richiama l'indice progetto come riferimento
- **"LAYOUT-UNIVERSALE"** - Per modifiche al layout Bootstrap unificato
- **"MENU-DINAMICO"** - Per lavori sui menu e permessi
- **"DOCKER-DEPLOY"** - Per preparazione deployment

#### 📋 **Struttura Richiesta Ottimale:**
```
NETGESCON-SPEC: [descrizione del task]
RIFERIMENTO: [file specifico da consultare]
OBIETTIVO: [cosa devo fare]
CONTESTO: [eventuali info aggiuntive]
```

### 🗂️ **Mappa Riferimenti Rapidi**

#### 🎯 **Per Sviluppo Frontend:**
- **Parola chiave**: `LAYOUT-UNIVERSALE`
- **Riferimento**: `/docs/specifiche/UI_COMPONENTS.md`
- **Checklist**: `/docs/checklist/CHECKLIST_MENU_CRUD.md`

#### 🔧 **Per Sviluppo Backend:**
- **Parola chiave**: `API-NETGESCON`
- **Riferimento**: `/docs/specifiche/API_ENDPOINTS.md`
- **Schema**: `/docs/specifiche/DATABASE_SCHEMA.md`

#### 🐳 **Per Deployment:**
- **Parola chiave**: `DOCKER-DEPLOY`
- **Riferimento**: `/docs/guide/deploy-guide.md`
- **Checklist**: `/docs/checklist/CHECKLIST_FINALE.md`

#### 📊 **Per Test:**
- **Parola chiave**: `TEST-NETGESCON`
- **Riferimento**: `/docs/logs/TEST_PLAN.md`
- **Dati**: `/docs/specifiche/DATI_ESEMPIO.md`

### 🔍 **Esempi di Comunicazione Corretta**

#### ✅ **Esempio 1 - Modifica Layout:**
```
NETGESCON-SPEC: Convertire la vista admin/stabili al layout universale
RIFERIMENTO: UI_COMPONENTS.md + CHECKLIST_MENU_CRUD.md
OBIETTIVO: Uniformare l'interfaccia con Bootstrap
CONTESTO: Parte del processo di unificazione interfaccia
```

#### ✅ **Esempio 2 - Preparazione Docker:**
```
NETGESCON-SPEC: Preparare Docker per deployment online
RIFERIMENTO: deploy-guide.md + DOCKER-DEPLOY
OBIETTIVO: Messa online prossima settimana
CONTESTO: Dobbiamo essere pronti per la produzione
```

#### ✅ **Esempio 3 - Sviluppo API:**
```
NETGESCON-SPEC: Implementare endpoint API per collaboratori esterni
RIFERIMENTO: API_ENDPOINTS.md + DEVELOPMENT_IDEAS.md
OBIETTIVO: Facilitare sviluppo esterno
CONTESTO: Preparazione per modularità futura
```

### ⚠️ **Cosa NON Fare**

#### ❌ **Richieste Vaghe:**
- "Modifica questo file"
- "Aggiusta il layout"
- "Crea una API"

#### ❌ **Senza Riferimenti:**
- Richieste senza citare le specifiche
- Modifiche non documentate nei nostri file MD
- Sviluppo senza consultare la "bibbia"

### 🔄 **Workflow di Comunicazione**

#### 📝 **Prima di Ogni Richiesta:**
1. **Consulta** `/docs/specifiche/INDICE_PROGETTO.md`
2. **Identifica** il riferimento appropriato
3. **Usa** le parole chiave corrette
4. **Specifica** obiettivo e contesto

#### 🎯 **Durante il Lavoro:**
- L'AI consulterà sempre i riferimenti citati
- Seguirà le checklist appropriate
- Aggiornerà i log di progresso
- Rispetterà l'architettura definita

#### ✅ **Dopo il Completamento:**
- Aggiornamento automatico dei progress log
- Verifica coerenza con le specifiche
- Suggerimenti per prossimi passi

### 📚 **Riferimenti Veloci**

#### 🎯 **Entry Point Sempre:**
`/docs/specifiche/INDICE_PROGETTO.md`

#### 📋 **File Che Consulto Sempre:**
- `INDICE_PROGETTO.md` - Panoramica generale
- `PROGRESS_LOG.md` - Stato attuale
- `MENU_MAPPING.md` - Struttura menu/permessi
- `DATABASE_SCHEMA.md` - Struttura dati
- `API_ENDPOINTS.md` - Specifiche API

#### ✅ **Checklist Principali:**
- `CHECKLIST_FINALE.md` - Per rilasci
- `CHECKLIST_MENU_CRUD.md` - Per conversioni layout
- `CHECKLIST_INIZIALE.md` - Per setup

### 🚨 **Protocollo Emergenza**

#### 🔥 **Per Problemi Critici:**
```
NETGESCON-EMERGENCY: [descrizione problema]
STATO: [cosa si è rotto]
ULTIMA_MODIFICA: [cosa è stato fatto per ultimo]
RICHIESTA: [aiuto necessario]
```

#### 🆘 **Per Debugging:**
```
NETGESCON-DEBUG: [area problema]
RIFERIMENTO: [file/funzione specifica]
SINTOMI: [cosa succede]
OBIETTIVO: [cosa dovrebbe succedere]
```

### 🎯 **Promemoria Importante**

> **📋 RICORDA SEMPRE:**
> 1. Usa le parole chiave
> 2. Cita i riferimenti specifici
> 3. Consulta sempre l'INDICE_PROGETTO.md
> 4. Aggiorna i log di progresso
> 5. Mantieni coerenza con l'architettura

### 📞 **Contatti e Supporto**

**💬 Per Chiarimenti sul Protocollo:**
- Usa la parola chiave: `NETGESCON-HELP`
- Cita questo file: `PROTOCOLLO_COMUNICAZIONE.md`

**🔄 Per Aggiornamenti Protocollo:**
- Modifica questo file
- Aggiorna la data
- Notifica eventuali collaboratori

---

## 🔧 **Personalizzazioni Specifiche**

### 📋 **Per Michele (Sviluppatore Principale):**
- Accesso completo a tutte le specifiche
- Uso di tutte le parole chiave
- Modifiche dirette ai file MD
- Gestione completa del progetto

### 🤝 **Per Collaboratori Esterni:**
- Accesso limitato alle guide pubbliche
- Uso parole chiave: `API-NETGESCON`, `DOCKER-DEPLOY`
- Riferimenti solo ai file in `/docs/guide/`
- Comunicazione tramite questo protocollo

---

**📅 Creato:** 10 Luglio 2025  
**🔄 Versione:** 1.0  
**👨‍💻 Autore:** Michele + AI Assistant  
**📋 Stato:** ATTIVO - Usa questo protocollo per tutte le comunicazioni