Criterios de aceptación

Qué es

Los criterios de aceptación son las condiciones que debe cumplir un
cambio concreto para que pueda darse por válido. Describen qué se
podrá observar en unas circunstancias determinadas. «Enviar una
confirmación de la cita» nombra una función. «Al reservar una cita
disponible, la confirmación presenta la misma referencia y hora de
inicio que el registro de reserva» permite comprobar parte del
comportamiento y deja abierta la forma de generar esa confirmación.

El manual de servicios digitales del Gobierno británico describe los
criterios de una historia de usuario como una lista de resultados
con la que verificar que el servicio ha cumplido su cometido. La
historia explica quién necesita el servicio y para qué. Los
criterios concretan el acuerdo para que se pueda discutir,
implementar y verificar. También pueden cubrir una ruta de error, el
acceso mediante teclado o una restricción operativa, siempre que
sean pertinentes para aceptar ese cambio. Las distintas condiciones
pueden requerir distintas pruebas.

Conviene separar varios documentos. Una especificación puede definir
requisitos comunes a muchos cambios. Un caso de prueba describe una
ejecución que aporta evidencia de uno o varios criterios. La
Definición de Terminado de Scrum recoge las medidas de calidad que
debe cumplir el trabajo de un Incremento. Los criterios de
aceptación aclaran el comportamiento de un cambio particular. Un
equipo puede exigir acceso con teclado para cualquier elemento
interactivo y concretar, para un selector de fechas nuevo, que la
persona pueda elegir y revisar una cita usando solo el teclado.

Por qué importa

Un criterio útil saca a la luz una discrepancia cuando todavía es
fácil cambiar de rumbo. Para la persona responsable del servicio,
una cita puede estar reservada en el momento en que existe el
registro. Para quien pide la cita, puede no estarlo hasta que llegue
un correo. Atención al público quizá necesita una referencia para
contestar si ese correo se pierde. Son resultados diferentes.
Decidir cuándo se muestra el éxito y qué ocurre si falla el
proveedor de correo evita que la discrepancia aparezca por primera
vez en producción.

Los criterios marcan qué hay que observar. Una persona puede revisar
la pantalla de confirmación y otra interrumpir de forma controlada
el envío de mensajes. Las dos saben qué buscar. Un requisito de
accesibilidad quizá necesita recorrer los controles con el teclado
además de una comprobación automática. Un límite de tiempo necesita
un entorno conocido y una carga de referencia. «El sistema será
rápido» permite varias interpretaciones incompatibles.

Las normas y las obligaciones legales se siguen aplicando aunque no
se copien en la historia. Describe cómo se aplica una norma al
componente nuevo si sin esa precisión habría que adivinar la
respuesta. Para un calendario, puede bastar con indicar qué acciones
deben completarse con el teclado y citar el estándar de referencia.
Así el criterio queda acotado sin perder de vista al público que
depende de ese uso.

Cómo se aplica en la práctica

Imaginemos un servicio que permite reservar una cita y recibir un
mensaje de confirmación. El borrador dice «se reserva la cita y se
envía un correo». La persona que gestiona el servicio, quien lo
desarrolla y quien prepara la verificación pueden discutir tres
intentos concretos. Son ejemplos ilustrativos. Las condiciones
definitivas corresponden al equipo responsable del servicio.

  * Si hay una cita libre a las 14:00 en la zona horaria indicada,
se crea una sola reserva confirmada. Su referencia, fecha y hora
aparecen en pantalla y coinciden con el registro.

  * Si alguien ocupa ese mismo hueco antes de que se procese la
petición, se indica que la cita ya no está disponible y se ofrece
volver a los horarios libres. No aparece una reserva adicional para
el hueco ocupado.

  * Si falla el envío después de confirmar la cita, la reserva
permanece activa. La pantalla sigue mostrando la referencia y el
fallo queda visible para quien deba gestionarlo.

Cada ejemplo señala el estado previo, la acción y un resultado
comprobable. Gherkin les da una forma conocida con Dado, Cuando y
Entonces. Puede facilitar la lectura y el uso de pruebas
automáticas. Para una modificación pequeña también sirve una lista
breve. En ambos casos conviene precisar qué referencia se coteja y
desde dónde se observa el resultado. Ver que un correo salió de una
cola no acredita que haya llegado.

El primer intento se hace en la pantalla real. El segundo exige
controlar el orden de las solicitudes. Para el tercero se provoca el
fallo después de confirmar la transacción. Si se anotan esas
circunstancias y lo observado, otra persona podrá repetir la
verificación. Nuestra declaración de accesibilidad ofrece un ejemplo
relacionado. Describe pruebas con el teclado y señala qué se observó
y qué necesita más revisión. Un criterio de uso debería permitir
registrar evidencia de ese nivel de detalle.

Dónde surgen los problemas

Las expresiones vagas aplazan la discusión. «Se gestiona el error de
forma adecuada» deja abierta la respuesta ante un fallo. Especifica
cuándo aparece el mensaje, qué indica, qué acción queda disponible y
qué efecto no debe producirse. En la reserva, una captura que
muestra el aviso no basta para saber si se conservó el registro. Hay
que mirar también el estado de la cita.

Otro problema es convertir una opción técnica en el criterio antes
de justificarla. «Usar la cola nueva» puede ser una decisión de
arquitectura válida. A quien espera el correo le interesa saber qué
ocurre durante el retraso. Documenta la elección técnica donde se
puedan explicar sus motivos y redacta la condición con el
comportamiento observable. Si una integración externa exige un
protocolo concreto, cita el requisito y aclara dónde se aplica.

En el extremo opuesto, una lista puede acabar abarcando toda una
versión. Divide el trabajo por resultados y conserva junto a cada
uno su ruta de error importante. Acuerda qué reglas son comunes y
quién verifica el cambio particular. Si un ensayo muestra que falta
una condición, registra la razón del cambio en el criterio y repite
las verificaciones afectadas. La siguiente persona podrá saber qué
se había acordado y qué queda abierto.

Lecturas adicionales

  * Manual del Gobierno británico sobre historias y criterios de
aceptación

  * Referencia de Gherkin para describir escenarios y ejemplos

  * Definición de Terminado en la Guía Scrum

  * Guía del W3C para verificar el funcionamiento con el teclado

hEsta página en la web	URL:https://engineer.company/es/glossary/acceptance-criteria/	engineer.company	70
