Visão Geral do Policy Engine
O que é o Policy Engine?
O Policy Engine é o sistema que governa como os entitlements se comportam ao longo de todo o seu ciclo de vida. Em vez de codificar regras de negócio diretamente no código-fonte do plugin, o MIDDAG Account as externaliza como policies — regras configuráveis que você pode ajustar pelo admin do WordPress sem tocar em uma única linha de código.
Todo entitlement no sistema — seja ele uma licença de software, um ambiente de hospedagem gerenciada ou um contrato de serviço — segue regras definidas por policies. Quando deve ocorrer uma tentativa de renovação? Quantos dias de carência o cliente recebe após uma falha no pagamento? O cliente pode solicitar reembolso após 15 dias? O Policy Engine responde a todas essas perguntas.
Por que regras configuráveis?
Lógica hardcoded quebra quando o negócio muda. Um período de carência de 7 dias que funciona para licenças de plugin pode ser curto demais para contratos de serviço enterprise. Uma janela de reembolso adequada ao mercado americano pode não atender às exigências do Código de Defesa do Consumidor brasileiro.
O Policy Engine permite que você defina padrões sensatos uma única vez e depois os sobrescreva onde necessário — sem alterações de código, sem deploys e sem risco de quebrar comportamentos não relacionados.
As 10 policies
O MIDDAG Account vem com 10 policies que cobrem todo o ciclo de vida do entitlement:
| Policy | O que governa |
|---|---|
| Renewal | Renovação automática, períodos de carência, precificação na renovação |
| Payment Recovery | O que acontece quando um pagamento falha, tempo de suspensão até cancelamento |
| Cancellation | Visibilidade pós-expiração, retenção de dados, exportação de dados |
| SLA | Tempos de resposta, tempos de resolução, metas de uptime, escalonamento |
| Credit | Expiração de créditos, ordem de consumo, limites de saldo negativo |
| Provisioning | Provisionamento automático vs manual, fluxos de aprovação, desprovisionamento |
| Trial | Duração do trial, comportamento de conversão, prevenção de abuso |
| Refund | Janela de reembolso, limites para aprovação automática, impacto no entitlement |
| Tier Change | Timing de upgrade/downgrade, períodos de cooldown, requisitos de aprovação |
| Notification | Canais, timing de lembretes, configurações de opt-out |
Cada policy está documentada em detalhe na página Policies Disponíveis.
A hierarquia de 5 níveis
Policies não são uma solução única para todos os casos. O Policy Engine utiliza uma hierarquia de 5 níveis para que você possa definir padrões amplos e depois refiná-los onde necessário:
O nível mais específico vence. Se você definir um período de carência de 7 dias globalmente, mas sobrescrevê-lo para 30 dias na Organização X, então a Organização X recebe 30 dias. Todas as outras organizações continuam com 7 dias.
Essa hierarquia é abordada em profundidade na página Hierarquia de Policies.
Como as policies afetam o ciclo de vida do entitlement
Entitlements transitam por quatro estados: ativo, suspenso, expirado e cancelado. As policies controlam as regras em cada transição:
- Ativo para Suspenso — A Payment Recovery Policy decide quando uma falha de pagamento aciona a suspensão (imediatamente ou após esgotar todas as retentativas).
- Suspenso para Ativo — A Payment Recovery Policy controla se a reativação é automática quando o pagamento é bem-sucedido.
- Suspenso para Cancelado — A Payment Recovery Policy define quantos dias um entitlement permanece suspenso antes do cancelamento automático.
- Ativo para Expirado — A Renewal Policy determina quando e como a renovação é tentada antes da expiração.
- Expirado para Ativo — A Renewal Policy governa a janela de carência para renovação.
- Expirado para Cancelado — A Cancellation Policy define quanto tempo um entitlement expirado aguarda antes do cancelamento automático.
- Cancelado para Ativo — Reativação win-back, governada por regras de provisioning e renewal.
As policies também controlam o que acontece em torno dessas transições: notificações enviadas, dados retidos, créditos ajustados e recursos provisionados ou desprovisionados.
Quando você alteraria uma policy?
Cenários comuns em que um admin ajusta policies:
- Um novo cliente enterprise precisa de um período de carência maior na recuperação de pagamento. Sobrescreva a Payment Recovery Policy no nível da organização para conceder 60 dias em vez de 30.
- Você lança um programa de trial para seu produto de hospedagem. Habilite a Trial Policy no nível da Entitlement Class Environment.
- Um contrato de alto valor exige tempos de resposta de SLA mais rápidos. Sobrescreva a SLA Policy no nível do entitlement individual.
- Você expande para um novo mercado onde as janelas de reembolso são diferentes. Ajuste a Refund Policy no nível global ou do produto.
- Um cliente está abusando de mudanças de tier, alternando entre planos toda semana. Defina um cooldown de 30 dias na Tier Change Policy para a organização dele.
Para que você NÃO precisa do Policy Engine
O Policy Engine governa regras de comportamento de entitlements. Ele não lida com:
- Precificação de produtos — gerenciada nas configurações de produto do WooCommerce.
- Permissões de usuário — gerenciadas por meio de roles e escopos de colaboradores.
- Configuração de integrações — gerenciada no painel de configurações de Integrações.
- Regras fiscais e tributárias — regidas por exigências legais, não por policies configuráveis. A retenção de dados fiscais segue as exigências da LGPD e da legislação tributária independentemente das configurações de policy.
Próximos passos
- Policies Disponíveis — referência detalhada de todas as 10 policies
- Hierarquia de Policies — como funciona o sistema de sobrescrita em 5 níveis
- Configurando Policies — onde encontrar e alterar configurações de policies
- Receitas de Policies — guias passo a passo para configurações comuns