Contesto operativo GLM

Stato progetto

Fase: web app React/Vite operativa su Cloudflare Pages.
Nome prodotto visibile: Simulatore gara TPL lotti 1-4.
Versione applicativa: leggere version in package.json come source of truth.
Deploy produzione: Cloudflare Pages progetto gare-lotti-milanesi, URL https://gare-lotti-milanesi.pages.dev.
Branch principale: main.
Remote locale: git@github.com:max23468/GLM.git.
Alias GitHub verificato: git@github.com:max23468/Gare-Lotti-Milanesi.git punta allo stesso main; per operazioni locali resta valido origin.

Regole operative: AGENTS.md.
Ingresso e comandi: README.md.
Indice documentale: docs/INDEX.md.
Roadmap: docs/ROADMAP.md.
Backlog: docs/BACKLOG.md.
Toolchain: docs/TOOLCHAIN.md.
Decisioni: docs/DECISIONS.md, docs/DECISIONS_PENDING.md e ADR in docs/decisions/.
Logica simulatore: docs/LOGICA_SIMULATORE.md.
Versioning/release: docs/guides/versioning-e-release.md.
Deploy Cloudflare: docs/guides/cloudflare-pages.md.

GLM usa Cloudflare Pages, non Vercel o Supabase.
L'URL pubblico https://gare-lotti-milanesi.pages.dev resta stabile salvo richiesta esplicita.
Il nome visibile del prodotto è separato dallo slug deploy.
Il remote locale max23468/GLM e l'alias max23468/Gare-Lotti-Milanesi sono stati verificati sullo stesso commit main il 2026-05-31.
L'allineamento documentale è di processo: non cambia logica, UI, allegati, release o deploy.
Durante l'allineamento non copiare ciecamente template generici: censire funzioni, documenti e regole GLM già mature, poi decidere se mantenerle specifiche, sostituirle con pattern più maturi o parcheggiarle in backlog.

Non trattare il simulatore come fonte ufficiale di gara, offerta, aggiudicazione o consulenza.
Non inventare formule, soglie, valori o fonti.
Distinguere sempre Documento di gara, Fonte pubblica e Assunzione simulativa.
Non modificare, convertire o rinominare allegati Git LFS senza richiesta esplicita.
Non inviare allegati o dati di gara a provider esterni senza richiesta esplicita e valutazione del rischio.
Non introdurre backend, account, database remoto, autenticazione, Vercel o Supabase senza decisione esplicita.
Push o merge su main avviano automaticamente verifica, deploy produzione e smoke; eseguirli solo nel flusso di pubblicazione autorizzato.

Documentazione pura: git diff --check.
Dati, scoring, persistenza o import/export: npm test e npm run build.
Build/runtime: npm run build.
Smoke browser completo: npm run smoke solo quando il diff può toccare flussi coperti dallo smoke.
Deploy doctor: npm run deploy:doctor quando si tocca deploy/configurazione o prima di pubblicare.

Prima di procedere:

leggere AGENTS.md;
controllare git status --short;
leggere README.md;
leggere docs/INDEX.md, docs/CONTEXT.md, docs/ROADMAP.md, docs/BACKLOG.md e docs/TOOLCHAIN.md;
se la task riguarda logica, dati o UI, leggere docs/LOGICA_SIMULATORE.md e i file sorgenti indicati da AGENTS.md;
identificare verifiche proporzionate.

Durante handoff e migrazioni, non perdere contenuti: se una nota viene spostata, indicare nuova posizione o motivo della rimozione.

Confondere il nome visibile del prodotto con lo slug Cloudflare Pages.
Trasformare un allineamento documentale in modifica runtime o release non richiesta.
Toccare allegati Git LFS o file generati per errore.
Lasciare implicite assunzioni su fonti pubbliche o dati variabili.
Appesantire GLM con standard generici che non aggiungono controllo reale.

Scegliere dal backlog il primo debito prodotto/tecnico da promuovere, se serve.
Se un pattern GLM sembra utile ad altre repo, valutarlo caso per caso e non applicarlo automaticamente repo-per-repo.