Pular para o conteúdo principal

Permissões

A maioria das permissões usa trios entity:action:scope. As ações incluem list, read, edit e delete. Os escopos normalmente diferenciam o acesso all do acesso assigned para entidades grandes, como clientes ou tours.

Em organizações modulares, os módulos de subscrição necessários são verificados além dessas permissões de função. Uma função pode permitir uma ação enquanto o módulo não está disponível, e um módulo ativo não concede uma capacidade de função ausente. Consulte Subscrição.

A administração da organização também é expressa com a entidade admin: as funções que podem gerir organizações filhas, funções e ferramentas semelhantes de hierarquia incluem permissões admin, como admin:list:all, admin:read:all e combinações relacionadas de admin:*. As verificações no servidor para “administrador da organização” podem considerar qualquer cadeia de permissão que comece com admin: como suficiente para determinadas rotas — use sempre o editor de funções do painel como fonte de verdade para um espaço de trabalho.

As principais entidades com suporte a list incluem customer, tour, landing-page, event, experience, newsletter, project, document, contactform, siteplan, place e admin. As subentidades, como protocol, email e task, omitem intencionalmente list, pois a visibilidade é inferida por meio de relações.

Casos específicos — como atribuições mistas ou atalhos para operadores da plataforma — são resolvidos dentro do produto; use o editor de funções do painel como fonte de verdade para um determinado espaço de trabalho.

Formato das permissões​

entity:action:scope
ParteSignificadoExemplo
entityTipo de recurso controlado.customer, tour, event, admin
actionOperação que a função pode realizar.list, read, edit, delete
scopeAmplitude do acesso.assigned, all, off

Ações​

AçãoSignificado
listVer registros em visualizações de lista para entidades que oferecem listagem.
readAbrir ou consultar detalhes de registros.
editCriar ou atualizar registros.
deleteExcluir registros quando permitido.

edit inclui direitos de criação no modelo de permissões; por isso, os botões de criação geralmente dependem da permissão de edição, e não de uma permissão de criação separada.

Escopos​

EscopoSignificado
assignedAcessar registros vinculados à pessoa usuária por regras de atribuição ou relacionamento.
allAcessar todos os registros dessa entidade dentro da organização.
offNenhum acesso explícito, exceto pelas regras especiais de acesso próprio ou de relacionamento aplicadas pelo produto.

O comportamento de acesso apenas a itens atribuídos pode variar conforme a entidade. Por exemplo, clientes podem ter pessoas usuárias responsáveis, enquanto tarefas, e-mails e protocolos podem ficar visíveis por meio da atribuição ao cliente ou de atribuições diretas.

Grupos de entidades​

As entidades principais oferecem acesso no formato de lista:

  • customer
  • tour
  • landing-page
  • event
  • experience
  • newsletter
  • project
  • document
  • contactform
  • siteplan
  • place
  • admin

As subentidades não usam intencionalmente list:

  • protocol
  • email
  • task

Essas subentidades geralmente são acessadas por meio de relacionamentos com clientes, projetos ou atribuições diretas.

Visibilidade do painel​

A barra lateral usa permissões para decidir quais grupos e rotas aparecem. Se uma pessoa usuária não consegue ver uma página, verifique primeiro a permissão da entidade:

  • Gestão de clientes: customer, protocol, task, project, document, newsletter, email, event.
  • Aplicativos web e tours: landing-page, tour, experience, contactform, siteplan (os planos do site e as perguntas são controlados pela visibilidade da página de destino nas configurações típicas).
  • Hierarquia de configurações: permissões de entidade admin (organizações filhas e funções).
  • Configurações de eventos: event.

A Galeria em Aplicativos web e tours é exibida de forma mais ampla do que alguns itens próximos; as regras exatas podem variar conforme a implantação. Se um link não aparecer, confirme o contexto da página de destino, do tour e da organização em vez de presumir que a compilação está com defeito.

As pessoas responsáveis pela operação da plataforma podem ver rotas adicionais que pessoas usuárias dos tenants nunca acessam.

Experiências e comércio de guias​

O catálogo unificado utiliza as permissões experience:*. As permissões históricas exclusivas para ofertas não concedem acesso às experiências. Verifique as capacidades da experiência da função ativa quando um produto migrado ou a respetiva página de reserva estiver em falta.

A criação de um produto de guia associado também requer acesso ao passeio ou plano diário e a respetiva capacidade de edição. O comércio de guias deve ser ativado para a organização pela administração da plataforma. A gestão de anfitriões e os reembolsos diretos integrais requerem administração da organização; a ligação central ao Bókun e os mapeamentos de fornecedores requerem administração da plataforma. Os anfitriões associados podem aceder aos seus próprios manifestos de partidas sem receber acesso às reservas ou aos dados financeiros de toda a organização.

Conceitos relacionados: Permissões e organizações, Organizações filhas e funções.