Entitlements e Feature Flags
O sistema de entitlements controla quais funcionalidades estao ativas para cada tenant. Ele combina o plano base contratado com add-ons adquiridos na Loja Opero e concessoes manuais da equipe de suporte.
Como Funciona
Cada tenant possui um conjunto de feature keys ativas. Essas chaves determinam:
- Quais modulos aparecem no menu lateral
- Quais endpoints da API estao disponiveis
- Quais permissoes CASL sao efetivamente aplicadas
Plano (Basic/Professional/Enterprise)
↓
Plan Defaults (features inclusas no plano)
+
Add-ons da Loja (compras via Store)
+
Concessoes N1 (grants manuais do suporte)
=
Entitlements Efetivos do TenantFontes de Entitlements
Cada entitlement ativo possui uma fonte que indica como foi habilitado:
| Fonte | Descricao | Quem ativa |
|---|---|---|
PLAN_DEFAULT | Incluso no plano contratado. Ativado automaticamente na criacao do tenant. | Sistema |
STORE_PURCHASE | Comprado pelo tenant na Loja Opero. Vinculado a um add-on no contrato. | Usuario do tenant |
N1_GRANT | Concedido manualmente pelo Superuser N1. Usado para trials, cortesias ou suporte. | Equipe Opero |
Planos e Features Padrao
O plano (Basic, Professional ou Enterprise) e definido pela equipe Opero ao criar a conta. Hoje todos os planos recebem as mesmas features padrao:
| Feature | Basic | Professional | Enterprise |
|---|---|---|---|
PMS Core (pms.core) | Sim | Sim | Sim |
Financial Basic (financial.basic: COA/USALI, razao, AP/AR, caixa, conciliacao) | Sim | Sim | Sim |
Dominio customizado do portal (custom_domain) | Sim | Sim | Sim |
Moedas padrao: local + USD ou EUR (multi_currency.default) | Sim | Sim | Sim |
Retencao de auditoria de 30 dias (audit.retention_30d) | Sim | Sim | Sim |
Suporte da comunidade (support.community) | Sim | Sim | Sim |
Todo o resto — gateways de pagamento (inclusive o Opero Payment), Financial Overview Services, Orcamento, Ativo Imobilizado, Intangiveis, Emprestimos, Estoque, NFS-e, API, retencao de auditoria estendida, channel manager, Operations Services e suporte pago — e add-on da Loja.
Nota: Features nao inclusas no plano podem ser adquiridas individualmente na Loja Opero.
Tipos de Cobranca
Cada feature no catalogo possui um tipo de cobranca:
| Tipo | Descricao | Exemplo |
|---|---|---|
| FREE | Inclusa gratuitamente no plano | PMS Core |
| FLAT_MONTHLY | Valor fixo mensal adicionado a fatura | Financial Overview Services: US$ 49/mes |
| METERED | Cobrado por uso (por requisicao, por GB, etc.) | Armazenamento de auditoria: US$ 0,50 por GB-mes |
| TIERED | Valor fixo mensal + cobranca por uso | API Read/Write: US$ 149/mes + US$ 0,001 por requisicao |
Visualizar Entitlements Ativos
Para ver quais features estao ativas no seu tenant:
- Acesse Configuracoes > Planos e Recursos
- A tela (somente leitura) mostra:
- Funcionalidades ativas, com nome e descricao
- Nivel de suporte (community, business ou enterprise)
- Acesso a API (nenhum, somente leitura ou leitura/escrita)
Comprar Add-ons
Para ativar uma feature que nao esta no seu plano:
- Acesse a Loja no menu lateral (secao Configuracoes)
- Navegue pelo catalogo de funcionalidades
- Clique em “Ativar” na feature desejada
- Confirme — o valor sera adicionado a sua proxima fatura
- A feature e ativada imediatamente
A compra exige um contrato de pagamento ativo do tenant com a Opero. Sem ele, a Loja recusa a contratacao e o suporte Opero precisa criar o contrato antes.
Para cancelar um add-on:
- Acesse a Loja
- Localize o add-on ativo
- Clique em “Desativar”
- A feature sera desativada; o mes corrente ainda e cobrado e as proximas faturas deixam de incluir o add-on
Sem fidelidade: Add-ons podem ser cancelados a qualquer momento, sem multa.
Concessoes N1 (Administracao Opero)
Superusuarios N1 podem conceder ou revogar features manualmente para qualquer tenant:
| Acao | Endpoint | Descricao |
|---|---|---|
| Listar entitlements | GET /api/superuser/tenants/:id/entitlements | Ver features ativas de um tenant |
| Conceder feature | POST /api/superuser/tenants/:id/entitlements | Ativar feature com motivo |
| Revogar feature | DELETE /api/superuser/tenants/:id/entitlements/:key | Desativar feature com motivo |
O motivo (reason) da concessao ou revogacao fica gravado no proprio registro do entitlement.
Casos de uso:
- Trial gratuito de 30 dias de uma feature premium
- Cortesia para parceiros estrategicos
- Ativacao emergencial durante investigacao de suporte
Impacto nos Papeis (CASL)
Os entitlements interagem diretamente com o sistema de permissoes:
- O papel do usuario define o que ele pode fazer (acoes sobre entidades)
- Os entitlements definem quais entidades existem para o tenant
- Se uma feature esta desabilitada, as entidades relacionadas ficam inacessiveis — mesmo para admins
Exemplo: Se o tenant nao contratou o add-on Estoque (financial.inventory), nem um usuario com papel Admin consegue acessar o estoque: o item some do menu e a tela informa que o modulo nao esta contratado, com link para a Loja.
Perguntas Frequentes
Posso testar uma feature antes de comprar? Sim. Entre em contato com o suporte para solicitar um trial. A equipe N1 pode conceder acesso temporario.
O que acontece com meus dados se eu cancelar um add-on? Os dados nao sao excluidos. Eles ficam preservados mas inacessiveis ate que a feature seja reativada.
Posso mudar de plano? O plano e definido pela equipe Opero na criacao da conta e hoje todos os planos incluem as mesmas features padrao. O que muda o que voce tem acesso sao os add-ons da Loja.