# Equipe e papéis

O Dashboard da Fluxis permite que Owners e Admins da organização gerenciem colaboradores — membros da equipe que podem acessar o dashboard, configurar integrações e gerenciar credenciais de API.

## Acesso ao dashboard

Gerencie sua equipe em:

**`/app/team`**

Apenas colaboradores com papéis **Owner** ou **Admin** podem acessar esta seção.

## Papéis de colaborador

| Papel | Acesso ao dashboard |
| ---- | ---------------- |
| **Owner** | Acesso total; pode alterar papéis de outros Owners |
| **Admin** | Gerenciar membros da equipe, chaves de API, contas e a maioria das configurações |
| **Operator** | Tarefas operacionais (escopo definido pelas permissões do dashboard) |
| **Guest** | Acesso limitado orientado à leitura |

Os papéis são atribuídos como um array — um colaborador pode ter vários papéis, embora atribuições típicas usem um papel principal.

## Ações de gestão de equipe

| Ação | Quem pode executar | Descrição |
| ------ | --------------- | ----------- |
| List members | Owner, Admin | Lista paginada (`page`, `page_size`) |
| Invite / create | Owner, Admin | Adicionar colaborador com nome, e-mail e papéis |
| Update profile | Owner, Admin | Alterar nome, telefone, país |
| Update roles | Owner, Admin | Alterar atribuição de papéis (`PUT /team/roles/:id`) |
| Remove member | Owner, Admin | Excluir colaborador (Owners não podem ser excluídos) |

::::warning
**Owners não podem ser excluídos.** Tentativas de remover um colaborador com papel Owner são rejeitadas.
::::

::::note
Atualizações de perfil (`PUT /team/:id`) aplicam-se apenas a colaboradores que atualmente têm papéis **Admin** ou **Owner**. Operators e Guests não podem ser atualizados por este endpoint.
::::

## Criar um membro da equipe

Informe:

| Campo | Obrigatório | Descrição |
| ----- | -------- | ----------- |
| `first_name` | Sim | Nome |
| `last_name` | Sim | Sobrenome |
| `email` | Sim | E-mail de login (deve ser único) |
| `roles` | Sim | Array de strings de papel (`owner`, `admin`, `operator`, `guest`) |
| `phone` | Não | Telefone de contato |
| `country` | Não | Código do país |

Novos colaboradores recebem credenciais pelo fluxo de onboarding do dashboard (definir senha no primeiro login).

## Hierarquia de papéis

```mermaid
flowchart TD
    O[Owner] --> A[Admin]
    A --> Op[Operator]
    Op --> G[Guest]
```

- **Owner** — maior privilégio; não pode ser excluído via API de equipe
- **Admin** — gestão do dia a dia, incluindo chaves de API em `/app/api-keys`
- **Operator / Guest** — escopo reduzido para necessidades operacionais específicas

::::note
Nomes de papel do dashboard (`owner`, `admin`, …) são distintos dos **papéis de credencial de API** (`read`, `write`) nas chaves de API. O papel do dashboard controla acesso à UI; papéis da chave controlam permissões da REST API.
::::

## Gestão de chaves de API por papel

| Papel no dashboard | Acesso a `/app/api-keys` |
| -------------- | ---------------------- |
| Owner | CRUD completo |
| Admin | CRUD completo |
| Operator | Sem acesso |
| Guest | Sem acesso |

Criar chaves de API exige verificação 2FA — consulte [Autenticação de dois fatores](/pt/docs/developers/two-factor-auth).

## Boas práticas

1. **Minimize Owners** — mantenha poucos Owners; use Admin para a maior parte da equipe
2. **Use acesso adequado ao papel** — Operators e Guests não devem gerenciar credenciais
3. **Remova membros que saíram com rapidez** — exclua colaboradores quando deixarem a organização
4. **Separe chaves de API por serviço** — crie chaves distintas por integração em vez de compartilhar uma chave entre equipes

## Escopo organização vs conta

Colaboradores pertencem a uma **organização**. Chaves de API em nível de organização podem acessar todas as contas dessa organização (sujeito aos papéis de API). Recursos específicos de conta (webhooks, endereços de liquidação por conta) são gerenciados no contexto da conta no dashboard.

## Documentação relacionada

- [Credenciais de API](/pt/docs/developers/api-credentials) — chaves REST API (apenas Owner/Admin)
- [Autenticação de dois fatores](/pt/docs/developers/two-factor-auth) — obrigatória para ações sensíveis
- [Cadastro](/pt/docs/merchant-integration/sign-up) — como as organizações são provisionadas