RESPOSTA

Como descobrir regras de negócio escondidas no legado?

Revisado em · Revisado por Paulo Pierrondi, fundador.

Regras de negócio escondidas aparecem quando você observa o que o sistema legado faz de verdade, não o que o manual diz. O caminho é registrar entradas e saídas reais durante um ciclo completo do processo, ler o código e os logs onde há exceções e transformar cada comportamento encontrado numa regra escrita, com dono, exemplo e critério de teste. Regra que não foi escrita não entra no contrato de equivalência, e o que fica fora do contrato vira surpresa no cutover.

Passo a passo

  • Capture entradas e saídas reais durante um ciclo inteiro do processo, incluindo fechamento de mês e exceções sazonais.
  • Leia o código, as procedures e os jobs agendados procurando condicionais, tabelas de parâmetros e valores fixos no código.
  • Entreviste quem opera o processo e anote ajustes manuais, planilhas paralelas e contornos que viraram rotina.
  • Escreva cada regra com dono, exemplo de entrada, saída esperada e a evidência de onde ela foi encontrada.
  • Valide as regras rodando o substituto em paralelo e trate cada divergência nova como uma possível regra ainda não mapeada.

Como um agente faz isso

Na AgenticosCore a descoberta alimenta o contrato de equivalência. O agente roda em sombra no Paralelo, cada divergência vira candidata a regra na Trilha, e nenhuma regra nova entra no contrato sem a aprovação de um responsável seu.

Perguntas frequentes

Dá para descobrir as regras só lendo o código?

Raramente. Parte das regras vive em parâmetros, dados históricos e na prática da equipe. O código mostra o que pode acontecer, e a observação das saídas reais mostra o que acontece.

O que fazer com uma regra que ninguém sabe explicar?

Registre a regra com a evidência encontrada e defina um dono para decidir. Ela pode ser preservada, corrigida ou aposentada, mas a decisão precisa estar escrita antes do corte.

Fontes primárias