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

# Usuários, clientes e organizações

> Quem usa a plataforma, quem conversa pelo WhatsApp e como contas e tenants são separados.

# Usuários, clientes e organizações

A plataforma diferencia quem opera o produto, quem contrata e administra tenants, quem trabalha em uma loja e quem apenas conversa com essa loja pelo WhatsApp.

## Classes de ator

### Operador da plataforma

Administra suporte, cobrança, segurança e operação técnica. Esse acesso não transforma o operador em membro dos tenants dos clientes.

### Membro da conta comercial

Possui login e administra assinatura, billing e limite de organizações.

Os papéis iniciais são:

* `ACCOUNT_OWNER`
* `ACCOUNT_BILLING_ADMIN`

Ser dono da conta não libera automaticamente contatos, conversas ou agenda de todos os tenants.

### Membro da organização

Possui login e atua dentro de uma loja tenant.

Exemplos:

* Proprietário da loja.
* Administrador.
* Gerente.
* Atendente.
* Profissional.
* Usuário somente leitura.

Um mesmo usuário pode participar de várias organizações, sempre com memberships e permissões independentes.

### Cliente externo

É o cliente da barbearia, salão ou prestador de serviço.

Ele continua usando o próprio WhatsApp para conversar com o número comercial da loja. Pode perguntar preços, consultar horários, agendar, reagendar, cancelar ou pedir atendimento humano.

O cliente externo:

* Não recebe login.
* Não possui conta no painel.
* Não acessa a plataforma diretamente.
* É representado internamente como um `Contact` pertencente ao tenant.

## Conta, grupo e tenant

```text theme={null}
CustomerAccount: Negócios Gabriel
├── OrganizationGroup: Barbearias Gabriel
│   ├── Organization: Centro
│   ├── Organization: Shopping
│   └── Organization: Zona Sul
└── OrganizationGroup: Manicure Gabriel
    └── Organization: Loja principal
```

### `CustomerAccount`

Agrupa assinatura, cobrança e entitlement para criar organizações.

### `OrganizationGroup`

Serve para organizar e filtrar tenants de uma mesma marca ou categoria. Não compartilha dados e não concede acesso.

### `Organization`

É o tenant, a loja e a unidade comercial futura de cobrança.

Cada organização possui seus próprios:

* WhatsApp Business.
* Contatos.
* Inbox e conversas.
* Serviços e preços.
* Profissionais e escalas.
* Agenda.
* Agente de IA.
* Plugins e credenciais.

Uma rede com três lojas utiliza três organizações, mesmo que todas pertençam à mesma conta e marca.

## Profissional não é necessariamente usuário

Um profissional pode existir no calendário sem possuir login.

O proprietário consegue cadastrar funcionários, serviços, horários de trabalho, intervalos e folgas mesmo quando esses profissionais nunca acessam o painel.

Quando um profissional precisar acessar o sistema, seu registro poderá ser vinculado a um `User`.

## Papéis da organização

* `OWNER`
* `ADMIN`
* `MANAGER`
* `ATTENDANT`
* `PROFESSIONAL`
* `VIEWER`

Os papéis são conjuntos de permissões. O backend valida membership, permissão, escopo e ownership em todas as operações protegidas.

## Isolamento

A organização selecionada no navegador serve apenas para navegação.

Cada requisição, evento, webhook e job valida novamente o tenant. Uma organização não acessa contatos ou agendas de outra organização, mesmo quando ambas pertencem à mesma conta ou grupo.