Página de Usuários

Usuários

A página Usuários é sua lista de contas de login do Painel de administração — as pessoas que entram com e-mail e senha para gerenciar a fábrica. Cada usuário tem um nome, um e-mail, uma função, um Grupo de usuários atribuído que controla o que podem ver e (opcionalmente) chaves de API para acesso programático.

Abra-a pela barra lateral principal (Usuários) ou navegando para /users.

Página de Usuários

Usuários vs Funcionários. Um usuário é uma conta que faz login no Painel de administração — gerentes, planejadores, encarregados, back-office. Um funcionário é um trabalhador do chão de fábrica que toca um PIN no Kiosk. São duas identidades separadas. Veja Usuários vs Funcionários abaixo para como as duas se cruzam.

Sumário

Para que serve esta página
Anatomia da página
Lendo a tabela
As três funções
Buscando
Adicionando um usuário
Editando um usuário — o painel de Usuário
Aba Geral
Aba Estações de trabalho
Aba Chaves de API
Grupos de usuários
Usuários vs Funcionários
Autenticação de dois fatores
Excluindo um usuário
Dicas e melhores práticas

Para que serve esta página

A página de Usuários é seu registro de contas do Painel de administração. Use-a para:

Integrar novos colegas — crie um login, escolha uma função, atribua um Grupo de usuários, entregue a senha.
Controlar o acesso — Grupos de usuários (gerenciados em Configurações do aplicativo → Grupos de usuários) decidem quais módulos e quais visualizações kanban uma pessoa pode ver.
Emitir PINs para usuários híbridos — um planejador que também registra entrada no chão pode ter tanto um e-mail/senha quanto um PIN.
Gerenciar chaves de API — para usuários que precisam dirigir a API a partir de um script ou integração.
Auditar e rotacionar — veja quem tem acesso, quando verificaram e-mail pela última vez e remova o acesso de forma limpa quando alguém sair.

A maioria das fábricas mantém esta lista curta — tipicamente o proprietário, um ou dois gerentes, um planejador e (às vezes) o supervisor. Trabalhadores do chão de fábrica vão na página Funcionários em vez disso.

Anatomia da página

Esta página é somente para administradores — apenas usuários com a função admin veem a caixa de busca, o seletor Mostrar N entradas, o botão Adicionar Usuário e a paginação. Usuários não administradores veem a própria tabela (para que possam encontrar sua própria linha e editar seu perfil) mas não os controles de gerenciamento.

Para administradores, da esquerda para a direita no topo:

Caixa de busca — busca por nome ou e-mail.
Seletor Mostrar N entradas — 5 / 10 / 25 / 50 / 100 por página.
Botão Adicionar Usuário (canto superior direito).

Abaixo da barra de ferramentas fica a tabela de usuários, uma linha por usuário. Paginação padrão abaixo.

Lendo a tabela

Coluna	O que mostra
ID	ID numérico interno.
Nome	Nome completo.
E-mail	E-mail de login (também o endereço de contato).
Função	Uma de `Admin`, `Usuário` ou `Funcionário`, mostrada como uma pílula colorida. Veja As três funções.
E-mail Verificado	Data em que o usuário clicou no link de verificação (ou `-` se ainda não fez).
Criado	Quando a conta foi criada.
Ações	Lápis — abre o painel de edição.

As três funções

Cada usuário tem uma de três funções, escolhida quando a conta é criada e editável depois:

Função	Caso de uso
Admin	Acesso total. Pode gerenciar todos os usuários, todas as configurações, todos os dados. Tipicamente o proprietário e um ou dois segundos de confiança.
Usuário	Conta padrão do Painel de administração. As permissões são governadas pelo Grupo de usuários atribuído — eles podem ver apenas os módulos e visualizações kanban que o grupo permite. A função para a maioria dos planejadores, gerentes e equipe de back-office.
Funcionário	Um usuário que também tem acesso de PIN ao Kiosk. Vê o Painel de administração apenas na medida em que o Grupo de usuários permite, e adicionalmente tem um PIN para registrar entrada no chão. Veja Usuários vs Funcionários.

A função determina as permissões máximas; o Grupo de usuários as restringe. Um admin ignora o Grupo de usuários (ele pode fazer qualquer coisa de qualquer jeito); um usuário ou funcionário é restringido por ele.

Buscando

Digite na caixa de busca. A consulta corresponde a Nome e E-mail (não diferencia maiúsculas/minúsculas, correspondência contém). A lista atualiza cerca de 300 ms depois que você para de digitar.

Adicionando um usuário

Clique em Adicionar Usuário no canto superior direito. O painel de Usuário desliza pela direita com um formulário vazio.

No mínimo:

