204 lines
5.6 KiB
Markdown
204 lines
5.6 KiB
Markdown
# 📚 MANUALI COLLEGATI E AGGIORNAMENTI
|
|
## Files da aggiornare quando si modifica la struttura
|
|
|
|
---
|
|
|
|
## 📋 **MANUALI DA AGGIORNARE**
|
|
|
|
### **Quando si modifica un pattern UI/UX**:
|
|
|
|
#### **1. Master Guide NetGescon**:
|
|
- **File**: `/home/michele/netgescon/docs/00-COPILOT-MASTER-GUIDE.md`
|
|
- **Sezione**: Interfaccia e Layout Standard
|
|
- **Aggiornare**: Pattern menu, CSS classes, layout structure
|
|
|
|
#### **2. Piano Lavoro Master**:
|
|
- **File**: `/home/michele/netgescon/docs/00-PIANO-LAVORO-MASTER.md`
|
|
- **Sezione**: Standardizzazione UI
|
|
- **Aggiornare**: Checklist moduli, template standard
|
|
|
|
#### **3. Interfaccia Universale**:
|
|
- **File**: `/home/michele/netgescon/docs/05-INTERFACCIA-UNIVERSALE.md`
|
|
- **Sezione**: Pattern Design System
|
|
- **Aggiornare**: Componenti standard, color scheme
|
|
|
|
#### **4. Frontend UX**:
|
|
- **File**: `/home/michele/netgescon/docs/08-FRONTEND-UX.md`
|
|
- **Sezione**: User Experience Guidelines
|
|
- **Aggiornare**: Navigation patterns, responsive design
|
|
|
|
---
|
|
|
|
## 🗄️ **MANUALI DATABASE**
|
|
|
|
### **Quando si modifica struttura database**:
|
|
|
|
#### **1. Database Strutture**:
|
|
- **File**: `/home/michele/netgescon/docs/04-DATABASE-STRUTTURE.md`
|
|
- **Sezione**: Schema tabelle, relazioni
|
|
- **Aggiornare**: Nuove tabelle, foreign keys, indexes
|
|
|
|
#### **2. Sistema Multi-Ruolo**:
|
|
- **File**: `/home/michele/netgescon/docs/06-SISTEMA-MULTI-RUOLO.md`
|
|
- **Sezione**: Permissions, user roles
|
|
- **Aggiornare**: Access control per nuovi moduli
|
|
|
|
#### **3. API Integrazioni**:
|
|
- **File**: `/home/michele/netgescon/docs/07-API-INTEGRAZIONI.md`
|
|
- **Sezione**: Endpoints, data format
|
|
- **Aggiornare**: Nuovi endpoint per moduli
|
|
|
|
---
|
|
|
|
## 🚀 **DEPLOYMENT GUIDES**
|
|
|
|
### **Quando si aggiunge nuovo modulo**:
|
|
|
|
#### **1. INSTALL_LINUX.md**:
|
|
- **Path**: `/var/www/netgescon/INSTALL_LINUX.md`
|
|
- **Aggiornare**: Steps installazione, dependencies
|
|
|
|
#### **2. Deploy Guide**:
|
|
- **Path**: `/var/www/netgescon/deploy-guide.md`
|
|
- **Aggiornare**: Deployment checklist, migration steps
|
|
|
|
#### **3. Recovery Guide**:
|
|
- **Path**: `/var/www/netgescon/RECOVERY-GUIDE.md`
|
|
- **Aggiornare**: Backup procedures, rollback steps
|
|
|
|
---
|
|
|
|
## 📊 **ARCHITETTURA LARAVEL**
|
|
|
|
### **Quando si modifica architettura**:
|
|
|
|
#### **1. Architettura Laravel**:
|
|
- **File**: `/home/michele/netgescon/docs/02-architettura-laravel/`
|
|
- **Files**: Tutti i file nella cartella
|
|
- **Aggiornare**: Controller patterns, middleware, routes
|
|
|
|
#### **2. Riepilogo Modularizzazione**:
|
|
- **File**: `/home/michele/netgescon/docs/RIEPILOGO-MODULARIZZAZIONE.md`
|
|
- **Aggiornare**: Struttura moduli, dependencies
|
|
|
|
---
|
|
|
|
## 🔄 **CHECKLIST AGGIORNAMENTI**
|
|
|
|
### **Prima di modificare pattern standard**:
|
|
- [ ] **Backup documenti** esistenti
|
|
- [ ] **Identifica impatti** su altri moduli
|
|
- [ ] **Lista manuali** da aggiornare
|
|
- [ ] **Pianifica sequence** di aggiornamenti
|
|
|
|
### **Durante modifica pattern**:
|
|
- [ ] **Aggiorna template** in 90-01-content/
|
|
- [ ] **Modifica esempi** nei manuali collegati
|
|
- [ ] **Verifica consistency** tra documenti
|
|
- [ ] **Testa implementazione** su modulo esistente
|
|
|
|
### **Dopo modifica pattern**:
|
|
- [ ] **Aggiorna tutti manuali** nella lista
|
|
- [ ] **Verifica links** tra documenti
|
|
- [ ] **Controlla esempi** funzionanti
|
|
- [ ] **Documenta changes** in CHANGELOG
|
|
|
|
---
|
|
|
|
## 📝 **TEMPLATE AGGIORNAMENTO**
|
|
|
|
### **Per ogni manuale da aggiornare**:
|
|
```markdown
|
|
## [UPDATED] - Data Aggiornamento
|
|
|
|
### Modifiche alla sezione {SEZIONE}:
|
|
- **PRIMA**: Pattern vecchio
|
|
- **DOPO**: Pattern nuovo
|
|
- **IMPATTO**: Moduli interessati
|
|
- **AZIONI**: Steps da seguire
|
|
|
|
### Riferimenti:
|
|
- **Source**: 90-01-content/{file}.md
|
|
- **Esempio**: Implementazione in {modulo}
|
|
- **Test**: {file_test} funzionante
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 **CROSS-REFERENCES**
|
|
|
|
### **Pattern Menu collegati in**:
|
|
- `00-COPILOT-MASTER-GUIDE.md` → Sezione UI Standard
|
|
- `05-INTERFACCIA-UNIVERSALE.md` → Navigation Patterns
|
|
- `08-FRONTEND-UX.md` → User Experience
|
|
|
|
### **Database config collegato in**:
|
|
- `04-DATABASE-STRUTTURE.md` → Schema principale
|
|
- `06-SISTEMA-MULTI-RUOLO.md` → User permissions
|
|
- `07-API-INTEGRAZIONI.md` → Data endpoints
|
|
|
|
### **Layout standard collegato in**:
|
|
- `02-architettura-laravel/` → Blade templates
|
|
- `RIEPILOGO-MODULARIZZAZIONE.md` → Module structure
|
|
- Deploy guides → Production setup
|
|
|
|
---
|
|
|
|
## 🚨 **AZIONI IMMEDIATE**
|
|
|
|
### **Quando modifichi 90-01-content/**:
|
|
|
|
#### **1. Aggiorna Master Guide**:
|
|
```bash
|
|
# Aggiornare sezione interfaccia in:
|
|
/home/michele/netgescon/docs/00-COPILOT-MASTER-GUIDE.md
|
|
```
|
|
|
|
#### **2. Sincronizza Esempi**:
|
|
```bash
|
|
# Verifica consistency negli esempi:
|
|
- contabilita/index.blade.php
|
|
- stabili/show.blade.php
|
|
- Altri moduli implementati
|
|
```
|
|
|
|
#### **3. Update CHANGELOG**:
|
|
```bash
|
|
# Documenta modifiche in:
|
|
/var/www/netgescon/CHANGELOG.md
|
|
```
|
|
|
|
---
|
|
|
|
## 📅 **SCHEDULE AGGIORNAMENTI**
|
|
|
|
### **Frequenza consigliata**:
|
|
- **Pattern UI**: Ogni modifica → Immediate update
|
|
- **Database schema**: Ogni nuova tabella → Weekly review
|
|
- **Deploy guides**: Ogni release → Monthly update
|
|
- **Master guides**: Ogni milestone → Quarterly review
|
|
|
|
### **Priorità aggiornamenti**:
|
|
1. **ALTA**: Pattern che impattano sviluppo attivo
|
|
2. **MEDIA**: Documentazione architettura
|
|
3. **BASSA**: Guide deployment per versioni future
|
|
|
|
---
|
|
|
|
## 🎯 **MANTIENI SINCRONIZZATO**
|
|
|
|
### **Golden Rule**:
|
|
**"Ogni modifica a 90-01-content/ deve essere riflessa nei manuali collegati entro 24h"**
|
|
|
|
### **Quick Check**:
|
|
```bash
|
|
# Verifica rapidamente se tutto è aggiornato
|
|
grep -r "Pattern MENU" /home/michele/netgescon/docs/
|
|
grep -r "Layout BASE" /home/michele/netgescon/docs/
|
|
grep -r "Database CONFIG" /home/michele/netgescon/docs/
|
|
```
|
|
|
|
---
|
|
|
|
**🔄 Questa lista è il tuo reminder per mantenere tutta la documentazione NetGescon sempre sincronizzata!**
|