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
178 lines
5.3 KiB
Markdown
178 lines
5.3 KiB
Markdown
# 📋 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*
|