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 a Vercel
El frontend es publica a Vercel. Abans de promoure un deployment cal comprovar el SHA, els checks de CI requerits, version.json, els assets i el comportament al navegador.
El smoke HTTP verifica distribució i versió; un HTML 200 no acredita una carta carregada ni un login correcte. El workflow del candidat afegeix proves de navegador amb dades sintètiques i sense xarxa externa. Les proves d’autenticació/MFA, Admin i operació amb backend real necessiten staging aïllat.
Si falla un desplegament, el responsable pot seleccionar una versió anterior compatible a Vercel i comprovar els dominis. Això no desfà migracions ni dades. No s’ha acreditat rollback automàtic ni recuperació en cinc minuts. Els snapshots de /opt/backups del servidor antic no formen part del flux vigent.
Incidents i comunicació
- Els errors es capturen a Sentry amb context (userId, restaurantId, breadcrumb).
- Si hi ha incident de servei, comunicació a
soporte@restapro.esi 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 | Deployment anterior de Vercel, després d’avaluar compatibilitat | Reinstal·lar versió anterior |