Nome — nome completo.
E-mail — e-mail de login. Deve ser único.
Senha — senha temporária com a qual o usuário fará login.
Função — Admin, Usuário ou Funcionário. Veja As três funções.

Opcional:

Grupo de usuários — escolha dos grupos definidos em Configurações do aplicativo → Grupos de usuários. Padrão para o grupo marcado como padrão.
PIN — apenas para função funcionário. 4 a 8 dígitos, único entre funcionários.
Estações de trabalho — apenas relevante quando o usuário é um funcionário e usará o Kiosk.

Clique em Criar. O usuário é criado e pode entrar imediatamente. Não há e-mail automático — você precisará compartilhar a senha com ele fora da banda. Eles podem mudá-la após o primeiro login via Configurações → Senha.

Primeiro administrador? O primeiro usuário criado durante a configuração da conta é o administrador inicial. Eles podem então criar usuários adicionais, incluindo mais administradores.

Editando um usuário — o painel de Usuário

Clique no ícone de lápis em qualquer linha para abrir o painel em modo de edição. O painel usa três abas:

Geral — nome, e-mail, função, Grupo de usuários, senha, PIN (quando a função é funcionário).
Estações de trabalho — apenas relevante para função funcionário.
Chaves de API — disponível apenas em modo de edição (você precisa de um usuário salvo para anexar chaves).

O cabeçalho tem dois botões:

Salvar — aplica suas mudanças.
Excluir — remove o usuário. Veja Excluindo um usuário.

Aba Geral

Campos:

Nome (obrigatório).
E-mail (obrigatório, único).
Função (obrigatório) — escolha Admin, Usuário ou Funcionário.
Grupo de usuários — escolha dos grupos configurados. Texto de dica lembra que isso controla acesso a módulos e visualizações.
PIN (apenas para função funcionário) — 4 a 8 dígitos numéricos, único.
Senha / Nova Senha — deixe em branco ao editar para manter a existente; digite um valor para mudá-la. Em um formulário de criação, o campo é obrigatório.

Abaixo do formulário, em modo de edição, você encontrará:

E-mail Verificado Em — timestamp somente leitura.
Criado Em / Atualizado Em — timestamps somente leitura.

Aba Estações de trabalho

Apenas relevante quando a Função do usuário é Funcionário. Idêntica à aba Estações de trabalho na página Funcionários — marque as estações em que esta pessoa está autorizada a registrar entrada via Kiosk.

Para funções admin e usuário, esta aba ainda aparece, mas não é funcional — essas funções não têm identidade de Kiosk.

Aba Chaves de API

Cada usuário pode emitir chaves de API pessoais para acesso programático ao sistema — útil para integrações, scripts e automações pontuais.

A aba está disponível apenas em modo de edição (você precisa de um usuário salvo para anexar chaves). Aqui você pode:

Criar Nova Chave de API — insira um nome amigável (por exemplo, “Servidor de produção”, “Zapier”, “Script de inventário”) e clique em Criar.
Visualizar / copiar uma chave existente. Note que a chave completa só é mostrada uma vez na criação — copie-a então; você pode visualizar novamente via o ícone de olho depois, mas se perdê-la inteiramente, crie uma nova e exclua a antiga.
Ver quando cada chave foi usada pela última vez.
Excluir chaves que não são mais necessárias.

Chaves de API concedem as mesmas permissões que o usuário que as criou (sujeitas ao Grupo de usuários). Quando esse usuário é excluído, as chaves dele vão junto.

Trate chaves de API como senhas. Não as comite no git, não as envie por e-mail, não as cole em um chat público. Se uma chave vazar, exclua-a desta aba — a chave antiga para de funcionar imediatamente.

Para chaves de API a nível de fábrica não amarradas a um único humano, use Configurações do aplicativo → Chaves de API em vez disso.

Grupos de usuários

Grupos de usuários são definidos em Configurações do aplicativo → Grupos de usuários e controlam:

Acesso a módulos — quais módulos de nível superior um membro vê (CRM, Produção, Configuração).
Acesso a visualizações — quais visualizações kanban e quais dispositivos (Desktop vs Aplicativo Móvel).

Cada usuário pertence a exatamente um Grupo de usuários (exceto usuários admin, que efetivamente o ignoram). O grupo Padrão é o que novos usuários sem um grupo especificado recebem.

Configurações comuns de grupo:

Planejadores — acesso a Produção + Configuração; todas as visualizações kanban.
Líderes de chão de fábrica — apenas acesso a Produção; uma ou duas visualizações kanban com escopo em departamento.
Back-office — CRM + Produção; todas as visualizações desktop; sem móvel.
Gerentes somente leitura — acesso desktop a visualizações relevantes, sem módulos de edição.

