Workspaces e membros

Uma conta por pessoa

Cada pessoa tem uma conta com um @handle público, escolhido no cadastro. O handle identifica, encontra e convida uma pessoa; ele nunca serve para entrar.
A pessoa pode ter vários e-mails verificados e entrar com qualquer um. O e-mail de login traz um código de 8 dígitos e um link mágico de uso único.
Pessoas e organizações dividem o mesmo espaço de handles. Um handle trocado fica reservado ao dono anterior por 30 dias, e palavras como all, owners e admins não podem ser usadas.

Workspaces

Um workspace agrupa serviços, tokens, regras, hooks, histórico e membros.

Toda pessoa tem um workspace pessoal com o mesmo handle.
Uma organização é um workspace com nome e handle próprios. Quem cria vira owner.
Uma pessoa pode participar de vários workspaces e alternar entre eles no app.

Papel	Pode
`owner`	Tudo, inclusive membros, convites e o handle do workspace.
`admin`	Gerenciar serviços, tokens, regras, hooks, webhooks e convites.
`member`	Receber notificações, responder decisões e ler o workspace.
`guest`	Acesso limitado, para pessoas de fora da organização.

Cada vínculo guarda qual dos e-mails da pessoa representa aquela organização. É esse e-mail que os membros veem, que a auditoria registra e que os serviços podem usar no to.

Convites

Convide por e-mail ou @handle, com um papel (admin, member ou guest). O convite vale 7 dias e pode ser reenviado ou cancelado.
Ao aceitar, a pessoa escolhe qual dos seus e-mails a representa na organização.
Ninguém é notificado sem consentimento: o to só resolve quem aceitou. Remover um membro corta o acesso na hora.

Privacidade de convites

Como num app de mensagens com @usuário e PIN, cada pessoa escolhe quem pode convidá-la pelo @handle em Conta → Privacidade:

Política	Efeito
`anyone`	Qualquer organização pode convidar o handle.
`pin`	A organização precisa digitar o PIN da pessoa (de 4 a 8 dígitos). PIN errado: o convite é recusado; 5 tentativas erradas por hora são bloqueadas.
`nobody`	Convites pelo handle são recusados.

Convite para um dos e-mails da pessoa sempre vale (quem tem o e-mail já tem contato), exceto de organização bloqueada.
A pessoa pode bloquear uma organização: os convites pendentes dela são recusados e os próximos ficam ocultos, sem avisar a organização. Organização bloqueada e a política nobody devolvem o mesmo erro, então o bloqueio nunca é revelado.

Serviços e tokens

Um serviço é um sistema que conversa com o notific.me (Dokploy, um CRM, um agente de IA). Cada serviço tem um slug (o source dos seus eventos) e um ou mais tokens (nm_svc_…), mostrados uma vez só, com escopos:

Escopo	Libera
`events:write`	Enviar eventos e cards vivos, postar em hooks.
`asks:write`	Criar grupos de perguntas (`POST /v0/asks`).
`asks:read`	Ler e esperar respostas (`GET /v0/asks/{id}`).

Outros escopos (workspace:read, rules:write, tokens:write e mais) deixam um token administrar o workspace, que é como agentes de IA o gerenciam via MCP. Veja Agentes de IA e MCP. Desativar um serviço bloqueia todos os tokens dele na hora; revogar um token bloqueia só aquele.