netgescon-master/docs/02-architettura-laravel/PROTOCOLLO_COMUNICAZIONE.md

🤝 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