Papeis e Permissoes
O Opero utiliza um sistema de controle de acesso baseado em CASL (Code Access Security Layer), que combina papeis (roles), escopos e feature gates para determinar exatamente o que cada usuario pode ver e fazer no sistema.
Como Funciona
Cada usuario possui:
- Um ou mais papeis (roles) — definem quais acoes e entidades estao disponiveis
- Um escopo — restringe o acesso a um subconjunto de dados (tenant, property, owner, unit)
- Feature gates — limitam o acesso com base nos add-ons ativos (entitlements)
A combinacao desses tres elementos determina as permissoes efetivas do usuario.
Papeis Disponiveis
Papeis de Tenant (Organizacao)
| Papel | Codigo | Descricao |
|---|---|---|
| Administrador | admin / tenant_admin | Acesso total ao tenant. Gerencia usuarios, configuracoes, todos os modulos. |
| Financeiro | financial / area_admin_finance | Acesso completo ao modulo financeiro. Leitura de reservas para contexto. |
| Operacional | operational / area_admin_operations | Acesso completo ao PMS (reservas, hospedes, governanca) e estoque. |
| PDV (POS) | area_admin_pos | Estoque e caixa. Para equipes de bar/restaurante. |
| Fornecedores | area_admin_suppliers | Contas a pagar e gestao de fornecedores. |
| Admin Geral | general_admin | PMS + Financeiro completos, mas sem acesso a configuracoes de tenant. |
Pela interface e possivel atribuir Administrador, Financeiro e Operacional. Os demais papeis desta tabela so podem ser atribuidos pela API.
Papeis de Plataforma (Equipe Opero)
| Papel | Codigo | Descricao |
|---|---|---|
| Superuser N1 | n1 | Acesso total cross-tenant. Gerencia plataforma, entitlements, tenants. |
| Superuser N2 | n2 | Somente leitura em tenants que aprovaram acesso de suporte. |
Acoes
Cada papel define quais acoes o usuario pode realizar sobre cada entidade:
| Acao | Descricao |
|---|---|
manage | Acesso total (criar, ler, editar, excluir) |
create | Criar novos registros |
read | Visualizar registros |
update | Editar registros existentes |
delete | Excluir registros |
financial_override | Sobrescrever valores financeiros (acao especial, restrita) |
Entidades (Subjects)
O sistema controla acesso a mais de 30 entidades, organizadas por area:
PMS
| Entidade | Descricao |
|---|---|
| Owner | Proprietarios |
| MasterProperty | Propriedades master (consolidacao) |
| Property | Propriedades operacionais |
| Unit | Unidades (quartos, camas) |
| Guest | Hospedes |
| Reservation | Reservas |
| ReservationService | Servicos adicionais da reserva |
Financeiro
| Entidade | Descricao |
|---|---|
| ChartOfAccounts | Plano de contas |
| CostCenter | Centros de custo |
| AccrualEntry | Lancamentos contabeis |
| CashAccount | Contas de caixa |
| BankAccount | Contas bancarias |
| BankStatement | Extratos bancarios |
| CashMovement | Movimentacoes de caixa |
| Supplier | Fornecedores |
| AccountsPayable | Contas a pagar |
| PayableInstallment | Parcelas de pagamento |
| PayablePayment | Pagamentos realizados |
| Customer | Clientes (contas a receber) |
| AccountsReceivable | Contas a receber |
| ReceivableReceipt | Recebimentos |
| RevenueType | Tipos de receita |
| ExpenseType | Tipos de despesa |
| FixedAsset | Ativos imobilizados |
| IntangibleAsset | Ativos intangiveis |
| FinancialReport | Relatorios financeiros |
| Document | Documentos fiscais |
Estoque
| Entidade | Descricao |
|---|---|
| InventoryItem | Itens de estoque |
| InventoryMovement | Movimentacoes de estoque |
| InventoryRecipe | Receitas (fichas tecnicas) |
| InventoryConsumption | Consumo de estoque |
Governanca
| Entidade | Descricao |
|---|---|
| Tenant | Configuracoes do tenant |
| User | Usuarios do sistema |
Matriz de Permissoes por Papel
| Recurso | Admin | Financeiro | Operacional | POS | Fornecedores | Geral |
|---|---|---|---|---|---|---|
| Propriedades / Unidades | Total | — | Total | — | — | Total |
| Reservas / Hospedes | Total | Leitura | Total | — | — | Total |
| Plano de Contas | Total | Total | — | — | — | Total |
| Contas a Pagar | Total | Total | — | — | Total | Total |
| Contas a Receber | Total | Total | — | — | — | Total |
| Caixa / Banco | Total | Total | — | Total | — | Total |
| Estoque | Total | Total | Total | Total | — | Total |
| Relatorios Financeiros | Total | Total | — | — | — | Total |
| Usuarios | Total | — | — | — | — | — |
| Configuracoes Tenant | Total | — | — | — | — | — |
| Auditoria | Total | — | — | — | — | Leitura |
Feature Gates (Plano)
Alem dos papeis, o acesso e filtrado pelos add-ons contratados na Loja Opero. Todos os planos incluem PMS Core e Financial Basic; os modulos abaixo exigem o add-on correspondente:
| Modulo | Add-on necessario |
|---|---|
| Ativo Imobilizado | financial.fixed_assets |
| Ativos Intangiveis | financial.intangible_assets |
| Emprestimos | financial.loans |
| Estoque | financial.inventory |
| Orcamento | financial.budget |
| Ocorrencias, Servicos e Produtos | operations.services |
| Documentos fiscais (NFS-e) | fiscal.nfse_br |
Se o tenant nao contratou o add-on, o modulo e bloqueado mesmo para usuarios com papel Admin.
Funcionalidades adicionais podem ser habilitadas via Entitlements e Loja Opero.
Escopos
Escopos restringem quais dados o usuario ve dentro das permissoes do seu papel:
| Escopo | Significado | Exemplo |
|---|---|---|
tenant | Todo o tenant (padrao) | Gerente geral |
owner | Apenas propriedades de um dono | Socio com propriedades especificas |
property | Apenas uma propriedade | Recepcionista de uma unidade |
unit | Apenas unidades especificas | Governanta de andar |
Como Atribuir Papeis
- Acesse Configuracoes > Usuarios
- Localize o usuario ou clique em “Adicionar Usuario” para criar um novo
- Em “Alterar Papel”, escolha o role adequado
- Para restringir o escopo (opcional), acesse Configuracoes > Controle de Acesso e use “Escopos” na linha do usuario
A mudanca e imediata — na proxima acao do usuario, as novas permissoes ja se aplicam.
Boas Praticas
- Principio do menor privilegio — Atribua apenas o acesso necessario para a funcao
- Use escopos em redes — Restrinja por propriedade para equipes locais
- Revise periodicamente — Colaboradores mudam de funcao; atualize os papeis
- Nunca compartilhe credenciais — Cada pessoa deve ter seu proprio login
- Consulte a auditoria — Verifique acoes sensiveis em Trilha de Auditoria