michele/netgescon-day0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
recovery/205-from-200-20260701
netgescon-day0/docs/00-INDICE-DOCS-UNIFICATA.md

8.5 KiB
Executable File
Raw Permalink Blame History

📚 NETGESCON - DOCUMENTAZIONE UNIFICATA

🧭 Indice Completo Cartella DOCS

🎯 DOCUMENTAZIONE PRINCIPALE del progetto NetGescon
📍 Posizione: ~/netgescon/docs/
🔄 Aggiornato: 30/11/2025 - Log automatici & ripartenza import

🚀 Novità 30/11/2025

  • Log automatici disponibili in docs/automation/: post-commit (commit-log/), snapshot giornalieri (daily/), protocollo handoff.
  • Indice README aggiornato con collegamenti rapidi a import unità e scheda anagrafica.
  • Focus ripartenza import: usa docs/07-IMPORT-UNITA-IMMOBILIARI.md + docs/08-ANAGRAFICA-UNICA-UI.md per riallineare pipeline e UI.

🤖 DOCUMENTI CHIAVE PER GITHUB COPILOT/AI

🎯 START HERE - Se sei un altro GitHub Copilot che deve continuare questo progetto:

📋 DOCUMENTI CHIAVE PRONTI

  1. 00-COPILOT-HANDOFF-MASTER.md - 🤖 INIZIA QUI - Handoff completo
  2. 00-COPILOT-MASTER-GUIDE.md - 🤖 Guida completa per AI
  3. 00-transizione-linux/README-TRANSITION-COMPLETE.md - 🔑 Guida transizione completa
  4. 00-transizione-linux/FEATURES-INVENTORY-COMPLETE.md - 📊 Inventario funzionalità
  5. INVENTARIO-UNIFICAZIONE-FINALE.md - 📋 Report unificazione
  6. 00-transizione-linux/DEPLOYMENT-GUIDE-COMPLETE.md - 🚀 Guida deployment

⚡ QUICK START WORKFLOW

  1. Leggi 00-COPILOT-MASTER-GUIDE.md per capire tutto il contesto
  2. Controlla 00-transizione-linux/README-TRANSITION-COMPLETE.md per lo stato attuale
  3. Usa INVENTARIO-UNIFICAZIONE-FINALE.md per vedere cosa è stato fatto
  4. Continua lo sviluppo senza perdere dati/autenticazione/struttura

📂 STRUTTURA DOCUMENTAZIONE PRINCIPALE

📖 DOCUMENTAZIONE CORE (Cartella principale)

🐧 00-TRANSIZIONE-LINUX - Materiali migrazione e transizione

🛠️ 01-MANUALI-AGGIUNTIVI - Procedure e guide operative

  • PROCEDURA_OPERATIVA.md - Procedure operative standard
  • personalizzazione-tema.md - Personalizzazione interfaccia
  • miki.md - Note specifiche Miki
  • QUICK_REFERENCE_LARAVEL.md - Reference rapido Laravel
  • checklist/ - Checklist operative

🏗️ 02-ARCHITETTURA-LARAVEL - Design e architettura sistema

  • ARCHITETTURA_MODULARE_COMPLETATA.md - Architettura modulare
  • RIEPILOGO_ARCHITETTURA_COMPLETATA.md - Riepilogo architettura
  • PROTOCOLLO_COMUNICAZIONE.md - Protocolli comunicazione
  • sidebar-modulare.md - Sistema sidebar modulare
  • guide/ - Guide tecniche dettagliate
  • specifiche/ - Specifiche tecniche

⚙️ 03-SCRIPTS-AUTOMAZIONE - Script e automazione

  • fix-vscode-install.sh - Fix installazione VS Code
  • setup-*.sh - Script setup ambiente
  • install-*.sh - Script installazione componenti
  • Altri script di automazione

💾 04-MATERIALI-WINDOWS - Backup materiali Windows

  • Backup file temporanei Windows
  • Materiali di transizione

