Usuários — Cadastro e Identificadores de Acesso

Gerenciar contas de acesso não deveria exigir ticket nem linha de comando. Na tela Sistema›Usuários (?view=usuarios no shell) você cadastra, pesquisa e ajusta o perfil e as permissões de cada pessoa da equipe em segundos, com validação antes do envio e mensagens claras quando algo não confere. Esta página explica os três identificadores de uma conta, como a pessoa entra na plataforma e o que acontece com as contas criadas antes de o login existir.

Identificadores: nome, e-mail e login

Cada usuário tem até três identificadores, com papéis distintos:

Regras do login

• 3 a 64 caracteres: letras, números, ponto, hífen ou underscore, começando por letra ou número (padrão ^[a-z0-9][a-z0-9._-]{2,63}$).
• Normalizado para minúsculas; a unicidade não diferencia maiúsculas de minúsculas e é verificada no próprio cadastro.
• Nunca contém @ — é assim que a plataforma distingue e-mail de login no mesmo campo Usuário do dialog "Entrar no DATTA".
• Obrigatório no cadastro local: sem ele, o cadastro é recusado com a mensagem "Login é obrigatório". Usuários criados por provedor externo (Microsoft/Google) recebem login pelo preenchimento automático descrito abaixo, mas continuam autenticando pelo provedor.

Contas antigas ganham login automaticamente

Contas criadas antes de o campo existir recebem um login gerado pela plataforma, sem nenhuma ação sua, na primeira inicialização depois da atualização: um apelido derivado do nome de exibição — minúsculas, sem acentos, separadores viram ponto ("José Rodrigo" → jose.rodrigo) — com recurso ao prefixo do e-mail e sufixo numérico em caso de colisão (jose.rodrigo2).

A rotina é idempotente: só preenche quem está sem login, e quem já tem não é alterado. Ela também garante, de uma vez, a restrição de unicidade do login. O login atribuído aparece na listagem de usuários e no registro de operação da plataforma, na forma Backfill de login: <email> → <login>.

Entrar com e-mail ou login

No dialog "Entrar no DATTA", o campo Usuário aceita e-mail ou login — a pessoa usa o que preferir. A plataforma resolve o login até a conta por um cache em duas camadas (memória do processo e cache distribuído, com índices dedicados por e-mail e por login — datta:auth:email:{email} e datta:auth:login:{login} — e validade de 15 minutos), com consulta ao banco de sistema datta (nó :Usuario, propriedade login) quando o cache não tem a conta.

Em credencial incorreta, a mensagem é sempre a mesma ("Credenciais inválidas"), tenha o erro sido no identificador ou na senha — proteção deliberada contra enumeração de contas.

Exemplo prático — cadastrar um novo analista

1. Em Sistema›Usuários, abra o dialog Novo Usuário.
2. Preencha o nome completo (ex.: "Juliana Silva"), o login (ex.: jsilva), o e-mail (ex.: juliana.silva@empresa.com) e a senha inicial, de no mínimo 8 caracteres, e escolha o perfil base (role) — a conta já nasce com ele.
3. Confirme o cadastro. A própria tela valida antes de enviar: campo em branco, e-mail malformado, senha fora do tamanho aceito ou login fora do padrão são apontados na hora, sem ida ao servidor. O servidor repete todas as validações — formato e unicidade — e, se algo não passar, devolve o erro campo a campo, exibido no aviso da tela. E-mail ou login que já pertencem a outra conta são recusados com "Já existe um usuário com este e-mail ou login".
4. Se você marcou permissões além das do perfil, elas são gravadas em seguida como permissões diretas da conta. O detalhe de cada perfil está em roles e permissões.

Quem pode cadastrar. Criar usuário exige a permissão USERS_MANAGE_ROLES (o perfil ADMIN já a tem): a conta nasce com uma role, e quem só edita dados cadastrais (USERS_EDIT) não pode conceder perfil. Sem a permissão, a tela avisa e nada é criado. Cada cadastro gera o evento de auditoria AUTHZ.USER_CREATED, com quem cadastrou, o e-mail e a role inicial — nunca a senha. O cadastro pela tela não depende do auto-cadastro anônimo da tela de login, que fica desligado por padrão na instalação local.

1. Opcionalmente, preencha o Prompt padrão do usuário: instruções que a IA segue em todas as conversas dessa pessoa (tom, idioma, formato, foco). É gravado logo depois do cadastro; se essa etapa falhar, a conta continua criada e a tela avisa para ajustar no detalhe.
2. Decida a chave Funcionalidades em preview: ligada, a pessoa vê as funcionalidades ainda em desenvolvimento (DATTA BI, DATTA Captain e as demais marcadas com (Preview)); desligada, elas saem do menu, da tela Features, de Sistema e o botão do Captain some da barra. A chave nasce ligada para o perfil Administrador e desligada para os demais, e acompanha o perfil escolhido até você mexer nela. É preferência de exibição, não permissão: quem tem acesso e abre a tela pelo endereço continua entrando. Contas criadas antes da chave seguem vendo o preview.

Mudar a chave de uma conta existente. No detalhe do usuário, logo abaixo do perfil de acesso, a mesma chave Funcionalidades em preview mostra o estado atual da conta; mude e clique em Salvar Alterações. Exige USERS_EDIT, como os demais dados cadastrais. A mudança vale no próximo login da pessoa, ou quando a sessão dela se renovar (em até 8 horas): é o token de acesso que leva a escolha até a tela.

Prompt padrão do usuário

Cada usuário cadastrado pode ter um prompt padrão — o texto que a plataforma anexa ao prompt do sistema em toda interação dessa pessoa com a IA, no chat e no copilot. É um dado do cadastro, e por isso vive aqui:

• No detalhe do usuário, a seção Prompt padrão do usuário mostra o texto atual, o contador (limite de 8.000 caracteres) e o botão Salvar prompt. Deixar em branco e salvar remove o prompt.
• Permissão: ler exige USERS_VIEW; gravar exige USERS_EDIT (editar dados cadastrais). Não é uma concessão de acesso, então não passa por USERS_MANAGE_ROLES.
• Limite: acima de 8.000 caracteres a gravação é recusada com a contagem na mensagem — nunca truncada em silêncio.
• Auditoria: toda gravação gera USER.PROMPT_UPDATED com ator, alvo, origem, tamanho e se apagou, sem o texto.

O que a IA faz com o texto, os marcadores no prompt final e o caminho de autoatendimento pela API estão no guia do prompt padrão do usuário.

Dia a dia da gestão

• Buscar: a busca da listagem filtra por nome, e-mail, login ou cargo.
• Conferir: o detalhe do usuário exibe o login ao lado do e-mail, quando presente.
• Login é definitivo: ele não é editável pela interface depois do cadastro.

Perfis e permissões em detalhe — incluindo a criação de perfis próprios — estão no guia de roles e permissões. O cadastro de usuários, a autenticação e as operações administrativas de conta (consulta, atualização, remoção, definição de perfil e concessão de permissões diretas) também estão disponíveis pela API, para provisionamento automatizado: veja a referência de API.