> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loja.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Equipe e permissões

> Convide colaboradores para sua loja e controle o que cada um pode acessar.

<Info>
  Gerenciar equipe é um recurso disponível nos planos **Pro** e **Premium**.
</Info>

Em **Loja → Configurações → Equipe** você convida outras pessoas para ajudar a administrar sua loja, sem precisar compartilhar sua própria conta.

## Convidando um colaborador

Em **Loja → Configurações → Equipe → Convidar**, informe o e-mail da pessoa e escolha o papel dela na loja: `admin`, `manager` ou `collaborator`.

O convite é enviado por e-mail e expira automaticamente após 7 dias se não for aceito. A pessoa convidada aceita o convite direto pelo link recebido.

## Papéis de plataforma vs. papéis de loja

É importante não confundir dois conceitos diferentes:

<CardGroup cols={2}>
  <Card title="Papéis de plataforma" icon="shield">
    Hierarquia usada internamente pela loja.gg: `customer` (comprador), `user` (dono de loja), `support`, `moderator` e `admin`. Um usuário pode acumular mais de um papel.
  </Card>

  <Card title="Papéis dentro de uma loja" icon="users">
    Quando você convida alguém para sua loja, o papel dele (`admin`, `manager`, `collaborator`) define o que ele pode fazer **dentro daquela loja específica**, com permissões granulares.
  </Card>
</CardGroup>

## Clientes (customers) vs. usuários (users)

A conta de **cliente/comprador** é separada da conta de **usuário/dono de loja**:

| Aspecto         | Cliente (customer)                                           | Usuário (user)                                  |
| --------------- | ------------------------------------------------------------ | ----------------------------------------------- |
| Propósito       | Comprar produtos                                             | Gerenciar loja(s)                               |
| Autenticação    | Token simples, sessão mais longa (30 dias)                   | Token com sistema de permissões                 |
| Funcionalidades | Fazer pedidos, gerenciar endereços, ver histórico de compras | Gerenciar produtos, pedidos, equipe, financeiro |

A conta de cliente é **global** — criada uma vez, pode ser reaproveitada em qualquer loja da plataforma — e pode ser vinculada a uma conta do **Discord**.

<Note>
  Quando um cliente compra em uma loja, ele passa a aparecer para o lojista na lista de clientes daquela loja (recurso disponível nos planos Pro e Premium), e o lojista pode banir um cliente específico de comprar novamente ali.
</Note>

## Verificando permissões (para times técnicos)

No painel, componentes de interface e rotas são filtrados de acordo com a permissão do usuário logado — por exemplo, um `collaborator` pode não enxergar a seção financeira da loja, enquanto um `admin` da loja vê tudo.