Página de Funcionários

Funcionários

A página Funcionários é a lista mestra de cada trabalhador do chão de fábrica em seu sistema — as pessoas que registram entrada no Kiosk, executam temporizadores, registram quantidades e fazem a produção real. Cada funcionário tem um nome, um PIN opcional, uma lista de estações de trabalho às quais está autorizado e (opcionalmente) uma flag Supervisor.

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

Funcionários não são Usuários. Um usuário (Usuários) é uma conta que faz login no Painel de administração (e-mail + senha). Um funcionário é um trabalhador do chão de fábrica que toca um PIN no Kiosk. Estas são identidades completamente separadas por design — o sistema não assume que uma pessoa no chão precisa de acesso ao Painel de administração, e vice-versa. Você também pode ter uma pessoa representada como ambos (veja Usuários para como configurar isso).

Sumário

Para que serve esta página
Anatomia da página
Lendo a tabela
A coluna Registro de tempo ativo
Buscando
Adicionando um funcionário
Editando um funcionário — o painel de Funcionário
Aba Geral
Aba Estações de trabalho
Aba Registros de tempo
PINs explicados
Flag de Supervisor
Onde Funcionários aparecem em outros lugares
Excluindo um funcionário
Dicas e melhores práticas

Para que serve esta página

A página de Funcionários é seu registro de equipe do chão de fábrica. Use-a para:

Adicionar novos trabalhadores quando pessoas se juntam à equipe.
Atribuir estações de trabalho para que cada pessoa só possa registrar entrada nas estações em que é treinada.
Definir ou rotacionar PINs — o código de 4 a 8 dígitos que cada trabalhador usa no Kiosk.
Marcar supervisores que podem arrastar cartões entre colunas no Kiosk.
Auditar atividade recente — a aba Registros de tempo por funcionário mostra os últimos 7 dias do trabalho dele, agrupados por dia.
Ver quem está registrado agora mesmo — a coluna Registro de tempo ativo se atualiza ao vivo.

A maioria dos fluxos de onboarding: adicione um funcionário → defina um PIN → marque as estações de trabalho em que é treinado → entregue o PIN → eles podem começar a trabalhar.

Anatomia da página

Da esquerda para a direita no topo:

Caixa de busca — busca de texto livre em nome e sobrenome.
Seletor Mostrar N entradas — 5 / 10 / 25 / 50 / 100 por página.
Botão Adicionar Funcionário (canto superior direito).

Abaixo da barra de ferramentas fica a tabela de funcionários, uma linha por funcionário. Paginação padrão com um contador Mostrando X–Y de Z fica abaixo.

Lendo a tabela

Coluna	O que mostra
ID	ID numérico interno (pequeno, atenuado).
Nome	Primeiro nome. Uma pequena badge Supervisor aparece ao lado do nome se a flag de supervisor estiver definida.
Sobrenome	Sobrenome.
Estações de trabalho	Pílulas listando as estações de trabalho às quais este funcionário está autorizado. Se a lista for longa, as primeiras cinco são mostradas e o restante colapsa em um chip `...` sobre o qual você pode passar o mouse para ver a lista completa.
Registro de tempo ativo	No que este funcionário está atualmente trabalhando, ao vivo. Veja abaixo.
Ações	Lápis — abre o painel de edição.

A coluna Registro de tempo ativo

Se o funcionário tem um temporizador rodando agora mesmo, esta coluna mostra ao vivo:

Um ponto verde pulsante à esquerda sinaliza “ativo”.
O nome do trabalho é mostrado em negrito, com o Núm Ref do trabalho em texto menor ao lado.
A estação de trabalho na qual está registrado.
Um relógio com tique-taque ao vivo (HH:MM:SS) contando desde que começou.

Se nenhum temporizador estiver rodando, a coluna mostra —.

O tique-taque é real — a cada segundo a exibição decorrida atualiza para que você possa ver em um relance quem está atualmente no chão e há quanto tempo está em um trabalho. Útil para a rodada matinal quando você quer confirmar que todos registraram entrada corretamente, e útil no fim do turno para identificar qualquer um que esqueceu de parar seu temporizador.

Buscando

