← Mapa completoResumen público curado
Índice
Entrada 07PUBLIC HANDBOOK

Arquitectura, stack y ecosistema tecnológico

Distingue Architecture, Stack, Runtime, Environment, Infrastructure y Tooling; cubre Runtime Profiles, provider neutrality, IaC, CI/CD, observability, Tool Catalog y ownership por dominio frente a orquestación.

Source & authority

Explicación pública

PUBLIC HANDBOOK
Basado en
Human Handbook 07 — Arquitectura, stack y ecosistema tecnológico
Fuentes normativas relacionadas
  • NORMATIVE SOURCEStandard · Development Methodology
  • NORMATIVE SOURCEStandard · API / Orchestration Boundary
Autoridad
Explicación pública — NON-NORMATIVE
Resumen

Distingue Architecture, Stack, Runtime, Environment, Infrastructure y Tooling; cubre Runtime Profiles, provider neutrality, IaC, CI/CD, observability, Tool Catalog y ownership por dominio frente a orquestación.

DCP Flow evita mezclar arquitectura, stack, runtime, infraestructura y tooling como si fueran lo mismo. Cada capa responde preguntas distintas y puede evolucionar con distinta velocidad.

Capas de decisión

Architecture describe estructura y responsabilidades; Stack define tecnologías; Runtime describe cómo se ejecuta el sistema; Environment identifica contextos como dev o producción; Infrastructure proporciona recursos; Tooling ayuda a construir, operar y observar.

Puntos clave
  • Architecture.
  • Stack.
  • Runtime y Runtime Profile.
  • Environment, Infrastructure y Tooling.

Ecosistema gobernado

Provider neutrality, IaC, Configuration Drift, CI/CD, Observability, Automation, Orchestration y Tool Catalog permiten que la tecnología soporte la solución sin convertirse en la metodología. Las herramientas se adoptan por evidencia, no por moda.

Puntos clave
  • Cloud/provider neutrality.
  • IaC y drift.
  • CI/CD y observability.
  • Tool Catalog y Vendor Intelligence.

Ownership por dominio y orquestación

DCP Flow separa business truth de coordinación. El backend/API o sistema dueño del dominio conserva la verdad durable; n8n u otro orquestador coordina flujos sin convertirse en base de datos paralela ni reconstruir reglas de negocio.

flowchart LR
A[Usuario / Sistema] --> B[API / Backend]
B --> C[(Domain Truth)]
B --> D[Persist / Accept]
D --> E[Outbox / Event]
E --> F[n8n Orchestrator]
F --> G[CRM / Provider / Channel]
G --> H[Outcome / Correlation]
H --> B
Diagram source
flowchart LR
A[Usuario / Sistema] --> B[API / Backend]
B --> C[(Domain Truth)]
B --> D[Persist / Accept]
D --> E[Outbox / Event]
E --> F[n8n Orchestrator]
F --> G[CRM / Provider / Channel]
G --> H[Outcome / Correlation]
H --> B
Puntos clave
  • Domain Truth Ownership.
  • API/backend owns business truth.
  • Orchestrator coordinates flow.
  • SAVE FIRST → AUTOMATE AFTER cuando aplica.

EspoCRM como CRM liviano ADOPTED

EspoCRM es la opción CRM liviana adoptada por DCP Flow cuando se necesita lifecycle comercial desacoplado sin introducir un ERP completo ni construir un CRM desde cero. ADOPTED no significa obligatorio: Solution Discovery y Project Truth siguen decidiendo si aplica.

Puntos clave
  • Blueprint propio.
  • Runtime profile propio.
  • Core/vendor read-only.
  • Entidades CRM contextuales, no universales.

Arquitectura, Stack, Runtime, Environment y Tooling responden preguntas distintas

Architecture describe estructura, responsabilidades y boundaries; Stack identifica las tecnologías principales; Runtime explica cómo ejecutan; Environment define el contexto operativo; Infrastructure aporta recursos; Tooling ayuda a construir, desplegar y observar. DCP Flow gobierna estas decisiones sin convertirse en una tecnología concreta.

