Taller guiat: DCP Flow, versions i Docker amb Rewi
Exemple educatiu basat en Rewi per distingir Discovery, Foundation, versions aplicables, compatibilitat de contenidors, Quality Gates i release amb evidència. No prescriu un stack universal.
Exemple educatiu basat en Rewi per distingir Discovery, Foundation, versions aplicables, compatibilitat de contenidors, Quality Gates i release amb evidència. No prescriu un stack universal.
Aquest taller educatiu adapta un cas real de Rewi per practicar decisions i controls de DCP Flow. L'explicació pública no autoritza operar servidors, canviar infraestructura ni reutilitzar automàticament la tecnologia del cas. Font editorial revisada: Handbook institucional, 28 d'octubre de 2026.
Del problema al mode de solució
Un negoci necessita registrar operacions i consultar-ne l'estat. Abans d'escollir Laravel, un agent o un contenidor, cal definir el resultat i examinar les cinc vies de Solution Discovery: ADOPT, CONFIGURE, INTEGRATE, EXTEND o BUILD. Rewi il·lustra un BUILD contextual, no una plantilla tecnològica universal.
- Explicar el problema i un Golden Flow verificable.
- Comparar alternatives existents abans de programar.
- Registrar la decisió, els límits i el responsable humà.
Foundation i versions segons el context
Cal escollir el Blueprint que correspon al producte i un runtime reproduïble. Durant Foundation es consulta la baseline actual per a projectes nous al repositori canònic; les versions exactes es fixen per projecte. Un web editorial pot usar Astro i una aplicació transaccional pot requerir Laravel. Les versions observades a Rewi no obliguen a actualitzar aplicacions existents estables.
- Projecte nou: baseline vigent dels components utilitzats.
- Projecte existent: upgrade separat i justificat.
- Node per al build no implica Node al hosting estàtic.
Docker: reproduïble no vol dir idèntic
Docker i Compose descriuen serveis, imatges, variables, xarxes i persistència. Dos hosts poden tenir versions diferents del motor i continuar sent compatibles si es validen els contractes. Consultar la configuració declarada no demostra que una base de dades o un servei s'estigui executant.
- Validar la configuració Compose efectiva abans del desplegament.
- Separar entorns, secrets, dades i volums.
- No utilitzar accions destructives com a simples comprovacions.
Quality Gates, release i aprenentatge
Un build PASS demostra la compilació dins del seu abast, no un release en producció. El flux conserva working branch, PR, integració a dev, aprovació humana, artifact traçable, smoke del destí i evidència operativa. Només es promouen aprenentatges a DCP Flow quan tenen suport i es poden reutilitzar.
- PASS, FAIL i NOT RUN no són equivalents.
- Deploy i release són decisions diferents.
- L'evidència del cas no substitueix Standards ni Project Truth.
Exemple de compatibilitat: versions declarades i versions executades
Un manifest Compose expressa el desplegament previst; observar el contenidor demostra què s'executa realment. El cas educatiu de Rewi compara versions, perfils d'entorn, healthchecks, xarxes i volums abans d'afirmar compatibilitat. Una actualització del motor de base de dades requereix còpies verificables i una estratègia de recuperació provada.
- La baseline de projectes nous no actualitza producció automàticament.
- Comparar manifests efectius i runtime observat.
- Preparar rollback o recuperació abans de migracions.
Proxy compartit i límits entre aplicacions
Un reverse proxy pot servir diversos dominis i simplificar TLS, però no barreja els límits de seguretat. Cada aplicació manté xarxes, credencials, persistència i permisos separats. Un healthcheck HTTP 200 no demostra que les interfícies, els assets, l'autorització o els fluxos de negoci funcionin.
- Mantenir entorns i credencials aïllats en infraestructura compartida.
- No executar prune global ni down -v com a diagnòstic.
- Verificar assets i Golden Flows més enllà dels healthchecks.
Exercici d'acceptació amb evidència
Per a una millora petita, l'equip registra l'outcome, treballa en una branca específica, executa proves locals proporcionals i presenta el diff. Un Quality Gate de GitHub valida el commit proposat; integració, desplegament i release exigeixen evidència i autorització pròpies. Els aprenentatges es registren sense convertir detalls exclusius de Rewi en regles universals.
- Distingir build PASS, integració PASS i producció verificada.
- Declarar NOT RUN i deute conegut sense presentar-los com a PASS.
- Promoure patrons a Standards només després de validar-ne l'aplicabilitat.
Glossari contextual+
Procés d’investigar alternatives reals i avaluar proporcionalment ADOPT → CONFIGURE → INTEGRATE → EXTEND → BUILD abans d’una decisió material.
Estat en què la base tècnica i de governança permet iniciar una vertical funcional sense redescobrir o reconstruir la fundació del projecte.
Punt de control on l’evidència determina si el treball pot avançar.
Punt on una decisió material requereix acceptació o autorització humana.
