Membros & permissões

Vídeo: visão geral em 90 segundos

Em 90 segundos você entende a separação entre Usuários (quem é a pessoa) e Roles (o que ela pode), e vê o fluxo completo de criar uma role customizada, atribuir a alguém da equipe e validar o que mudou no painel.

1. Quem usa o painel: Usuários × Roles

O sistema de acesso do UlaNano é dividido em dois conceitos independentes:

• Usuário — uma pessoa real, com nome, e-mail e senha. É quem faz login.
• Role (papel) — um conjunto de permissões que define o que essa pessoa pode fazer dentro de um workspace.

A combinação usuário + role + workspace é o que controla o acesso. A mesma pessoa pode ter roles diferentes em workspaces diferentes — ser Editor num site e Administrador em outro, por exemplo.

2. Adicionar um usuário

Acesse /admin/users para ver a lista de usuários da sua organização. Apenas o Owner da conta enxerga essa página — todos os demais recebem a tela Acesso negado.

2.1 Criar pelo formulário completo

Clique em Novo usuário para ir para /admin/users/new. O formulário divide-se em três blocos:

• Dados pessoais — nome, e-mail (vira o login) e senha inicial.
• Status — usuário ativo (pode logar) ou inativo (bloqueado sem deletar).
• Workspaces & Roles — vincula esta pessoa a um ou mais workspaces, com uma role em cada.

2.2 Vincular a workspace + role

No card Workspaces & Roles, clique em Adicionar workspace para cada acesso que essa pessoa deve ter. Você escolhe o site (workspace) e a role correspondente via dois selects. O botão Lixeira remove a linha. Você pode adicionar múltiplas associações no mesmo formulário.

2.3 Criação inline (a partir da Agência)

Quando você está atribuindo um pagador no Painel Agência e o cliente ainda não existe no sistema, há um atalho + Criar novo que abre um diálogo mínimo (só nome e e-mail). O usuário é criado com role padrão e já fica selecionado no seletor de pagador — sem precisar sair daquele fluxo.

3. Editar, desativar e excluir

Na lista /admin/users, cada linha tem um menu ⋯ com três ações:

• Editar — abre /admin/users/{id} para alterar dados, status ou vínculos com workspaces.
• Desativar — bloqueia o login mantendo todo o histórico. Reativável depois.
• Excluir — remove permanentemente. Só funciona se a pessoa não tiver vínculos pendentes (assinaturas pagas em workspaces, por exemplo).

4. O que é uma role (papel)

Uma role agrupa um conjunto de permissões (entitlements) que definem o que o usuário pode acessar no painel. Cada permissão pertence a um módulo (ex.: Páginas, Produtos, SEO, Financeiro) e tem um dos três tipos:

• access — visualizar a tela (entrar no menu).
• feature — usar uma feature específica daquele módulo (ex.: exportar CSV).
• action — executar uma operação destrutiva ou crítica (ex.: deletar produto, publicar página).

O painel de roles fica em /admin/roles. Lá você vê as roles System (criadas pelo UlaNano e não removíveis, como o Owner) e as customizadas (criadas pela sua organização).

5. Criar uma role customizada

Em /admin/roles, clique em Nova role. O formulário (/admin/roles/new) divide-se em duas partes: identidade e permissões.

5.1 Nome, slug, cor e descrição

Nome aparece para os usuários (ex.: Editor de blog). Slug é gerado automaticamente a partir do nome, mas você pode editar (vira o identificador interno). Descrição é livre — útil para você lembrar do propósito. Cor é escolhida em uma paleta de 10 presets (indigo, violet, pink, rose, orange, yellow, green, teal, sky, slate); a cor aparece como bolinha ao lado do nome em todas as listas, então use cores diferentes para roles que se confundem.

5.2 Permissões por módulo

Abaixo da identidade vem o card Permissões, organizado em accordion onde cada painel é um módulo do sistema (Páginas, Produtos, Pedidos, SEO, Financeiro, etc.). O subtítulo de cada módulo mostra a contagem marcadas/total em tempo real, facilitando ver o quanto da role já foi configurado.

Marque os checkboxes correspondentes ao que essa role deve poder fazer. A combinação ideal depende do papel: um Editor de blog recebe access e feature de Páginas, mas raramente recebe action destrutivas. Um Administrador de loja recebe quase tudo de Produtos e Pedidos.

5.3 Tipos de permissão (access / feature / action)

Os três tipos têm escopos distintos:

• access — sem isso a tela inteira do módulo nem aparece no menu lateral. É o "mínimo para enxergar".
• feature — funcionalidades específicas dentro do módulo (ex.: "Exportar relatório de vendas em CSV"). Sem o access, a feature não vale.
• action — operações irreversíveis ou críticas (ex.: "Deletar produto", "Publicar página", "Cancelar pedido"). Geralmente reservadas para roles de gestão.

A regra prática: access abre a porta, feature dá ferramentas, action permite mexer no que importa.

6. Atribuir uma role a um usuário

Existem duas formas de atribuir role:

1. Na criação do usuário — no card Workspaces & Roles do form de criação você já escolhe a role. É o caminho normal.
2. Editando depois — na lista de usuários, abra Editar e altere a role num workspace existente, ou adicione uma linha nova vinculando a outro workspace.

A mudança vale imediatamente — o usuário pode precisar atualizar a página para o menu recalcular o que aparece, mas o backend já bloqueia ações que ele perdeu permissão.

7. Owner vs. roles regulares

O Owner é uma role System especial (não removível) atribuída automaticamente a quem cria a conta. Ela tem três privilégios que nenhuma role customizada pode replicar:

• Acesso ao painel /admin (Usuários, Roles, Cobrança, Agência, Comprar workspaces).
• Permissão de criar, editar e deletar outras roles.
• Permissão de promover ou desativar outros usuários.

Mesmo que você dê todas as action de todos os módulos a uma role customizada, ela ainda não acessa /admin/users nem /admin/roles. Os componentes de página fazem o gate via if (!user.isOwner) return <AccessDenied />.

8. A mesma pessoa em vários workspaces

Quando uma agência atende vários clientes, é comum o mesmo colaborador trabalhar em múltiplos sites. O sistema suporta isso nativamente: um usuário pode ter tantos vínculos quanto necessário, com role independente em cada um.

No login, o usuário vê o switcher de workspace com todos os sites que tem acesso. Ao trocar de workspace, o painel recarrega o menu lateral conforme as permissões da role daquele workspace. Não há "modo super-admin" — o contexto é sempre por site.

9. Próximos passos

Com a equipe estruturada, aprofunde nos próximos tópicos:

Problemas comuns