Pular para o conteúdo principal

Usuários e permissões

🛂 Permissões: user.view, user.create, user.edit, user.delete, user.manage_permissions 🔒 Plano: número de usuários limitado por max_users. 📍 Caminho: Configurações → Usuários

Usuários são operadores do painel (admin, vendedores, motoristas) — não confundir com Clientes.

Roles​

RoleIndicação
ADMINAcesso total ao tenant.
SELLERVendedor — cria pedidos, gerencia clientes, recebe comissões.
DRIVERMotorista — vê e finaliza entregas.

A role é informativa. O acesso real é controlado por permissões granulares.

Permissões disponíveis​

A plataforma tem permissões finas por funcionalidade. Resumo dos códigos:

Clientes​

  • customer.create customer.view customer.edit customer.delete

Produtos​

  • product.create product.view product.edit product.delete

Tabelas de preço​

  • price_table.create price_table.view price_table.edit price_table.delete

Pedidos​

  • order.create order.view order.edit order.delete
  • order.assign_driver order.start_delivery order.complete_delivery
  • order.confirm_payment order.cancel

Usuários​

  • user.create user.view user.edit user.delete user.manage_permissions

Financeiro​

  • financial.view financial.reports

Dashboard​

  • dashboard.view

Cupons​

  • coupon.create coupon.view coupon.edit coupon.delete

Frete​

  • shipping.create shipping.view shipping.edit shipping.delete

Comissões​

  • commission.view commission.manage commission.approve commission.pay commission.reports

Promoções​

  • promotion.create promotion.view promotion.edit promotion.delete

API & Webhooks​

  • api_key.manage webhook.manage

Inteligência comercial​

  • intelligence.view intelligence.manage intelligence.whatsapp

Como criar um usuário​

  1. Em Configurações → Usuários, clique em Novo Usuário.
  2. Preencha:
    • Nome completo
    • E-mail (será o login; precisa ser único globalmente)
    • Senha (mínimo 8 caracteres) — orientar o usuário a trocar no primeiro login.
    • Role (ADMIN / SELLER / DRIVER)
    • Ativo — se desligado, o usuário não consegue logar.
  3. Salve.
  4. Após criar, abra Editar e configure as Permissões (checkbox por código).

Permissões padrão por role​

A plataforma sugere um conjunto inicial de permissões ao criar um usuário com determinada role:

  • ADMIN — todas as permissões.
  • SELLER — customer.*, order.create/view/edit, product.view, dashboard.view, commission.view.
  • DRIVER — order.view, order.start_delivery, order.complete_delivery.

Você pode customizar livremente após o cadastro.

Senha esquecida​

Tenants e usuários podem usar a tela Esqueci minha senha (link na tela de login). O fluxo envia um link com token de uso único para o e-mail cadastrado.

Para forçar reset, o admin pode redefinir a senha pelo formulário de edição do usuário.

Limite do plano​

A criação é bloqueada ao atingir max_users no plano. Para aumentar, faça upgrade.

Boas práticas​

  • Role ≠ permissão. Sempre revise as permissões após criar — role é apenas o ponto de partida.
  • Crie um admin reserva — não dependa de uma única conta de admin.
  • Para vendedores, negue customer.delete e order.delete por padrão (apenas admins).
  • Para motoristas, conceda apenas order.view, order.start_delivery e order.complete_delivery.
  • Periodicamente, desative usuários que saíram da equipe — não exclua para preservar histórico.
  • Use senhas fortes e oriente troca trimestral.