Workspaces e recursos
Organizações, workspaces, papéis, recursos, modos de capacidade e grupos de recursos.
Organização e workspaces
Uma organização é a conta que paga. Ela contém um ou mais workspaces. Um workspace é um negócio ou unidade com seus próprios:
- fuso horário, idioma e moeda,
- número(s) de WhatsApp,
- bot, serviços, recursos e equipe.
Uma rede de três barbearias é uma organização com três workspaces.
Papéis
| Papel | Pode |
|---|---|
owner | Tudo, em todos os workspaces da organização |
manager | Tudo dentro de um workspace |
staff | Ver e gerenciar só os próprios recursos (por exemplo, o barbeiro vê só a sua agenda) |
viewer | Somente leitura |
A equipe também pode agir pelo WhatsApp depois de vincular o número com um código de uso único. Ações de administrador pelo WhatsApp sempre pedem confirmação SIM/NÃO.
Recursos
Um recurso é qualquer coisa consumida por um agendamento.
kind | Exemplos |
|---|---|
staff | Barbeiro, médico, esteticista, instrutor |
space | Sala, consultório, cabine, salão |
equipment | Máquina de laser, cadeira, quadra |
table | Mesa de restaurante (modo mesas) |
vehicle | Van, equipe de entrega |
zone | Área de entrega por CEP |
Cada recurso tem um modo de capacidade:
exclusive— atende um agendamento por vez (um barbeiro, uma sala, uma máquina).pooled— tem capacidade em unidades (40 lugares por turno, 12 vagas numa aula, 10 entregas por janela).
Grupos de recursos
Um grupo de recursos é um conjunto intercambiável ("qualquer barbeiro", "máquinas de laser"). Serviços exigem grupos, não recursos individuais, para que o motor escolha um. A estratégia de alocação decide qual:
assignment | Comportamento |
|---|---|
customer_choice | O cliente escolhe (por exemplo "com o Juan"); se não tiver preferência, usa outra estratégia |
round_robin | Reveza entre os membros |
least_busy | Escolhe o membro com menos agendamentos no dia |
fixed | Sempre o mesmo membro (máquina única, sala única) |
{
"name": "Barbeiros",
"assignment": "customer_choice",
"member_ids": ["res_juan", "res_pedro", "res_leo"]
}