Documentación

Contratos de resultados

Lo que se entiende por 'finalizado' para una tarea va más allá de la fusión de un pull request, y lo define la persona que la solicitó.

Las pruebas y la revisión confirman que el cambio cumple con lo estipulado. Un contrato de resultado Indica qué debe ser cierto una vez desplegado y cómo se podrá verificar: qué flujos funcionan, qué error deja de aparecer, en qué rutas, tras qué volumen de tráfico y durante cuánto tiempo.

Toda nueva tarea tiene uno. Pertenece a la persona que solicitó el trabajo, nunca al agente que lo implementa; así, el agente que realiza el trabajo no puede redefinir el éxito.

Dónde puedes verlo

Abre la tarea en Fábrica. La Contratos de resultado tarjeta muestra cada contrato con su tipo, versión, estado, condición de éxito, la exposición necesaria y el tiempo que se monitoriza.

Cómo se crea un contrato

Coroid redacta el contrato técnico al crear la tarea, basándose en lo que ya indica la solicitud:

  • A partir de los criterios de aceptación. Una tarea con criterios de aceptación — a partir de su especificación o de su plan — obtiene un borrador cuya condición de éxito es que esos flujos funcionen, comprobado mediante una prueba de navegador.
  • A partir de una señal. Una solicitud procedente de la monitorización, de una automatización o del sistema de ingesta de trabajo API lleva consigo la señal correspondiente: el error, la alerta o el problema. Su contrato establece que esa señal desaparezca —sin nuevos eventos con esa huella y de esa fuente— una vez que el cambio haya atendido suficientes solicitudes en las rutas afectadas y permanezca inactiva durante 24 horas. La solicitud debe indicar las rutas y el número de solicitudes; consulta el campo signal del sistema de ingesta de trabajo API.
  • A partir de algo no medible. Sin criterios de aceptación ni señal con rutas y conteo, se crea el contrato final y no medible. Lo indica tal cual, sin fingir lo contrario.

Esto se aplica a todas las tareas, incluidas las que Coroid crea como parte de un plan, a partir de automatizaciones o como reparaciones. Las tareas existentes antes de la introducción de los contratos no tienen uno.

Finalizar y modificar un contrato

Un borrador se puede editar. Finalizar lo consolida. Después, Nueva versión guarda el cambio como la siguiente versión y conserva la anterior, para que siempre puedas ver qué se prometió al iniciar el trabajo.

Solo la persona que solicitó el trabajo puede redactar sus contratos; o, para trabajos admitidos bajo un mandato, el propietario del mandato. Los agentes y cuentas de servicio no pueden crear, editar ni finalizar un contrato.

Resultados

Un contrato finaliza con uno de cuatro resultados:

ResultadoSignificado
VerificadoLa condición de éxito se cumplió tras la exposición y el período requeridos.
No cumplidoNo fue así.
InconclusivoEl cambio nunca recibió suficiente exposición para determinarlo.
No medibleNo había nada que pudiera medirse.

Contratos y fusiones

Un contrato nunca fusiona nada ni bloquea una fusión. La fusión sigue siendo una decisión humana, como se describe en Revisar y fusionar el resultado. El contrato registra lo que se pretendía lograr con esa fusión.