Migrar um contrato de decisão do Jev sem confundir mudança de rótulos com mudança de comportamento

Objetivo

Trate alterações em rótulos de candidatos, descrições e mapeamentos downstream como uma migração de contrato que exige comparação de comportamento, mesmo quando a interface de transporte continua a mesma.

Pré-requisitos

Guarde as definições da pergunta anterior e da proposta, um conjunto de avaliação rotulado e o mapeamento do consumidor, que converte as respostas em comportamento da aplicação. Use exemplos de teste permitidos, e não dados pessoais de produção.

Passos

1. Identifique cada componente alterado: identificadores de opções, descrições, campos de estado, tratamento de valores padrão e ações do consumidor. Um rótulo renomeado e uma categoria ampliada exigem revisões diferentes, mesmo que ambos apareçam como uma pequena diferença de texto.

2. Quando for autorizado, execute a definição antiga e a nova sobre os mesmos fixtures permitidos. Guarde junto dos resultados os identificadores do modelo solicitado e do modelo retornado, para que mudanças na definição não sejam confundidas com mudanças no modelo.

3. Compare os resultados no nível das ações, e não apenas os rótulos das respostas. Um bug de mapeamento pode preservar a string esperada e, ainda assim, enviar o trabalho ao handler errado; por isso, teste a conversão completa passando pelo consumidor.

4. Examine exemplos próximos dos limites entre categorias e casos que devem continuar sem resolução. Não escolha limiares nem descrições apenas para corrigir os exemplos já usados na comparação.

5. Faça o rollout da definição e do mapeamento do consumidor como uma unidade compatível. Mantenha uma forma documentada de voltar ao contrato anterior e invalide as decisões em cache que se referem a significados obsoletos dos candidatos.

Resultado esperado

O registro da migração explica quais comportamentos mudaram de propósito e quais continuam incertos. Os consumidores nunca interpretam uma decisão antiga sob uma definição nova e incompatível sem uma conversão explícita.

Limites e base de verificação

Nenhuma migração foi executada aqui. A TypeSafe documenta as opções e descrições do Choice como parte da pergunta; o procedimento de release é uma proposta original. A concordância em um conjunto finito de fixtures não estabelece equivalência para todas as entradas. A interface ou o padrão subjacente está descrito em Choice; o fluxo de trabalho acima é uma adaptação proposta.