Cadastrar Usuário

O cadastro de usuários permite adicionar novos usuários ao sistema com diferentes tipos e permissões.

Acesso

Rota: /users/register

Arquivo: pages/users/register.vue

Para acessar:

1. Navegue até a lista de usuários
2. Clique no botão "Adicionar" no cabeçalho

Permissões Necessárias

Apenas usuários com permissão USER_MANAGEMENT_BASIC podem cadastrar usuários:

• administrador
• rad admin
• rad fisico
• rad laudos

Formulário de Cadastro

O formulário é dividido em seções:

1. Informações Básicas

Nome Completo

• Campo: Texto
• Obrigatório: Sim
• Descrição: Nome completo do usuário

CPF

• Campo: Texto
• Obrigatório: Não
• Descrição: CPF do usuário (formato: 000.000.000-00)

Telefone

• Campo: Texto
• Obrigatório: Não
• Descrição: Número de telefone para contato

Email

• Campo: Email
• Obrigatório: Sim
• Descrição: Email do usuário (será usado para login)
• Validação: Deve ser um email válido e único no sistema

Senha

• Campo: Senha
• Obrigatório: Sim
• Descrição: Senha para acesso ao sistema
• Gerador: Botão disponível para gerar senha aleatória

Confirmar Senha

• Campo: Senha
• Obrigatório: Sim
• Descrição: Confirmação da senha (deve ser igual à senha)

2. Tipo de Usuário

Tipo

• Campo: Dropdown
• Obrigatório: Sim
• Descrição: Tipo de usuário que define as permissões
• Opções disponíveis:
  • administrador (apenas se você for administrador)
  • rad admin (apenas se você for administrador)
  • rad fisico (apenas se você for administrador)
  • rad laudos (apenas se você for administrador)
  • cliente
  • cliente MN

Nota: Usuários não-administradores só podem criar usuários do tipo "cliente" ou "cliente MN".

3. Certificados CNEN

Licença AN (Autorização Nuclear)

• Número: Texto no formato AA-0000
• Validade: Data
• Arquivo: Upload de PDF (opcional)

Licença FM (Física Médica)

• Número: Texto no formato AA-0000
• Validade: Data
• Arquivo: Upload de PDF (opcional)

4. Acesso a Instalações (para clientes)

Se o tipo de usuário for "cliente" ou "cliente MN":

• Selecione as instalações às quais o usuário terá acesso
• Busque instalações por nome
• Selecione múltiplas instalações se necessário

Validações

O sistema valida:

• Nome completo obrigatório
• Email válido e único
• Senha obrigatória e confirmação igual à senha
• Tipo de usuário selecionado
• Formato de CPF (se preenchido)
• Formato de números de licença CNEN (AA-0000)

Processo de Cadastro

1. Preencha as informações básicas
2. Selecione o tipo de usuário
3. Adicione certificados CNEN se necessário
4. Para clientes, selecione as instalações de acesso
5. Clique em "Cadastrar" ou "Salvar"
6. O sistema valida os dados
7. Se válido, o usuário é criado e uma mensagem de sucesso é exibida
8. Se houver erro, mensagens de erro são exibidas

Gerador de Senha

O formulário possui um botão para gerar senha aleatória:

• Clique no botão ao lado do campo de senha
• Uma senha aleatória é gerada
• A senha é preenchida automaticamente nos campos de senha e confirmação

Email de Boas-Vindas

Após o cadastro, você pode optar por enviar um email de boas-vindas ao novo usuário com:

• Credenciais de acesso
• Instruções de primeiro acesso
• Link para recuperação de senha

Endpoint da API

Método: POST

URL: /register/

Body:

{
  "name": "Nome Completo",
  "email": "usuario@exemplo.com",
  "password": "senha123",
  "cpf": "000.000.000-00",
  "telephone": "11999999999",
  "type": "cliente",
  "ANLicense": "base64pdf",
  "ANLicenseNumber": "AA-0000",
  "ANLicenseValidity": "2025-12-31",
  "FMLicense": "base64pdf",
  "FMLicenseNumber": "AA-0000",
  "FMLicenseValidity": "2025-12-31",
  "facilities": ["facilityId1", "facilityId2"]
}

Após o Cadastro

Após cadastrar um usuário:

• Ele recebe um email de boas-vindas (se configurado)
• Pode fazer login com o email e senha fornecidos
• Deve aceitar os termos de uso no primeiro acesso
• Pode acessar as funcionalidades conforme seu tipo de usuário

Erros Comuns

"Email já cadastrado"

• O email fornecido já está em uso
• Use outro email ou recupere a senha do usuário existente

"Senhas não coincidem"

• Os campos de senha e confirmação devem ser iguais

"Preencha todos os campos obrigatórios"

• Verifique se todos os campos marcados com * estão preenchidos

Próximos Passos

• Listar Usuários - Voltar para a lista
• Editar Usuário - Atualizar informações
• Tipos de Usuário - Entender os tipos de usuário