Una HT no está entregada porque su código esté en develop. Está entregada cuando alguien puede leer qué se hizo, cómo se configuró el ambiente, qué se probó y qué falló — sin abrir el repositorio ni preguntarle al que la hizo.
Esta sección define los dos documentos que sostienen esa afirmación y el formato del registro en OpenProject, con el ejemplo ya producido.
Comparten propósito pero no alcance ni dirección. Fue la confusión que motivó separarlos por nombre (09-ago-2026).
CERTIFICACION_ENTREGA.md |
QA_HANDOFF.md |
|
|---|---|---|
| Alcance | UNA HT | EL LOTE del sprint |
| Momento | Al quedar mergeada a develop y desplegada en dev |
Al cerrar el sprint, antes de promover develop → qa |
| Dirección | Mira hacia atrás: evidencia de lo que ya se entregó | Mira hacia adelante: qué debe probar QA |
| Ubicación | architecture/sprint-N/entregas/HT_XXX_NNN_Nombre/ |
architecture/sprint-N/ |
| Plantilla | nebula-erp/pipeline/templates/TEMPLATE_CERTIFICACION_ENTREGA.md |
nebula-erp/QA_HANDOFF_TEMPLATE.md |
| Origen | Estandarizado 09-ago-2026 | ADR-003 (11-may-2026) |
El
QA_HANDOFFdel lote se apoya en las certificaciones de cada HT; no las reemplaza. Sin las certificaciones, el handoff del lote se escribe de memoria.
Verificado el 09-ago-2026:
| Sprint | QA_HANDOFF.md |
Nota |
|---|---|---|
| 0 · 1 · 2 · 3 · 4 | Sí | Diligenciados de verdad (311–471 líneas, 32–39 HT referenciadas) |
| 5 · 6 · 7 · 8 | No | El artefacto se dejó de producir pese a estar definido en el ADR-003 |
| 9 | No | Pendiente al cierre del sprint |
En el sprint-8, en lugar del artefacto, se produjeron dos documentos sueltos en auditorias/ —EVIDENCIA_PRUEBAS_CIERRE_CONTABLE_CON_022.md (la corrida) y GUIA_QA_AMBIENTE_FACTURACION_FAT_004.md (el ambiente)—, de criterio distinto y sin garantía de repetirse. De ahí sale el formato de CERTIFICACION_ENTREGA: fusiona esas dos mitades. Sin la configuración QA no puede repetir la prueba; sin la prueba no hay evidencia de que lo entregado funcione.
CERTIFICACION_ENTREGA.mdTres páginas, en este orden. Cada una responde una pregunta distinta y no se solapan:
| Página | Responde | |
|---|---|---|
| 1 | TEMPLATE_CERTIFICACION_ENTREGA |
Qué se escribe. La plantilla literal, para copiar. Su fuente canónica es architecture/nebula-erp/pipeline/templates/ |
| 2 | CATALOGO_EVIDENCIAS_CERTIFICACION |
Qué se adjunta. Las tres evidencias obligatorias, las que dependen del alcance de la HT, y por qué architecture es GitLab y no recibe videos |
| 3 | EJEMPLO_CERTIFICACION_HT_PRE_011 |
Con qué detalle se llena. Una entrega completa del sprint-10: el documento y sus once evidencias, literales |
Se leen en ese orden: la plantilla dice qué secciones hay, el catálogo qué las acompaña, y el
ejemplo muestra el resultado. Ninguna reemplaza a las otras.
Un directorio por HT, con su carpeta de evidencias:
architecture/sprint-N/
QA_HANDOFF.md <- lote del sprint (ADR-003)
entregas/
HT_PRE_006_CatalogoRubros/
CERTIFICACION_ENTREGA.md
evidencias/
01_certificacion.txt
catalogo_import_qa.csv
catalogo_export_qa.csv
HT_PRE_007_CreacionRubros/
CERTIFICACION_ENTREGA.md
evidencias/
| # | Sección | Qué resuelve |
|---|---|---|
| 1 | Identificación y build certificado | Versiones, MR y merge commits. Librerías antes que consumidores, con la publicación en Nexus verificada |
| 2 | Alcance entregado | Endpoints y decisiones de arquitectura con su porqué |
| 3 | Configuración aplicada | Maestros y parámetros con el porqué de cada valor — sin él QA no sabe qué puede cambiar |
| 4 | DDL e i18n aplicados | Scripts, estado de los objetos, claves sin par |
| 5 | Pruebas ejecutadas | Tabla caso · verificación · resultado, y los rechazos de negocio |
| 6 | Defectos que las unitarias NO vieron | Los que solo aparecen contra el ambiente |
| 7 | Lo que NO se puede probar y por qué | Un alcance silenciado es un defecto que QA descubre tarde |
| 8 | Cómo reproducir en QA | Scripts en orden, datos mínimos, flujo |
| 9 | Datos sembrados que quedan | QA y el siguiente sprint trabajan sobre ese ambiente |
| 10 | PENDIENTE | Qué falta, qué requiere decisión, deuda documentada |
api-dev), no contra un servicio local.La HT entregada se cierra en su work package, con la evidencia en comentarios. La estructura sale de lo que ya se hacía en el sprint-8; aquí queda fijada.
Nuevo → En curso → En prueba → Por mergear (Desarrollado) → Cerrado al quedar mergeada y desplegada.
repo · versión · MR · merge commit. La librería antes que el consumidor, con la publicación en Nexus verificada y cómo se verificó.CERTIFICACION_ENTREGA.md.Si la HT se recertifica después, va un comentario nuevo — no se edita el anterior. El historial del work package es parte de la evidencia.
| HT | Work package | Certificación | Evidencias |
|---|---|---|---|
HT_PRE_006 Catálogo de Rubros |
#1017 · Cerrado | CERTIFICACION_ENTREGA.md |
12 casos + 7 rechazos contra api-dev |
HT_PRE_007 Creación de Rubros |
#1018 · Cerrado | CERTIFICACION_ENTREGA.md |
19 casos + 10 rechazos, 3 archivos de import |
Ambos sirven como referencia de diligenciamiento. Dos detalles que conviene imitar:
TEMPLATE_CERTIFICACION_ENTREGA — la plantilla, literal
CATALOGO_EVIDENCIAS_CERTIFICACION — qué evidencia adjuntar según el alcance
EJEMPLO_CERTIFICACION_HT_PRE_011 — una entrega completa, con sus evidencias
nebula-erp/pipeline/templates/TEMPLATE_CERTIFICACION_ENTREGA.md — plantilla por HT
nebula-erp/QA_HANDOFF_TEMPLATE.md — plantilla del lote del sprint
ADR-003 Política Formal de Entrega a QA — flujo de 8 fases, artefactos y RACI
| Versión | Fecha | Cambio |
|---|---|---|
| 1.2.0 | 2026-08-25 | Se ordena la entrada: las tres páginas quedan cableadas en secuencia —plantilla, catálogo, ejemplo—, cada una con la pregunta que responde. El ejemplo diligenciado pasa a página propia (EJEMPLO_CERTIFICACION_HT_PRE_011) con las evidencias literales; embebido en la plantilla confundía los tres artefactos. |
| 1.1.0 | 2026-08-25 | Se publica la plantilla en la wiki, literal y copiable, y se incorpora el Catálogo de Evidencias, que define qué se adjunta según el alcance de la HT y prohíbe los videos: architecture es GitLab y su historia es permanente. |
| 1.0.0 | 2026-08-09 | Sección creada. Se separa CERTIFICACION_ENTREGA (por HT) de QA_HANDOFF (por lote) y se fija el formato del registro en OpenProject, con el ejemplo del sprint-9. |