Edite grupos, não usuários individuais, sempre que quiser mudar uma permissão para uma classe de pessoas.

Usuários vs Funcionários

Esta é a fonte mais comum de confusão no sistema. A versão curta:

Identidade	Faz login via…	Identifica via…	Usado por…
Usuário (Usuários)	E-mail + senha do Painel de administração (+ 2FA opcional)	E-mail + Senha	Gerentes, planejadores, encarregados, back-office
Funcionário (Funcionários)	Modal de PIN do Kiosk / móvel	PIN numérico	Trabalhadores do chão de fábrica

São registros inteiramente separados por padrão — um Usuário não tem PIN, um Funcionário não tem senha.

Para representar uma pessoa como ambos (por exemplo, um planejador que ocasionalmente trabalha no chão):

Crie um Usuário com função = Funcionário.
Na aba Geral, defina um PIN.
Na aba Estações de trabalho, marque as estações em que está autorizado.

Esse único registro agora funciona como ambos — eles podem entrar no Painel de administração com e-mail+senha e registrar entrada no Kiosk com seu PIN. Seus registros de tempo atribuem para a mesma identidade em ambos os mundos.

Para uma pessoa que está apenas no chão de fábrica (sem acesso ao Painel de administração), prefira a página Funcionários em vez de criar um Usuário com função funcionário. É um registro mais simples e não ocupa uma vaga de login.

Autenticação de dois fatores

A Autenticação de Dois Fatores (TOTP / aplicativo autenticador) é gerenciada por usuário via Configurações → Autenticação de Dois Fatores (o usuário entra e configura ele mesmo). Não é gerenciada desta página — administradores não podem habilitar 2FA em nome de outra pessoa.

Para fábricas com dados sensíveis (PII de cliente, info financeira), considere fortemente:

Exigir que todos os administradores habilitem 2FA.
Documentar o processo de código de recuperação para que um autenticador perdido não bloqueie ninguém.

Excluindo um usuário

Abra o usuário no painel → clique no botão vermelho Excluir Usuário → confirme.

O que acontece:

O login é removido — o usuário não pode mais entrar.
Chaves de API pertencentes ao usuário são revogadas imediatamente.
Referências históricas (trabalhos criados, “editado por” de registros de tempo etc.) continuam apontando para o id do usuário agora excluído. Eles renderizam como “Desconhecido” ou em branco na interface.
Se o usuário também era uma identidade de função funcionário, seu PIN é liberado e temporizadores ativos não fecham automaticamente. Pare-os primeiro ou deixe um Cron Job pegá-los.

Não há desfazer. Para a equipe que sai, a alternativa segura é:

Mudar a senha deles para algo que só você sabe.
Remover os privilégios do Grupo de usuários deles.
Opcionalmente renomear a conta deles como “(Antigo) Jan Kowalski” para que as referências históricas permaneçam atribuíveis.

Isso preserva o histórico de auditoria enquanto remove o acesso.

Dicas e melhores práticas

Use Grupos de usuários, não permissões por usuário. Definir a permissão uma vez por grupo e então atribuir usuários a grupos é muito menos trabalho do que ajustar cada usuário.
Tenha pelo menos dois usuários Admin. Fábricas de admin único ficam bloqueadas quando esse único admin perde seu dispositivo. Dois admins de confiança é o mínimo de fator de ônibus.
Habilite 2FA para cada admin. O Painel de administração pode editar qualquer coisa; autenticação apenas com senha é uma defesa fina demais se seu negócio depende disso.
Funções vs Grupos: funções definem o máximo; grupos restringem. Usuários admin ignoram o grupo; usuário e funcionário são restringidos por ele.
Reserve a função funcionário para usuários híbridos. Para uma pessoa que apenas faz trabalho no chão, use a página Funcionários — é o registro mais simples e não consome uma vaga de login.
Trate chaves de API como segredos de produção. Nomeie-as após o sistema que as usa, rotacione-as quando esse sistema mudar de mãos, exclua as não usadas.
Não compartilhe contas. Se dois gerentes ambos gerenciam Produção, dê a eles seus próprios logins — trilhas de auditoria são inúteis quando “quem fez isso?” responde “a conta compartilhada”.
Para a equipe que está saindo, mude a senha + remova dos grupos em vez de excluir. Preserva o histórico de auditoria sem deixar o acesso aberto.
Documente o fluxo de recuperação. Cenários de 2FA perdido, senha esquecida, admin saindo com a única chave — escreva os passos para sua fábrica enquanto tudo está calmo.
Pareie isto com a página Funcionários para a imagem completa de quem pode fazer o quê no sistema — admin via login nesta página, acesso ao chão de fábrica em Funcionários, usuários híbridos em ambos.