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 (Starter/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. | Admin do tenant |
N1_GRANT | Concedido manualmente pelo Superuser N1. Usado para trials, cortesias ou suporte. | Equipe Opero |
Planos e Features Padrao
Ao criar uma conta, o tenant recebe automaticamente as features do seu plano:
| Feature | Starter | Professional | Enterprise |
|---|---|---|---|
| PMS Core (reservas, hospedes, governanca) | Sim | Sim | Sim |
| Financial Basic (COA, AP/AR, caixa) | Sim | Sim | Sim |
| Guest Booking Portal (GBP) | Sim | Sim | Sim |
| Opero Payment (Stripe Connect) | Sim | Sim | Sim |
| OCP (comunicacao) | Sim | Sim | Sim |
| Estoque e POS | — | Sim | Sim |
| Gestao de Fornecedores | — | Sim | Sim |
| API Read-Only | — | Sim | Sim |
| API Read-Write | — | — | Sim |
| Financial Overview Service (FOS) | — | — | Sim |
| SLA Enterprise | — | — | Sim |
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 | FOS: R$ 199/mes |
| METERED | Cobrado por uso (por requisicao, por GB, etc.) | API Read-Write: R$ 0,01/req |
| TIERED | Faixas de preco por volume | Notificacoes OCP: ate 1000 gratis, depois R$ 0,05/msg |
Visualizar Entitlements Ativos
Para ver quais features estao ativas no seu tenant:
- Acesse Configuracoes > Entitlements
- A tela mostra:
- Funcionalidades ativas (com a fonte: plano, loja ou concessao)
- Data de ativacao de cada feature
- Uso acumulado do periodo (para features metered)
- Opcao de cancelamento (para add-ons da loja)
Comprar Add-ons
Para ativar uma feature que nao esta no seu plano:
- Acesse a Loja Opero no menu lateral
- Navegue pelo catalogo de funcionalidades
- Clique em “Contratar” na feature desejada
- Confirme — o valor sera adicionado a sua proxima fatura
- A feature e ativada imediatamente
Para cancelar um add-on:
- Acesse Configuracoes > Entitlements
- Localize o add-on ativo
- Clique em “Cancelar”
- A feature sera desativada e removida da proxima fatura
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 /superuser/tenants/:id/entitlements | Ver features ativas de um tenant |
| Conceder feature | POST /superuser/tenants/:id/entitlements | Ativar feature com motivo |
| Revogar feature | DELETE /superuser/tenants/:id/entitlements/:key | Desativar feature com motivo |
Concessoes N1 sao registradas com motivo (reason) e ficam visiveis na trilha de auditoria.
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 esta no plano Starter (sem POS), um usuario com papel Admin nao consegue acessar InventoryItem nem InventoryConsumption, pois a feature pos esta desabilitada.
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? Sim. A mudanca de plano atualiza as features padrao do tenant. Add-ons comprados separadamente nao sao afetados pela mudanca de plano.