netgescon-master/docs/PROCEDURA_OPERATIVA.md

📋 PROCEDURA OPERATIVA NETGESCON

🎯 Guida Rapida per il Team

📚 PUNTO DI PARTENZA SEMPRE:

/docs/specifiche/INDICE_PROGETTO.md

---

👨‍💻 Per Sviluppatori Interni

🔍 Prima di iniziare qualsiasi lavoro:

1. Consulta SEMPRE l'indice: /docs/specifiche/INDICE_PROGETTO.md
2. Verifica lo stato: /docs/specifiche/PROGRESS_LOG.md
3. Identifica la checklist appropriata: /docs/specifiche/CHECKLIST_*.md

📝 Durante lo sviluppo:

1. Lavora su una feature alla volta
2. Aggiorna il progress log ad ogni milestone significativo
3. Documenta problemi/soluzioni nel file appropriato
4. Testa sempre prima di committare

✅ Prima di committare:

1. Aggiorna PROGRESS_LOG.md con le modifiche
2. Verifica che non ci siano errori con i tool di debug
3. Testa le funzionalità modificate
4. Committa solo file essenziali (rispetta .gitignore)

📊 File che DEVI aggiornare:

• PROGRESS_LOG.md - Ad ogni modifica significativa
• INDICE_PROGETTO.md - Se aggiungi nuove specifiche
• Checklist appropriate - Quando completi task

---

🤝 Per Collaboratori Esterni

📖 Documentazione Accessibile:

• /docs/README.md - Panoramica generale
• /docs/guide/install-guide.md - Installazione
• /docs/guide/api-guide.md - API Documentation

🚫 File NON Accessibili:

• /docs/specifiche/ - Specifiche interne
• /docs/logs/ - Log di sviluppo
• /docs/checklist/ - Checklist operative

📞 Per Richieste Specifiche:

Contatta Michele per accesso a specifiche tecniche interne

---

🗂️ Organizzazione File

📁 Struttura Cartelle:

/docs/
├── README.md                 # 📋 Entry point pubblico
├── specifiche/              # 🔒 PRIVATE - Specifiche interne
│   ├── INDICE_PROGETTO.md   # 🎯 MASTER INDEX
│   ├── PROGRESS_LOG.md      # 📊 Log progresso
│   ├── CHECKLIST_*.md       # ✅ Checklist operative
│   └── ...                  # Altri file specifiche
├── logs/                    # 🔒 PRIVATE - Log sviluppo
├── checklist/              # 🔒 PRIVATE - Checklist interne
└── guide/                  # 🌍 PUBLIC - Guide utenti
    ├── install-guide.md    # 🚀 Installazione
    └── api-guide.md        # 🔌 API Documentation

🔒 Privacy e Git:

• File in /specifiche/, /logs/, /checklist/ sono PRIVATI
• .gitignore configurato per escluderli dal repository pubblico
• Solo /guide/ e README.md sono pubblici

---

🔄 Workflow Operativo

📅 Workflow Giornaliero:

⏰ Inizio Giornata:

1. Leggi INDICE_PROGETTO.md
2. Controlla PROGRESS_LOG.md per aggiornamenti
3. Identifica task prioritari

🛠️ Durante il Lavoro:

1. Segui la checklist appropriata
2. Testa frequentemente
3. Documenta problemi/soluzioni

🏁 Fine Giornata:

1. Aggiorna PROGRESS_LOG.md
2. Committa modifiche
3. Aggiorna percentuale progresso se necessario

📋 Workflow Specifiche:

➕ Aggiungere Nuova Specifica:

1. Crea file in /docs/specifiche/
2. Aggiungi link in INDICE_PROGETTO.md
3. Aggiorna PROGRESS_LOG.md
4. Notifica team se necessario

✏️ Modificare Specifica Esistente:

1. Modifica il file appropriato
2. Aggiorna PROGRESS_LOG.md
3. Aggiorna data in INDICE_PROGETTO.md se significativo

---

🎯 Checklist Rapide

✅ Checklist Sviluppatore (Daily):

• Letto INDICE_PROGETTO.md
• Verificato PROGRESS_LOG.md
• Identificato task del giorno
• Aggiornato progress log a fine giornata
• Committato solo file essenziali

✅ Checklist Rilascio (Pre-Deploy):

• Tutte le checklist specifiche completate
• PROGRESS_LOG.md aggiornato
• Test completi eseguiti
• Documentazione pubblica aggiornata
• .gitignore rispettato

✅ Checklist Delegazione (Collaboratori):

• Guide pubbliche aggiornate
• API documentation completa
• Credenziali test fornite
• Canali comunicazione stabiliti

---

🆘 Emergenze e Problemi

🔥 In caso di Emergenza:

1. STOP - Non modificare nulla
2. Documenta il problema in /docs/logs/
3. Contatta Michele immediatamente
4. Backup dello stato attuale se necessario

🐛 Per Bug Critici:

1. Crea file BUG_CRITICO_[DATA].md in /docs/logs/
2. Documenta: sintomi, causa, riproduzione, soluzione tentata
3. Aggiorna PROGRESS_LOG.md
4. Testa fix accuratamente

---

📞 Contatti e Riferimenti

👨‍💻 Sviluppatore Principale: Michele
📧 Email: [email]
📱 Emergenze: [telefono]

📂 Repository: [GitHub URL]
🌐 Demo: [Demo URL]
📚 Docs: /docs/README.md

---

⚠️ Note Importanti

1. MAI committare file di /docs/specifiche/ su repository pubblico
2. SEMPRE leggere INDICE_PROGETTO.md prima di iniziare
3. SEMPRE aggiornare PROGRESS_LOG.md
4. Mai lavorare su più features contemporaneamente
5. Testare sempre prima di committare

---

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