Skip to content
mobius1qwe edited this page Nov 16, 2026 · 1 revision

Home > Plugins > Feature flags 🚧

Feature flags

Important

Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.

Vale para a 2.0 · Delphi XE em diante e Lazarus/FPC 3.2 em diante · Nível: intermediário

Em uma frase: o TRALFeatureFlags liga e desliga recursos sem gerar um executável novo: para todos, para uma parte dos usuários (sempre os mesmos), para uma lista de usuários ou papéis, ou entre duas datas; rotas de um recurso desligado respondem 404.

Você vai precisar: o pacote RALPluginFeatureFlagsPackage (requer o RALHostingPackage, da configuração externa).

No Object Inspector

  1. Solte um TRALFeatureFlags no form e ligue Server (é um plugin; funciona também sem servidor, só com IsEnabled).
  2. Em Flags, um item por recurso:
propriedade o que é
Name o nome que o código e a configuração usam (checkout-novo)
Enabled a chave geral: desligada, ninguém tem
Percentage a parte dos usuários que tem o recurso, de 0 a 100
Users, Roles usuários e papéis que sempre têm, um por linha
StartDate, EndDate de quando até quando vale (0 = sem limite)
Paths rotas que só existem com o recurso ligado (/checkout/novo); desligado, 404

A parte dos usuários

Percentage usa um número fixo de cada usuário para aquele recurso (um hash do nome do recurso e do usuário): o mesmo usuário cai sempre do mesmo lado, e subir de 20 para 50 só acrescenta usuários, ninguém que tinha perde. O usuário de um pedido é o nome da identidade (quem fez login); sem login, o endereço do cliente.

No código

if FFlags.IsEnabled('checkout-novo', ARequest) then   // o usuário do pedido
  MontarCheckoutNovo(AResponse)
else
  MontarCheckoutAntigo(AResponse);

if FFlags.IsEnabled('relatorio-beta', 'ana') then ...  // um usuário qualquer

OnEvaluate deixa o código ter a última palavra (um cliente pagante, por exemplo).

Pela configuração externa

Com Config ligado a um TRALConfig, os recursos também vêm do arquivo, das variáveis de ambiente e da linha de comando, com o prefixo ConfigPrefix (padrão Flags):

{
  "Flags": {
    "checkout-novo": { "Enabled": true, "Percentage": 20, "Users": ["ana", "bia"] },
    "relatorio-beta": { "Roles": ["beta"], "Percentage": 0, "EndDate": "2026-12-31" }
  }
}
  • O que vem da configuração soma-se aos itens do Object Inspector e, no mesmo nome, vence.
  • Uma mudança no arquivo vale sem reiniciar: o plugin olha o arquivo no máximo a cada ReloadInterval milissegundos (padrão 2000) e OnChange avisa. Reload força.
  • Datas: aaaa-mm-dd ou aaaa-mm-ddThh:nn:ss, na hora local.

Erros comuns

sintoma causa o que fazer
a rota responde 404 para todos Enabled desligado, ou fora das datas confira o item e a configuração
o mesmo usuário vê ora um, ora outro sem login, o "usuário" é o endereço do cliente faça o login antes, ou passe o usuário a IsEnabled
a mudança no arquivo não pegou ReloadInterval 0, ou o arquivo é outro Reload, ou confira Config.FileName

Veja também

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally