Version: 1.0
Fecha: 16 de Marzo, 2026
Arquitecto: Carlos Alberto Torres Camargo
Esta seccion define como se gestiona el codigo fuente y como se despliega. Establece la estrategia de branching (GitFlow), la configuracion de los pipelines de integracion continua, y la hoja de ruta para escalar los pipelines a ambientes QA y produccion.
Orden de lectura: GitFlow (como trabajamos con ramas) → Pipeline CI/CD (como se construye y despliega) → Hoja de Ruta QA/PROD (como escalar a otros ambientes).
| # | Documento | Descripcion |
|---|---|---|
| 1 | GitFlow Detallado | Estrategia de branching: Modelo A (qa permanente), convenciones de ramas, flujo de promocion develop->qa->main, hotfixes |
| 2 | Pipeline CI/CD | Configuracion del pipeline de integracion y despliegue continuo (Jenkins) |
| 3 | Hoja de Ruta CI/CD QA-PROD | Guia para replicar el pipeline DEV en ambientes QA y produccion. Mitigacion de fixes detectados en QA |
| 4 | Flujo HT a Produccion | Documento end-to-end: ciclo de vida de una HT desde architecture/htu hasta el tag de release |
| 5 | Definition of Done | Criterios DoD corporativos por nivel: DoD-DEV (pre-merge develop), DoD-QA (pre-promocion qa), DoD-PROD (pre-release main) |
| 6 | Politica de Regresion QA | Procedimiento, SLAs y ciclos de retrabajo cuando QA rechaza casos durante la Fase 5 (Validacion) |
| 7 | Politica de Rollback | Criterios de bug critico, autorizacion, procedimiento tecnico, comunicacion y post-mortem para rollbacks en QA y PROD |
| 8 | Integracion Vault Jenkins | Plan de integracion al pipeline compartido para repos Vault: backend Python+FastAPI (datavault-backend, datavault-oais-server) y frontend Nx Angular (nebula-vault). Disena pythonServicePipeline(), angularNxPipeline() y libraryPipelineNpm() en centrica-pipeline-shared v1.1.0 |
| 9 | Guia Jenkins Setup Vault | Procedimiento paso a paso para que el arquitecto configure Jenkins (plugins, tool Node-22, Python 3.11 en agente, credenciales Nexus npm, jobs multibranch + webhooks GitLab, smoke test) — Fase 3 del plan Vault |
Referencia clave: ADR-003 Politica Entrega QA en seccion 01-arquitectura formaliza el flujo en 8 fases con gates A-G que rigen toda esta seccion.
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 2.2.0 | 2026-05-12 | Carlos Torres | Anadida GUIA_JENKINS_SETUP_VAULT (item 9). Procedimiento operativo paso a paso para configurar Jenkins durante el piloto Vault. |
| 2.1.0 | 2026-05-11 | Carlos Torres | Anadido INTEGRACION_VAULT_JENKINS (item 8). Plan para incorporar repos Vault Python y Nx Angular al pipeline compartido v1.1.0. |
| 2.0.0 | 2026-05-11 | Carlos Torres | Anadidos DEFINITION_OF_DONE, POLITICA_REGRESION_QA, POLITICA_ROLLBACK (items 5-7). Referencia a ADR-003 Politica Entrega QA. Cambio mayor por incorporacion del paquete de proceso formal. |
| 1.1.0 | 2026-05-07 | Carlos Torres | Anadido FLUJO_HT_A_PROD (end-to-end). Descripciones actualizadas para reflejar Modelo A (rama qa permanente) y mitigacion fixes QA. |
| 1.0.0 | 2026-03-16 | Carlos Torres | Creacion del indice de seccion |