# Start Here - NetGescon Day-0

Data aggiornamento: 11-03-2026

## Obiettivo di questo file

Permettere ripresa immediata del lavoro in `netgescon-day0` senza perdere contesto tra un workspace e l'altro.

## Stato confermato

- Repository Day-0 attivo: `/home/michele/netgescon/netgescon-day0`
- Remote Git attivo: `ssh://git@192.168.0.53:2222/michele/netgescon-day0.git`
- Branch principale: `main`
- Ultimo commit noto: `f52e56d`

## Verifica rapida in 30 secondi

```bash
cd /home/michele/netgescon/netgescon-day0
git status --short --branch
git log --oneline -n 5
php artisan list | head -n 30
php artisan list | grep -E "netgescon:update|distribution:manage" | head -n 20
```

## Documenti da leggere in ordine (ripartenza agent)

1. `docs/ai/restart/START-HERE-NETGESCON-DAY0.md` (questo file)
2. `docs/ai/restart/HANDOFF_AGENT_OPERATIVO_20260311.md`
3. `docs/RUNBOOK-DISTRIBUZIONE-REMOTA-NETGESCON.md`
4. `docs/distribuzione-update-netgescon.md`
5. `Miki-Bug-workspace/AGENT_GIT.MD`

## Modifiche chiave gia presenti nel Day-0

- `config/distribution.php`
- `app/Console/Commands/NetgesconDistributionPullCommand.php`
- `app/Http/Controllers/Api/DistributionController.php`
- `routes/api.php`
- `bootstrap/app.php`
- `scripts/ops/netgescon-baseline-freeze.sh`
- `scripts/ops/netgescon-publish-manifest.sh`
- fix provider Filament in `app/Providers/Filament/AdminFilamentPanelProvider.php`

## Flusso operativo da ora

1. Sviluppo e commit solo in `netgescon-day0`.
2. Push su `origin/main` (Gitea Day-0).
3. Build package update e publish manifest.
4. Apply su staging con `php artisan netgescon:update --channel=free --apply`.
5. Smoke test rete e funzionali minimi.

## Comandi base sviluppo + staging

```bash
# sviluppo
cd /home/michele/netgescon/netgescon-day0
git pull --rebase origin main

# dopo modifiche
git add -A
git commit -m "feat: <descrizione>"
git push origin main

# staging
cd /var/www/netgescon
php artisan netgescon:update --channel=free
php artisan netgescon:update --channel=free --apply
```

## Nota sicurezza operativa

- Mantieni `22` chiuso all'esterno e usa VPN/LAN per amministrazione.
- Mantieni `2222` solo per Git/SSH key-based.
- Attiva `fail2ban` su SSH e login web.
- Abilita 2FA su Gitea per account admin/dev.

## Prossimo step consigliato

Eseguire un ciclo completo con una modifica piccola reale:

1. commit su Day-0,
2. publish package,
3. apply staging,
4. checklist smoke test finale.