Visão Geral
Gerenciamento dos usuários (operadores) de uma conta: criação, listagem, edição, status, assinatura digital e vínculo de roles da clínica no provedor de identidade.
Listar Usuários
Lista os usuários ativos da conta, ordenados do mais recente para o mais antigo. Suporta paginação e busca por nome.
Usuário Logado
Retorna os dados do usuário dono do token usado na requisição (a partir do userId da claim do JWT).
Minhas Permissões
Lista as permissões do usuário logado na clínica do token — as mesmas que o backend usa para autorizar as rotas. O front usa a lista para mostrar ou esconder telas.
Buscar Usuário por ID
Retorna os dados de um usuário específico da conta.
Buscar Roles do Usuário
Retorna os slugs das roles atribuídas ao usuário nesta clínica.
Usuários com Permissão de Consulta
Lista usuários da conta com a disponibilidade para atender consultas, contando quantas consultas abertas cada um tem. Ordenado por nome.
Criar Usuário
Adiciona uma pessoa à clínica. A pessoa é criada no provedor de identidade (onde acontece o login) e no banco local, recebe o vínculo com a clínica e, opcionalmente, roles e dados de conselho profissional.
Atualizar Usuário
Atualiza os dados de um usuário da clínica. Todos os campos são opcionais, exceto o id. Nome e senha são aplicados também no provedor de identidade (a senha de login muda de fato). Roles não são alteradas aqui — use Atualizar Roles do Usuário.
Reenviar Link de Senha
Envia de novo à pessoa o e-mail para definir a senha (primeiro acesso ou senha esquecida). Para um usuário com convite pendente, reenvia o convite.
Atualizar Status do Usuário
Alterna o status do usuário nesta clínica entre ativo e inativo (expirado). É um toggle: se está ativo, passa a inativo, e vice-versa.
Alternar Coletador
Alterna a flag isCollector do usuário entre true e false (toggle). Coletadores aparecem nas listas de laboratório.
Atualizar Roles do Usuário
Define as roles do usuário na clínica. É uma substituição total: as roles que não estiverem em rolesIds são removidas e as enviadas são atribuídas.
Upload de Assinatura
Envia a imagem da assinatura digital do usuário (armazenada no storage de arquivos).
Remover Assinatura
Remove a imagem de assinatura digital do usuário do storage.
Deletar Usuário
Exclui um usuário da clínica. É um soft delete (preenche deletedAt no vínculo da pessoa com a clínica; nada é removido fisicamente).