NetGescon/netgescon-master
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
fff18efdc2
netgescon-master/netgescon-laravel/docs/README.md

3.3 KiB
Raw Blame History

NetGesCon - Documentazione Unificata

📋 Panoramica del Progetto

NetGesCon è un sistema di gestione condominiale completo con interfaccia web unificata, autenticazione centralizzata e gestione dinamica dei permessi.

🎯 STATO ATTUALE: Preparazione per messa online prossima settimana con Docker deployment

📁 Struttura Documentazione

📋 /docs/specifiche/ (PRIVATE - Solo team interno)

Contiene tutte le specifiche tecniche, requisiti, analisi e documentazione di sviluppo:

  • 🎯 INDICE_PROGETTO.md - ENTRY POINT PRINCIPALE
  • MENU_MAPPING.md - Mappatura completa menu e permessi
  • DATABASE_SCHEMA.md - Schema database completo
  • API_ENDPOINTS.md - Documentazione API completa
  • DOCKER_DEPLOYMENT.md - Specifiche deployment (PRIORITÀ ALTA)
  • UI_COMPONENTS.md - Componenti interfaccia unificata
  • Altri 20+ file di specifiche tecniche dettagliate...

📊 /docs/logs/ (PRIVATE - Solo team interno)

Log di sviluppo, test e problemi risolti:

  • PROGRESS_LOG.md - Log dettagliato progresso sviluppo
  • TEST_PLAN.md - Piano di test completo
  • CREDENZIALI_TEST.md - Credenziali per test
  • Report di test e debugging vari

✅ /docs/checklist/ (PRIVATE - Solo team interno)

Checklist operative e di controllo:

  • CHECKLIST_FINALE.md - Checklist master per rilascio
  • CHECKLIST_MENU_CRUD.md - Checklist conversione interfacce
  • CHECKLIST_INIZIALE.md - Checklist setup iniziale

📖 /docs/guide/ (PUBLIC - Accessibile esternamente)

Guide operative per utenti e sviluppatori esterni:

  • install-guide.md - Guida installazione
  • api-guide.md - Documentazione API per collaboratori esterni
  • deploy-guide.md - Procedura deployment base

🚀 Quick Start

  1. Per sviluppatori: Inizia leggendo /docs/specifiche/INDICE_PROGETTO.md
  2. Per amministratori: Consulta /docs/guide/admin-guide.md
  3. Per il deployment: Segui /docs/guide/deploy-guide.md

🔧 Procedura di Aggiornamento Specifiche

Per Team Interno:

  1. Modifica i file in /docs/specifiche/
  2. Aggiorna sempre PROGRESS_LOG.md con le modifiche
  3. Mantieni aggiornato INDICE_PROGETTO.md
  4. Committa solo i file essenziali (vedi .gitignore)

Per Collaboratori Esterni:

  1. Accesso solo ai file pubblici del repository
  2. Le specifiche interne rimangono private
  3. Documentazione API disponibile in /docs/guide/api-guide.md

📞 Contatti e Supporto

  • Sviluppatore principale: Michele
  • Repository: [GitHub Repository URL]
  • Documentazione tecnica: /docs/specifiche/

🤝 COME COMUNICARE CON L'AI

📋 Protocollo di Comunicazione

Per garantire che l'AI segua sempre le nostre specifiche, usa questo formato:

NETGESCON-SPEC: [descrizione del task]
RIFERIMENTO: [file specifico da consultare]
OBIETTIVO: [cosa deve fare l'AI]
CONTESTO: [eventuali info aggiuntive]

🔑 Parole Chiave Principali:

  • NETGESCON-SPEC - Consulta le specifiche
  • BIBBIA-PROGETTO - Usa l'indice come riferimento
  • LAYOUT-UNIVERSALE - Lavori su interfaccia Bootstrap
  • DOCKER-DEPLOY - Preparazione deployment
  • MENU-DINAMICO - Lavori su menu e permessi

📖 Documentazione Completa:

Leggi /docs/PROTOCOLLO_COMUNICAZIONE.md per i dettagli completi.

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