netgescon-day0/docs/000-FILAMENT/01-REBUILD-STARTER.md

Rebuild Starter NetGescon (da zero)

Obiettivo

Guida operativa per ricostruire NetGescon da zero, incluse dipendenze, archivi legacy, staging e pipeline import.

Stack minimo

• PHP 8.2+
• Laravel 12
• Filament 4
• MySQL 8
• Node 18+
• mdb-tools (mdb-export, mdb-tables)

Requisiti archivi legacy

Percorso base legacy in sola lettura:

• /mnt/gescon-archives/gescon/

Struttura standard:

• dbc/Stabili.mdb
• dbc/Fornitori.mdb
• <cod_stabile>//singolo_anno.mdb
• <cod_stabile>/generale_stabile.mdb

Nota critica: nel legacy ogni anno replica tutte le tabelle. Occorre importare tutte le annualità.

Database

• DB principale: netgescon (dominio)
• DB staging: gescon_import

Connessione staging:

• Configurata in config/database.php con nome gescon_import.

Setup essenziale

1. Clona repo e installa dipendenze (composer + npm).
2. Configura .env (DB principale e gescon_import).
3. Migra DB principale + staging.
4. Verifica mdb-tools installati.
5. Avvia panel Filament.

Panel Filament

• ID: admin-filament
• Path: /admin-filament
• Login custom: redirect forzato a /admin-filament

Riferimento:

• app/Providers/Filament/AdminFilamentPanelProvider.php
• app/Filament/Auth/Login.php

Importazione GESCON (overview)

• Import MDB in staging
• Sincronizza in dominio con pipeline completa
• Arricchimento stabile da Stabili.mdb

Riferimento dettagliato: vedi docs/000-FILAMENT/02-ARCHIVI-E-IMPORT.md