← Mapa completResum públic curat
Índex
Entrada 16PUBLIC HANDBOOK

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.

Source & authority

Explicació pública

PUBLIC HANDBOOK
Basat en
Human Handbook 16 — Taller guiat: DCP Flow, versions i Docker amb Rewi
Fonts normatives relacionades
  • NORMATIVE SOURCEStandard · Solution Discovery Gate
  • NORMATIVE SOURCEStandard · Runtime Reproducibility
  • NORMATIVE SOURCEStandard · Deployment Environments
  • NORMATIVE SOURCEStandard · Quality Gates
Autoritat
Explicació pública — NON-NORMATIVE
Resum

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.

Punts clau
  • 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.

Punts clau
  • 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.

Punts clau
  • 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.

Punts clau
  • 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.

Punts clau
  • 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.

Punts clau
  • 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.

Punts clau
  • 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+
Solution Discovery

Procés d’investigar alternatives reals i avaluar proporcionalment ADOPT → CONFIGURE → INTEGRATE → EXTEND → BUILD abans d’una decisió material.

Foundation Ready

Estat en què la base tècnica i de governança permet iniciar una vertical funcional sense redescobrir o reconstruir la fundació del projecte.

Quality Gate

Punt de control on l’evidència determina si el treball pot avançar.

Human Gate

Punt on una decisió material requereix acceptació o autorització humana.