Versionat i publicació de canvis

RestaPro és un SaaS en continuous deployment: cada commit a main pot arribar a producció després de revisió. No hi ha versions discretes que t'hagis de descarregar i instal·lar — sempre estàs a la més recent.

Build ID

Cada desplegament genera un identificador únic (hash de Git). És visible a:

• Meta tag de l'HTML: <meta name="restapro:build-id" content="abc1234def56">
• Peu del backoffice (en alguns punts).
• Inspector del navegador (F12 → pestanya Elements).

Si suport et pregunta "quina versió tens?", n'hi ha prou amb mirar el meta tag.

Per què no hi ha versionat semàntic

Programari tradicional: v1.0 → v1.1 → v2.0, descarregues, instal·les, esperes la pròxima release.

SaaS continu: canvis petits i freqüents que arriben automàticament. El versionat semàntic no aporta valor quan no decideixes quan actualitzar.

Com t'assabentes dels canvis

Changelog públic

Cada release important es publica a /changelog amb:

• Què ha canviat
• Per què
• Si afecta el teu flux

Correu als workspaces

Els canvis destacats que afectin el teu dia a dia s'anuncien per correu al compte. Sense spam — només el rellevant per gestionar el teu restaurant.

Canvis disruptius (breaking)

Política:

• Notificació amb 30 dies d'antelació si alguna cosa canvia i podria afectar la teva integració o fluxos públics.
• Missatge clar: què canvia, per què, què cal fer (si cal alguna cosa).
• Període de transició: en canvis crítics, mantenim la versió antiga en paral·lel mentre migres.

La majoria de canvis són additius i transparents — comencen a funcionar sense que hagis de fer res.

Rollback automàtic

El desplegament és a prova de fallades:

1. Després de desplegar, smoke tests HTTP verifiquen rutes crítiques (/, /login, /app, /c/demo-restaurante, etc.).
2. Si fallen, l'script avorta i retorna missatge d'error.
3. Snapshots dels últims 10 builds a /opt/backups/restapro-dist/ permeten rollback manual ràpid si cal.
4. Per a emergències, restaurem en menys de 5 minuts.

Incidents i comunicació

• Els errors es capturen a Sentry amb context (userId, restaurantId, breadcrumb).
• Si hi ha incident de servei, comunicació a support@restapro.es i correu proactiu.
• Estat del servei: en el futur hi haurà una pàgina de status públic.

Resum

	RestaPro	Programari tradicional
Versions	Continuous, build ID = git SHA	v1.0, v1.1, v2.0
Actualització	Automàtica, sense intervenció	Descàrrega, instal·la
Cadència	Diari / setmanal	Trimestral / anual
Breaking changes	30 dies d'avís, rars	Noves major versions
Rollback	Automàtic en seg	Reinstal·lar versió anterior