netgescon-day0/README.md

NetGesCon (Laravel + Filament)

Panoramica

Gestione condominiale con moduli contabili, anagrafiche e archivi legacy. Stack principale: Laravel + Filament + Livewire.

Requisiti

• PHP 8.3+
• Composer
• Node.js + npm
• MySQL/MariaDB

Avvio rapido (sviluppo)

1. Crea il file .env da .env.example e configura DB/APP_URL.
2. Installa le dipendenze: composer install e npm install.
3. Genera la chiave applicativa: php artisan key:generate.
4. Migra il database: php artisan migrate.
5. Pubblica gli asset Filament: php artisan filament:assets.
6. Avvia l'applicazione: php artisan serve.

Distribuzione Open Source (linee guida)

• Aggiungi una licenza: LICENSE (MIT, Apache-2.0, AGPL, ecc.)
• Compila la documentazione essenziale:
  • README.md (setup, requisiti, run)
  • CONTRIBUTING.md (workflow PR, coding standards, test)
  • CHANGELOG.md (note di rilascio)
• Evita dati sensibili nel repository:
  • Non versionare .env reali
  • Rimuovi credenziali e chiavi
• Versiona con tag semantici: vX.Y.Z

Struttura documentazione

• docs/ contiene i flussi, import, troubleshooting e procedure operative.
• Documento archivio e acquisizione: docs/DOCUMENTI-NFC-E-ACQUISIZIONE.md

Stato operativo recente

• Strumenti > Documenti apre ora una dashboard Protocollo comunicazioni con ricerca, filtri e anteprima PDF.
• Le etichette archivio fisico generano il QR in locale e supportano i formati DYMO 11354 e 99014.
• La topbar contestuale Filament usa layout a capo, senza scrollbar orizzontale.

Contribuire

Vedi CONTRIBUTING.md (da aggiungere) per le regole di collaborazione.