Visão Geral
Gerenciamento dos usuários (operadores) de uma conta: criação, listagem, edição, status, assinatura digital e vínculo de roles no Auth0.
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).
Buscar Usuário por ID
Retorna os dados de um usuário específico da conta.
Buscar Roles do Usuário
Retorna os IDs das roles atribuídas ao usuário no Auth0, dentro da organização do token.
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
Cria um novo usuário na conta. A senha é armazenada com hash; opcionalmente já vincula roles do Auth0 e dados de conselho profissional.
Atualizar Usuário
Atualiza os dados de um usuário existente. Todos os campos são opcionais, exceto o id. Se password for enviado, é re-hasheado.
Atualizar Status do Usuário
Alterna o status do usuário 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 no Auth0. É uma substituição total: as roles atuais são removidas e as enviadas em rolesIds 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
Deleta um usuário da conta. É um soft delete (preenche deletedAt, não remove fisicamente).