# 📋 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*
