Migrar un contrato de decisión de Jev sin confundir etiquetas cambiadas con comportamiento cambiado

Objetivo

Tratar las ediciones de etiquetas candidatas, descripciones y mapeos posteriores como una migración de contrato que necesita comparación de comportamiento, incluso cuando la interfaz de transporte permanece sin cambios.

Requisitos previos

Conservar las definiciones de la pregunta anterior y la propuesta, un conjunto de evaluación etiquetado y el mapeo del consumidor de respuestas a comportamiento de la aplicación. Usar ejemplos de prueba permitidos en lugar de datos personales de producción.

Pasos

1. Identificar cada componente cambiado: identificadores de opción, descripciones, campos de estado, manejo por defecto y acciones del consumidor. Una etiqueta renombrada y una categoría ampliada requieren revisiones distintas aunque ambas aparezcan como un diff de texto pequeño.

2. Ejecutar las definiciones antigua y nueva contra los mismos fixtures permitidos cuando esté autorizado. Conservar los identificadores de modelo solicitados y devueltos junto con los resultados, para que los cambios de definición no se confundan con cambios de modelo.

3. Comparar los resultados a nivel de acción además de las etiquetas de respuesta. Un error de mapeo puede conservar la cadena esperada mientras envía el trabajo al manejador equivocado, así que hay que probar la conversión completa a través del consumidor.

4. Inspeccionar los ejemplos cercanos a los límites de categoría y los casos que deberían permanecer sin resolver. No elegir los umbrales o las descripciones únicamente para arreglar los ejemplos ya usados en la comparación.

5. Desplegar la definición y su mapeo de consumidor como una unidad compatible. Conservar una forma documentada de volver al contrato anterior e invalidar las decisiones en caché que se refieran a significados de candidatos obsoletos.

Resultado esperado

El registro de la migración explica qué comportamientos cambiaron de forma intencionada y cuáles siguen siendo inciertos. Los consumidores nunca interpretan una decisión antigua bajo una definición nueva e incompatible sin una conversión explícita.

Límites y base de verificación

Aquí no se ha ejecutado ninguna migración. TypeSafe documenta las opciones y descripciones de Choice como parte de la pregunta; el procedimiento de release es una propuesta original. El acuerdo sobre un conjunto finito de fixtures no establece equivalencia para toda entrada. La interfaz o el patrón subyacente se describe en Choice; el flujo de trabajo anterior es una adaptación propuesta.