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
180 lines
5.4 KiB
Markdown
180 lines
5.4 KiB
Markdown
# 🤝 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
|