michele/netgescon-day0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
netgescon-day0/docs/90-UI-interfaccia-unica/90-01-content/08-manuali-collegati.md

5.6 KiB
Raw Permalink Blame History

📚 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:

## [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:

# Aggiornare sezione interfaccia in:
/home/michele/netgescon/docs/00-COPILOT-MASTER-GUIDE.md

2. Sincronizza Esempi:

# Verifica consistency negli esempi:
- contabilita/index.blade.php
- stabili/show.blade.php
- Altri moduli implementati

3. Update CHANGELOG:

# 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:

# 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!