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