netgescon-day0/docs/ai/restart/START-HERE-NETGESCON-DAY0.md

88 lines
2.5 KiB
Markdown

# 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/ai/restart/CONTINUITA-STORICO-DAY0.md`
4. `docs/ai/restart/FILAMENT-ONLY-CUTOVER-CHECKLIST.md`
5. `docs/RUNBOOK-DISTRIBUZIONE-REMOTA-NETGESCON.md`
6. `docs/distribuzione-update-netgescon.md`
7. `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.