Feature flag na automação: ligar para um recorte

Portão que deixa passar só um grupo pequeno de cartões e segura o restante

Feature flag na automação escolhe quem passa pelo fluxo novo. Pode ser uma unidade, um tipo de pedido ou uma fração dos casos. O restante continua na versão que já está estável. A flag não é um interruptor escondido que alguém liga para todo mundo “só para ver”.

Sem recorte escrito, sem dono e sem data para retirar, a flag vira uma segunda configuração permanente. Daqui a um mês ninguém sabe qual caminho está valendo. O desenho inclui o fim da flag, não só a estreia.

Interruptor de um único segmento, com o restante do caminho inalterado
A flag abre para um recorte. O resto continua na versão anterior.

Qual recorte justifica a flag?

Um recorte que dá para explicar: uma loja, um tipo de documento, casos abaixo de um valor, uma lista de contas internas. Recorte aleatório só quando a pergunta é de comparação e a medição está pronta. “Ligar para ver” não é recorte.

O caso na fronteira tem regra. Ou entra, ou não. Dois caminhos para o mesmo pedido, dependendo de qual worker pegou, produzem estado duplo. A decisão usa a chave do caso, estável, não o acaso da hora.

O que fica ligado dos dois lados?

A versão nova e a anterior coexistem, as duas empacotadas. A flag só escolhe qual pacote atende aquele caso. Ela não edita o fluxo no meio. Quem olha o caso vê qual caminho ele tomou.

Efeito externo, como e-mail e cobrança, continua com a mesma chave nos dois caminhos. A flag não é desculpa para o retry criar o efeito duas vezes quando o caso muda de caminho no meio. O caso nasce num caminho e termina nele.

PeçaFunçãoNão é
RecorteQuem entra no fluxo novoInterruptor de tudo
PacotesVersão nova e anteriorEdição ao vivo
ChaveO caso não muda de caminhoSorteio a cada passo
PrazoData de retirar a flagConfiguração eterna

Como medir se o recorte prestou?

Antes de ampliar, compare o recorte com o restante: erro, retrabalho, tempo até o efeito e reclamação. Se o novo caminho piora, a flag fecha e o pacote anterior segue. Ampliar porque “já ligamos” não é leitura.

A amostra do recorte tem de ser grande o bastante para a falha aparecer. Uma loja minúscula que não tem o caso difícil não autoriza o restante. O recorte seguinte inclui o caso que dói, de propósito.

Quem pode ampliar ou desligar?

Quem responde pelo fluxo, com o mesmo registro da publicação. Ampliar de uma loja para todas é uma publicação, não um clique casual. O horário evita o meio do pico se a volta ainda não foi ensaiada.

Desligar é caminho feliz do desenho, não vergonha. A flag que ninguém pode desligar de noite não deveria estar ligada de noite. O runbook diz como fechar e o que acontece com o caso que já entrou no caminho novo.

Quando a flag sai do código?

Quando o caminho novo é o único, a flag sai. Manter as duas versões para sempre dobra teste, bug e explicação. A data de retirada entra na publicação. Flag vencida aparece numa lista, não fica esquecida num parâmetro.

Se a decisão é não adotar, sai o caminho novo, não a flag com o novo desligado para sempre. Caminho morto dentro do fluxo é onde o próximo incidente se esconde.

Um exemplo de mensagem nova ao cliente

O texto novo de confirmação liga primeiro para pedidos internos. A chave do pedido escolhe o caminho uma vez. O time compara reclamação e erro de uma semana. Se o texto se sustenta, a flag amplia para um tipo de pedido e, na data combinada, vira o único caminho. A versão antiga sai.

No meio da semana, um erro no texto novo faz o plantão fechar a flag. Os pedidos seguintes voltam ao texto anterior. Os que já receberam a mensagem nova ficam listados, não “desenviados”. A flag segurou o alcance.

Checklist prático

A flag está pronta quando dá para dizer quem entra, quem mede e quando ela acaba.

  • Recorte escrito, estável pela chave do caso
  • Versão nova e anterior empacotadas ao mesmo tempo
  • Caso não troca de caminho no meio
  • Medição de erro e retrabalho antes de ampliar
  • Quem pode ampliar e quem pode fechar, inclusive no turno
  • Runbook de como desligar
  • Data para retirar a flag
  • Lista de flags vencidas, sem caminho morto eterno

Erros comuns

A flag vira configuração secreta quando falta recorte ou prazo.

  • Ligar para todos porque o botão estava à mão
  • Sortear o caminho de novo a cada passo do mesmo caso
  • Ampliar sem olhar erro e retrabalho
  • Não ter como desligar de noite
  • Deixar a flag para sempre depois que o caminho único já foi escolhido
  • Manter o caminho rejeitado desligado dentro do fluxo
  • Não registrar qual caso tomou qual caminho
  • Achar que fechar a flag desfaz mensagem já enviada

Onde a flag entra na publicação?

Em automações de processos, feature flag é a publicação em recorte. O caminho anterior continua inteiro até a medição autorizar a troca.

Perguntas frequentes

▸Flag substitui versão?

Não. A flag escolhe entre versões já empacotadas. Sem os dois pacotes, não há para onde voltar. A flag é o recorte. A versão é o conteúdo de cada caminho.

▸Posso usar flag para esconder fluxo quebrado?

Pode desligar, e em seguida tirar o caminho. Flag fechada para sempre é código morto. O prazo de retirada vale também para o caminho que não foi adotado.

▸Recorte por porcentagem é válido?

É, se a chave do caso cai sempre no mesmo lado e se a medição está definida. Porcentagem que muda a cada chamada quebra o caso no meio. O sorteio é estável.

▸Quem enxerga que a flag existe?

Quem opera e quem responde pelo fluxo, numa lista única. Flag só no código, sem dono, é a que ninguém desliga no incidente. A lista mostra recorte, versão e data de fim.

▸O cliente pode cair nos dois textos?

Não deveria, se a chave é o pedido ou a conversa. Dois textos para o mesmo pedido são defeito de recorte. A regra “nasceu num caminho, termina nele” evita isso.

▸Flag em integração com efeito financeiro?

Só com teto, chave e alçada, e de preferência num recorte que não é o pagamento inteiro no primeiro dia. Ampliar efeito financeiro sem a medição do recorte pequeno é publicação geral com nome de flag.