netgescon-master/netgescon-laravel/docs

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')}