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 (develop/qa/main + rama opcional pre), convenciones de ramas, flujo de promocion develop->qa->main, hotfixes |
| 2 | Pipeline CI/CD | Configuracion del pipeline de integracion y despliegue continuo (Jenkins) |
| 2a | Libreria Pipeline Compartida | Referencia canonica de centrica-pipeline-shared: versionado, setup Jenkins, entry points microservicePipeline/libraryPipeline, ambientes, estructura interna y lane -pre |
| 2b | Lane -pre (DEV) | Despliegue paralelo <servicio>-pre por la rama opcional pre: validar/corregir en DEV sin recrear el canonico (evita caidas del frontend). Mecanismo (Eureka/gateway/config), infra (pre-config, api_route, deployPreLane) |
| 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.4.0 | 2026-06-02 | Carlos Torres | Anadido LIBRERIA_PIPELINE_SHARED (item 2a). Referencia canonica de la Jenkins Shared Library (antes solo el README del repo). |
| 2.3.0 | 2026-06-02 | Carlos Torres | Anadido LANE_PRE_DEV (item 2b). Rama permanente opcional pre para despliegue paralelo -pre en DEV (validar/corregir sin recrear el canonico); GITFLOW_DETALLADO actualizado. Flujo estandar develop->qa->main sin cambios. |
| 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 |