flowchart TB
A[Architecture
responsabilidades y boundaries] --> B[Stack
tecnologias]
B --> C[Runtime
como ejecuta]
C --> D[Environment
donde y con que contexto]
D --> E[Infrastructure
recursos]
E --> F[Tooling
construir operar observar]
Diagram source
flowchart TB
A[Architecture
responsabilidades y boundaries] --> B[Stack
tecnologias]
B --> C[Runtime
como ejecuta]
C --> D[Environment
donde y con que contexto]
D --> E[Infrastructure
recursos]
E --> F[Tooling
construir operar observar]
Puntos clave
  • Architecture ≠ tool inventory.
  • Stack ≠ Runtime.
  • Branch ≠ Environment.
  • Tooling sirve a la metodología.

Runtime Profile y provider neutrality hacen explícito dónde puede vivir un sistema

Cada Blueprint activo debe expresar un Runtime Profile proporcional que cubra local, cloud target, compatibilidad CI/testing, shared hosting, persistencia, health y recovery. La arquitectura separa la capacidad que necesita —por ejemplo object storage— del servicio específico del proveedor. IaC ayuda a versionar infraestructura y detectar drift, pero no elimina Human Gates.

Puntos clave
  • Shared hosting: SUPPORTED / CONDITIONAL / NOT_SUPPORTED.
  • Capability ≠ provider service.
  • Runtime divergence debe ser conocida.
  • IaC reproducible no significa automáticamente autorizado.

CI, observabilidad y conocimiento de vendors son capacidades, no autoridad

CI automatiza evidencia repetible, pero un pipeline verde no equivale a aceptación humana. Observability responde qué señales necesitamos para detectar y diagnosticar, no qué producto debemos instalar. Vendor Intelligence aporta conocimiento oficial y version-aware sin permitir que la documentación del proveedor defina nuestra gobernanza. El Tool Catalog evita reinvestigación y distingue adopción de experimentación.

Puntos clave
  • CI result ≠ Human Acceptance.
  • Observability ≠ instalar una herramienta.
  • Vendor knowledge complementa, no gobierna.
  • EXPERIMENTAL ≠ ADOPTED.

Fullstack TypeScript: una nueva opción, no una obligación

DCP Flow incorpora un Blueprint Fullstack TypeScript en estado EVOLVING para aplicaciones interactivas con una API propia. React/Vite, Hono/Node, Zod y PostgreSQL/Drizzle forman la arquitectura de referencia, pero cada producto se clasifica primero por sus necesidades. Astro conserva su lugar para webs de contenido y Laravel para aplicaciones donde resulte más apropiado.

Puntos clave
  • Solution Discovery y Golden Flow antes de seleccionar stack.
  • Cinco skills especializadas, con Quality Gates transversales compartidos.
  • Repositorios y bases de datos independientes cuando la propiedad de producto lo exige.
  • EVOLVING no equivale a probado en producción.

Capas tecnológicas y decisiones proporcionales

DCP Flow no es un stack: distingue metodología, arquitectura, stack, runtime, tooling e infraestructura. Cada componente se elige por capacidad, costo total, mantenibilidad y evidencia, no por estar presente en otro proyecto.

Puntos clave
  • Consultar Blueprint y versión aplicables al iniciar Foundation.
  • Un runtime observado pesa más que una versión descrita en README.
  • El stack de Rewi no es obligatorio para una web Astro ni para un ERP adoptado.
Glosario contextual+
Architecture

Estructura de responsabilidades, boundaries y relaciones de una solución.

Stack

Conjunto de tecnologías concretas usadas para implementar una arquitectura.

Runtime Profile

Perfil reproducible del entorno de ejecución requerido por una solución.

IaC

Infraestructura como código: definición versionada y reproducible de infraestructura.

Observability

Capacidad de entender el estado del sistema mediante logs, métricas, trazas y señales.

Domain Truth Ownership

Asignación explícita de qué sistema posee la verdad durable de cada dominio; evita tratar una única herramienta como source of truth de todo.

Orchestration

Coordinación de pasos, sistemas o agentes. El orquestador coordina flujo; no debe apropiarse de business truth que pertenece al backend o sistema dueño del dominio.