50 lines
1.8 KiB
Markdown
50 lines
1.8 KiB
Markdown
# 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, supportano i formati DYMO `11354` e `99014` e usano un URL pubblico configurabile tramite `APP_PUBLIC_URL`.
|
|
- La vista `Archivio digitale` usa ora una tabella a tutta larghezza con riepilogo rapido della cartella corrente.
|
|
- La topbar contestuale Filament usa layout a capo, senza scrollbar orizzontale.
|
|
|
|
## Contribuire
|
|
|
|
Vedi `CONTRIBUTING.md` (da aggiungere) per le regole di collaborazione.
|