Digite na caixa de busca no canto superior esquerdo. A consulta corresponde a Nome e Sobrenome (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 funcionário

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

No mínimo, preencha Nome e Sobrenome. Todo o resto é opcional, mas vale a pena definir:

PIN — o código de 4 a 8 dígitos que o trabalhador tocará no Kiosk. Veja PINs explicados.
Supervisor — veja Flag de Supervisor.
Estações de trabalho — as estações em que este funcionário pode registrar entrada. Veja Aba Estações de trabalho.

Clique em Criar para salvar. O funcionário aparece na lista imediatamente e pode receber seu PIN.

Editando um funcionário — o painel de Funcioná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, sobrenome, PIN, flag de supervisor.
Estações de trabalho — quais estações este funcionário está autorizado.
Registros de tempo — atividade recente, agrupada por dia (últimos 7 dias).

O cabeçalho tem dois botões:

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

A aba Registros de tempo é oculta em modo de criação (um funcionário novo não tem histórico).

Aba Geral

Campos:

Nome (obrigatório) — primeiro nome.
Sobrenome (obrigatório) — sobrenome.
PIN (opcional) — código de 4 a 8 dígitos. Deve ser único em sua conta.
Supervisor — alternância. Desbloqueia controles extras do Kiosk (arrastar e soltar). Veja abaixo.

O campo PIN é tipado como senha por padrão para que não apareça sobre o ombro de um colega enquanto você está editando.

Aba Estações de trabalho

A lista de estações de trabalho da sua lista mestra Estações de trabalho, cada uma com uma caixa de seleção. Marque aquelas em que este funcionário está autorizado a trabalhar.

O que a lista de estações de trabalho controla:

No Kiosk, apenas as estações de trabalho desta lista aparecem no Editor de Estação de trabalho deste funcionário.
O mesmo escopo se aplica ao aplicativo móvel.
Tentar registrar trabalho em uma estação fora desta lista falhará com um erro de permissão.

Uma contagem de N estação(ões) selecionada(s) aparece na parte inferior para verificação.

Lista vazia = nada. Um funcionário sem estações de trabalho selecionadas não poderá fazer nada no Kiosk exceto visualizar o quadro. Certifique-se de marcar pelo menos as estações em que é treinado.

Aba Registros de tempo

A aba Registros de tempo é o registro de auditoria por funcionário dos últimos 7 dias (hoje + 6 dias inteiros anteriores).

As entradas são agrupadas por dia, com o total do dia mostrado ao lado do cabeçalho de cada dia. “Hoje” e “Ontem” são rotulados como tal; dias mais antigos usam o formato dia-mês da localidade.

Dentro de cada dia, as entradas são listadas mais recentes primeiro. Cada entrada mostra:

O nome do trabalho e #ref_no.
A estação de trabalho.
O horário de início da entrada.
A duração — ou uma pílula verde “Em andamento” se o temporizador ainda estiver rodando.

Temporizadores ativos (em execução) são visíveis mas excluídos do total do dia para que o número seja determinístico.

A aba carrega no primeiro clique — abrir o painel não busca nada imediatamente até você clicar em Registros de tempo.

Para intervalos mais longos, filtragem completa ou para exportar, use a página Controle de tempo sistema inteiro em vez disso.

PINs explicados

Um PIN é um código numérico de 4 a 8 dígitos que um funcionário usa para se autenticar no Kiosk e aplicativo móvel. Sempre que registra uma quantidade, inicia um temporizador, bloqueia uma tarefa, ou faz qualquer outra coisa que escreve dados, o Kiosk pede o PIN.

Regras de PIN:

Apenas numérico — dígitos 0–9.
4 a 8 dígitos de comprimento.
Único em todos os funcionários em sua conta (nenhum dois pode compartilhar um PIN).
Opcional quando você cria um funcionário — mas o funcionário não pode fazer nada no Kiosk sem um.

Definir / mudar um PIN é apenas uma questão de digitá-lo na aba Geral e salvar. PINs salvos são armazenados como estão no servidor (não com hash) — este é um código visível aos administradores, não uma senha criptográfica.

Trate PINs como semi-privados. Qualquer um com a URL de um Kiosk não autenticado e um PIN válido pode registrar trabalho como aquele funcionário. Rotação de PIN é uma boa prática para fábricas com alta rotatividade.

Se um PIN for esquecido, apenas defina um novo na aba Geral e diga ao funcionário. Não há fluxo de “Esqueci meu PIN” no próprio Kiosk — isso é intencional, pois o líder da equipe geralmente está por perto.

Flag de Supervisor

Quando Supervisor = ligado, o funcionário desbloqueia controles adicionais do Kiosk:

Eles podem arrastar cartões entre colunas de estações de trabalho no Kiosk, avançando ou reroteando o trabalho. (Funcionários regulares só podem registrar progresso na coluna em que um cartão já está.)
Seu PIN é aceito em URLs do Kiosk que têm show_login=1 para ações elevadas.

A permissão de supervisor é concedida por funcionário, não por estação de trabalho — uma vez supervisor, podem arrastar em qualquer lugar que seu acesso a estação de trabalho permita.

Use isto para líderes de turno, encarregados, planejadores que ocasionalmente entram no chão — qualquer um cujo trabalho é manter o trabalho fluindo, em vez de apenas fazê-lo.

Para trabalhadores do dia a dia, deixe desligado. Removê-lo depois é apenas uma questão de desmarcar e salvar.

Onde Funcionários aparecem em outros lugares

Em qualquer lugar onde uma pessoa interage com o chão de fábrica, o registro de funcionário o conduz:

Onde	O que você verá
Kiosk	O modal de PIN autentica este funcionário. O Editor de Estação de trabalho tem escopo na lista de estações deles. A flag de supervisor desbloqueia arrastar e soltar.
Aplicativo móvel	Mesmo fluxo dirigido por PIN; mesmo escopo de estação de trabalho.
Página de Produção	O grupo de avatares da barra superior mostra cada funcionário registrado. Clique em um avatar para filtrar para o trabalho atual deles.
Página Controle de tempo	O filtro Funcionário lista todos aqui.
Aba Controle de tempo por trabalho (no painel de Trabalho)	Lista cada entrada por funcionário; o Adicionar Registro de Tempo manual escolhe desta lista.
Resumos por e-mail de Cron Jobs	Resumos de temporizadores fechados listam os nomes de funcionários daqui.
Payloads `time_log_saved` de Webhooks	Incluem id, name, surname do funcionário.

As mudanças aqui são imediatas em todos os lugares — sem necessidade de atualização.

Excluindo um funcionário

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

O que acontece:

O registro do funcionário é removido.
Entradas históricas de tempo são preservadas — elas continuam referenciando o id antigo do funcionário. A página Controle de tempo as exibirá com uma coluna Funcionário vazia.
O PIN é liberado, então um novo funcionário poderia ser criado com ele (evite isso — causa confusão na auditoria).
Qualquer temporizador ativo deste funcionário não é fechado automaticamente. Pare-o primeiro, ou execute um Cron Job.

Não há desfazer. Para funcionários que deixam a equipe, considere uma alternativa: desmarque cada estação de trabalho em vez de excluir. O funcionário não pode mais registrar entrada, mas seu histórico permanece anexado a uma pessoa nomeada em vez de um id órfão.

Dicas e melhores práticas

Defina um PIN imediatamente. Um funcionário autorizado em estação de trabalho sem PIN não pode fazer nada no Kiosk. Digite um PIN, salve, entregue.
Amarre PINs a sistemas existentes. Se sua fábrica já usa números de crachá ou códigos de porta, reutilize-os — mais fácil de lembrar do que mais um código.
Seja seletivo com a flag de Supervisor. Um supervisor pode arrastar cartões em qualquer lugar; se todos forem supervisores, a proteção Permitir arrastar para dentro nas estações de trabalho se torna inútil. A maioria das fábricas precisa de 1–3 supervisores no total.
Marque apenas estações em que o funcionário foi treinado. É uma coisa de segurança (previne uso indevido) e uma coisa de UX (menos estações no Kiosk = mais rápido para escolher).
Use a coluna Registro de tempo ativo como uma verificação matinal. Uma coluna em branco logo após o início do turno significa que alguém esqueceu de registrar entrada.
Use a aba Registros de tempo para verificações pontuais. Suspeita que alguém registrou entrada mas não fez realmente o trabalho? Abra a aba Registros de tempo dele, escaneie o dia. Combine com a aba Controle de tempo do painel de Trabalho para o outro lado da imagem.
Não exclua; desabilite. Desmarque cada estação de trabalho em um funcionário que está saindo em vez de excluí-lo. Preserva a atribuição histórica.
Rotacione PINs em uma programação. Rotação trimestral é suficiente para a maioria das fábricas; se os PINs acabam colados aos monitores, rotacione com mais frequência.
Um funcionário por pessoa. Evite funcionários “compartilhados” (um “Andar 1” genérico com um PIN que todos usam). Os registros de tempo se tornam sem sentido, e o sistema não pode distinguir ninguém.
Um usuário pode também ser um funcionário. Se um planejador às vezes trabalha no chão, dê a ele uma conta de Usuário do painel de administração e um registro de Funcionário. Veja Usuários.