📦 05-BACKUP-UNIFICAZIONE - Backup processo unificazione

  • DOCS-UNIFIED/ - Backup struttura precedente

🖼️ IMAGES - Materiali visivi e screenshot

  • danea-schermate/ - Screenshot DANEA
  • gescon-schermate/ - Screenshot GESCON
  • go-schermate/ - Screenshot GO
  • schermate-ufficiali/ - Screenshot ufficiali NetGescon
  • vm-setup/ - Screenshot setup VM

📁 CARTELLE ESISTENTI (Mantenute)

  • api/ - Documentazione API
  • 000-IMPORT/ - Import dati (GESCON, CSV, MDB)
  • bug/ - 🐛 Gestione bug e problemi
    • Bug UI Principale/ - Problemi interfaccia utente
    • Problemi da risolvere/ - Issue tracking
    • vista/ - Problemi visualizzazione
  • checklists/ - Checklist implementazione
  • logs/ - Log sviluppo e sessioni
  • manuals/ - Manuali dettagliati
  • moduli/ - Documentazione moduli
  • specifications/ - Specifiche tecniche
  • team/ - Documentazione team
  • versione/ - Gestione versioni
  • automation/ - Log automatici (commit mensili, summary giornalieri, protocollo handoff)

🏗️ Import Legacy & Anagrafica Unica

  1. 07-IMPORT-UNITA-IMMOBILIARI.md – piano dettagliato per importare unità, soggetti, ruoli e pertinenze.
  2. 07-DATABASE-NETGESCON.md – schema database con focus su tabelle unita_immobiliari, proprieta, rubrica_*.
  3. 08-ANAGRAFICA-UNICA-UI.md – specifica UX della scheda anagrafica con collegamento condominio ↔ unità ↔ soggetti.
  4. GUIDA-IMPORT-DATI-REALI.md – procedure operative per portare i dataset reali nel nuovo flusso.

🎯 NAVIGAZIONE RAPIDA PER SCENARIO

🆘 EMERGENZA/TROUBLESHOOTING

  1. 00-MANUALE-COMPLETO-NETGESCON-UNIFICATO.md
  2. 01-manuali-aggiuntivi/QUICK_REFERENCE_LARAVEL.md
  3. logs/ - Consultare log recenti

🚀 PRIMO ACCESSO/ONBOARDING

  1. 00-INDICE-MASTER-NETGESCON.md
  2. 05-INTERFACCIA-UNIVERSALE.md
  3. 02-architettura-laravel/ARCHITETTURA_MODULARE_COMPLETATA.md

🔧 SVILUPPO E MODIFICHE

  1. 02-architettura-laravel/ARCHITETTURA_MODULARE_COMPLETATA.md
  2. 04-DATABASE-STRUTTURE.md
  3. 07-API-INTEGRAZIONI.md
  4. docs/automation/ - Verifica log automatici prima di riprendere task sospesi

🐧 DEPLOYMENT E LINUX

  1. 03-scripts-automazione/ - Script setup
  2. images/vm-setup/ - Screenshot configurazione

📊 VANTAGGI STRUTTURA UNIFICATA

✅ Organizzazione

  • Tutto in una cartella - docs/ come punto unico
  • Categorizzazione chiara - Sottocartelle per tipo materiale
  • Backward compatibility - Struttura esistente mantenuta
  • Facilità navigazione - Percorsi intuitivi

🤖 Per GitHub Copilot/AI

  • Contesto completo - Accesso a tutto il materiale
  • Struttura logica - AI comprende organizzazione
  • Cross-reference - Collegamenti tra documenti
  • Onboarding ottimale - Informazioni complete

💡 NOTA IMPORTANTE
Questa struttura mantiene docs/ come standard e integra tutto il materiale in modo organizzato.
Un'unica cartella, documentazione tracciata automaticamente, navigazione chiara.

🏢 NETGESCON - Documentazione Unificata
📅 Data Unificazione: 18/07/2025
🎯 Standard: docs/ come riferimento principale