Manual de Operações

LaborControl é um sistema de controle de entrada e saída de funcionários terceirizados em obras. Ele permite registrar o ponto dos trabalhadores com verificação facial e geolocalização (pelo celular ou por catraca física), gerenciar General Contractors (construtoras), clientes contratantes, fornecedores, ordens de serviço e o catálogo de funções (pedreiro, eletricista, mestre de obra etc. — um valor por funcionário), e acompanhar o custo real de homem-dia e o andamento físico versus o valor e o prazo contratados — tudo isso por fornecedor. A função de cada funcionário aparece só como detalhamento informativo dentro do fornecedor, sem afetar o custo previsto.

O sistema é um PWA (aplicativo instalável): funciona no navegador normalmente, mas também pode ser adicionado à tela inicial do celular e passa a abrir como um app. Uma vez aberto pelo menos uma vez com internet, o registro de ponto continua funcionando mesmo sem conexão — os registros ficam guardados no aparelho e são enviados automaticamente assim que a internet voltar.

Acesse laborcontrol.web.app pelo navegador (ou pelo ícone, se já tiver instalado o app).

A tela de login tem duas abas: Empresa (admin/gerente/engenheiro) e Operário.

3.1 Entrada — Empresa (admin/gerente/engenheiro)

1. Selecione a aba Empresa
2. Digite seu e-mail e sua senha
3. Clique em Entrar

Esqueci minha senha: digite o e-mail no campo e clique em Esqueci minha senha. Se o e-mail estiver cadastrado, você recebe um link de redefinição por e-mail.

Primeiro acesso (quando um admin/gerente acabou de criar sua conta): clique em Primeiro acesso? Criar senha, informe seu e-mail e crie uma senha (mínimo 6 caracteres, com confirmação). Ninguém mais vê ou define essa senha por você.

3.2 Entrada — Operário

O operário tem um login sem senha, por foto:

1. Selecione a aba Operário
2. Digite o login que você escolheu no seu cadastro
3. Tire uma foto ao vivo (o sistema compara com a foto de referência do seu cadastro — não é possível enviar uma foto da galeria aqui, só ao vivo, por segurança)
4. Toque em Entrar

Se a foto conferir, você entra direto na tela de registro de ponto.

Conta antiga (CPF e senha): se você já usava o sistema antes e tinha CPF+senha, ainda dá para entrar assim — link "Tenho uma conta antiga (CPF e senha)" na tela de login do operário.

3.3 Primeiro acesso do operário

Toque em "Primeiro acesso? Cadastre-se" na aba Operário e digite seu CPF, RG ou CNH — qualquer um dos três, o que valer é o mesmo documento que seu engenheiro/gerente usou (se já te cadastrou). O sistema busca sozinho e decide o que mostrar a seguir, sem você precisar saber se já foi cadastrado ou não:

• Encontrou seu cadastro — mostra seu nome pra confirmar, e pede só um login (identificador livre — nome, apelido, o que preferir). Se já existe uma foto de referência sua no cadastro, a foto é opcional aqui; senão, é obrigatória.
• Não encontrou — cai num formulário completo: nome completo, documento (RG ou CNH), CPF (esse sim obrigatório — é o identificador oficial do funcionário no sistema, independente do que foi digitado na busca), data de nascimento, e o fornecedor (empresa terceirizada) pela qual você trabalha — ela precisa já estar cadastrada no sistema. Digite o nome do fornecedor e escolha numa lista de busca (não precisa saber o CNPJ de cor) — ou, se souber, digite o CNPJ direto num campo alternativo. Se o CNPJ existir em mais de uma empresa cliente do LaborControl, o sistema pede pra você escolher qual é a certa. Depois de identificar o fornecedor, escolha sua Função numa busca sobre o catálogo da empresa dele — campo obrigatório. Foto ao vivo é sempre obrigatória neste modo.

Nos dois casos, é preciso marcar o aceite do termo de consentimento LGPD antes de concluir. Ao final, volte para a tela de login e entre normalmente com login + foto.

O LaborControl atende várias construtoras ao mesmo tempo (multi-tenant) — cada uma só enxerga seus próprios dados. Na tela, cada construtora cliente da plataforma aparece como General Contractor (antes chamado de "Empresa" — mesmo cadastro, só o nome mostrado mudou).

1. No menu Config → General Contractors
2. + Novo General Contractor: informe CNPJ (clique em Buscar CNPJ para preencher a razão social automaticamente), a razão social e o nome fantasia — os dois obrigatórios desde 2026-09-21 — e confirme. O nome fantasia é o nome exibido no resto do sistema
3. A lista mostra todos os General Contractors cadastrados, com um botão Ativar/Desativar por linha
4. No detalhe de cada um dá pra editar razão social, nome fantasia e CNPJ

4.1 Excluir um General Contractor (novo, 2026-09-15)

No detalhe do General Contractor, seção Excluir empresa. Ao clicar, o sistema confere na hora o que ainda está vinculado a ele — obras, usuários, clientes, fornecedores e funções:

• Se houver qualquer vínculo, a exclusão é bloqueada e a tela lista quantos de cada existem ("3 obras", "12 usuários"...). É preciso remover ou realocar cada um antes.
• Se estiver vazio, aparece o botão Confirmar exclusão definitiva — a exclusão é permanente e não pode ser desfeita.

Não existe exclusão em cascata, de propósito: nunca se apaga histórico de ponto, foto facial ou outro dado sensível em massa por acidente. Pra só suspender o acesso, use Desativar.

O menu Config reúne as telas administrativas: Usuários, Equipe, Funções, Fornecedores, Clientes, General Contractors (só admin), Monitor de Catracas (só admin), o Log de Alterações (só admin) e Ajuda (este manual e os guias rápidos). Um engenheiro não vê esse menu.

5.1 Usuários

1. Config → Usuários
2. + Criar usuário: nome, e-mail, papel e empresa
   • Admin escolhe entre Engenheiro, Gerente, Estagiário ou Admin, e o General Contractor ao qual o usuário pertence, buscando pelo nome ou CNPJ
   • Gerente pode criar Engenheiro, outro Gerente ou Estagiário, automaticamente na própria empresa
3. A senha é definida pelo próprio usuário: em Login → Primeiro acesso, com o e-mail dele. Ninguém além do dono da conta vê ou define essa senha.
4. Redefinir senha: clique no botão ao lado do usuário — não gera nem mostra senha, só força o usuário a passar pela tela de "Primeiro acesso" de novo no próximo login.
5. Ativar/Desativar: usuários inativos não conseguem logar.
6. Trocar papel: direto na listagem, pelo seletor ao lado do nome.

5.2 Funções (catálogo por empresa) e classificação MOD/MOI

Cada General Contractor mantém seu próprio catálogo de funções (o cargo/ofício do trabalhador — ex.: Pedreiro, Eletricista, Mestre de Obra, Servente) — usado só no cadastro de funcionário: cada funcionário tem exatamente uma função. Obra e fornecedor não têm mais função/disciplina cadastrada — desde a reforma de 2026-08, função é atributo só do funcionário, e aparece nos relatórios como detalhamento informativo dentro do fornecedor.

1. Admin edita o catálogo de qualquer General Contractor, dentro de Config → General Contractors → [o GC] → Funções; gerente edita direto o do próprio em Config → Funções
2. + Nova função: o nome e a classificação MOD ou MOI
3. Ativar/Desativar — funções inativas somem do cadastro de funcionário, mas continuam existindo no histórico

MOD × MOI (novo, 2026-09-17). Toda função é classificada como:

• MOD — Mão de Obra Direta (ex.: pedreiro, armador, eletricista): o efetivo que executa o serviço e precisa ser acompanhado de perto. O ponto continua passando pela aprovação do gerente/engenheiro (seções 11 e 11.1).
• MOI — Mão de Obra Indireta (ex.: almoxarife, apontador, vigia): apoio. O ponto já entra aprovado automaticamente, igual ao de visitante — registra a presença sem ocupar a fila de aprovação.

A tela de funções mostra duas colunas, MOD e MOI — pra reclassificar uma função, arraste o cartão de uma coluna pra outra (no celular, use o botão → MOI / → MOD do próprio cartão). A classificação é da função, não da pessoa: todo funcionário daquela função herda a classificação automaticamente (na lista de Equipe aparece uma etiqueta azul MOD ou rosa MOI ao lado da função). Reclassificar uma função vale só para os próximos registros — o que já foi gravado não muda. Toda função que já existia antes dessa mudança nasceu como MOD.

6.1 Criar nova obra

1. Obras → + Nova Obra
2. Cliente Contratante: escolha se é pessoa jurídica ou física, informe o CNPJ/CPF e busque automaticamente (ou fotografe o documento) — ou busque um cliente já cadastrado pelo nome. Revise os dados antes de confirmar
3. Identificação da obra: nome/apelido curto (ex.: "Galpão 2"), CEP, endereço completo, coordenadas (latitude/longitude — copie do Google Maps), raio do geofence em metros
4. Responsável técnico: se você é engenheiro, a obra já fica com você automaticamente. Se é gerente ou admin, escolha quem vai ser o responsável técnico num campo de busca — pode ser tanto um engenheiro quanto um gerente (um gerente pode coincidentemente ser também quem acompanha a obra tecnicamente)
5. Cronograma: data de início/fim previstas, e o regime de dias — "Dias úteis + sábado", "Segunda a sexta (sem sábado)" ou "Todos os dias"
6. Obra possui refeitório interno (novo, 2026-09): marque se o operário não sai da obra pra almoçar — o sistema desconta 1h de almoço do intervalo entre a primeira entrada e a última saída do dia, e considera 9h de jornada prevista no Diário de Obra e no Resumo do Período do Dashboard (seções 11.1 e 14.4). Desmarque se o operário sai e bate ponto de novo pro almoço — nesse caso nada é descontado à parte, e a jornada prevista é 8h. Vem marcado por padrão; dá pra mudar depois no detalhe da obra
7. Horário e hora extra: defina o horário padrão de entrada/saída — tudo que ficar fora dessa faixa passa a contar como hora extra automaticamente, sem precisar cadastrar um horário de hora extra separado
8. Salvar

6.2 Status da obra

A obra avança de status automaticamente: Planejamento → Aprovada quando a primeira ordem de serviço é aprovada, e → Em andamento quando o primeiro ponto é registrado ali. Além disso, no detalhe da obra há botões manuais para Concluir ou Paralisar/Retomar.

6.3 Detalhe da obra

• Dados da obra — nome, endereço, CEP, geofence, cronograma, regime de dias, refeitório interno e responsável técnico. Editáveis só por admin/gerente (mesmo o engenheiro responsável não pode mudar endereço/geofence/prazo — só o status); o responsável técnico pode ser trocado a qualquer momento pelo botão Trocar
• Andamento físico — % de execução por fornecedor (com "🏠 Equipe própria" quando for o caso) e da obra total, calculado pelos dias efetivamente trabalhados contra o previsto na(s) ordem(ns) de serviço aprovada(s) daquele fornecedor. Cada fornecedor pode ser expandido ("Ver detalhamento por função") pra ver quantos homem-dia cada função contribuiu — só informativo. Essa tela é somente leitura — pra mudar o previsto, aprove ou edite uma ordem de serviço (seção 8)
• Ordens de serviço e solicitações — enviar solicitação a um fornecedor (com link público para ele preencher sozinho, seção 8), subir/lançar ordem de serviço
• Equipe alocada — quem já está apto e/ou já bateu ponto ali, com opção de Encerrar (não existe mais botão de "adicionar funcionário" — ver seção 9)
• Registros — botão no topo, leva à validação de pontos (seção 11)
• Diário de Obra — botão no topo (seção 11.1)
• Dashboard (seção 14)

Cliente é quem contratou a obra — pode ser uma empresa (CNPJ) ou uma pessoa física (CPF), ver seção 7.1. Fornecedor é a empresa que presta a mão de obra na obra — inclusive a própria construtora, se ela executar serviço com gente própria: nesse caso ela é cadastrada aqui como um fornecedor normal, com OS aprovada como qualquer outro (o atalho de "equipe própria" deixou de existir em 2026-08-29 — seção 4).

7.1 Cadastrar

Fornecedor: sempre CNPJ — + Novo, informe CNPJ + Buscar CNPJ (ou fotografe o cartão CNPJ), confirme razão social, nome fantasia (obrigatório desde 2026-09-21 — é o nome exibido em todo o sistema: Diário de Obra, Registros, BI, busca no primeiro acesso do operário; a razão social só aparece no cadastro) e dados de contato. Salvar. Fornecedores cadastrados antes dessa data receberam a razão social repetida no nome fantasia — edite pelo detalhe do fornecedor se o nome comercial for outro. Fornecedor não tem mais um catálogo próprio de disciplinas/funções — qualquer fornecedor ativo da construtora pode ter funcionário batendo ponto em qualquer obra dela (a função fica só no cadastro de cada funcionário, seção 9.1).

Cliente: pode ser pessoa jurídica (CNPJ) ou pessoa física (CPF) — escolha o tipo no topo do formulário antes de preencher. Nos dois casos dá pra buscar automaticamente (CNPJ na Receita Federal) ou fotografar um documento (cartão CNPJ, ou RG/CNH no caso de pessoa física) para preenchimento automático por IA — revise os dados antes de confirmar. Ao cadastrar uma obra, também dá pra buscar um cliente já cadastrado pelo nome, sem precisar saber o CPF/CNPJ de cabeça.

7.2 Detalhe

• Cliente: dados de contato + lista de obras contratadas por ele
• Fornecedor: dados de contato + obras onde tem funcionários ativos

Admin/gerente podem Ativar/Desativar cliente ou fornecedor.

8.1 Solicitar ordem de serviço a um fornecedor

No detalhe da obra: Nova Solicitação → escolha o fornecedor, descreva o escopo, defina o prazo de resposta, Enviar.

A solicitação gera automaticamente um link público — na lista de solicitações da obra, use Copiar link (ou o botão de e-mail, que abre seu cliente de e-mail com o link já no corpo da mensagem) para mandar pro fornecedor. Pelo link, o próprio fornecedor preenche o formulário da ordem de serviço, sem precisar de login nem criar conta. O link para de funcionar assim que usado uma vez.

8.2 Registrar ordem de serviço recebida (upload + IA)

1. Na solicitação (ou direto pela obra): Upload ordem de serviço
2. Faça upload do arquivo — PDF ou Word (.docx) têm leitura automática por IA; Excel é aceito no upload, mas hoje só pra guardar o arquivo, sem extração automática (preencha os valores manualmente na revisão)
3. O sistema extrai os valores automaticamente com IA (Claude) — um contrato único, com valor de serviço, prazo (dias de trabalho e, quando o documento tiver datas de calendário explícitas, também início/fim previstos) e número de operários sugeridos. Se o documento original discrimina por especialidade/frente de trabalho, a IA soma os valores/efetivo automaticamente num único total
4. Revisão humana obrigatória: confirme (ou corrija) o valor do serviço, o prazo e o número de operários previstos, na seção "Dados do contrato"
5. Documento PDF aparece com pré-visualização direta na tela de revisão (visor grande, sem painel de miniaturas atrapalhando, com opção de abrir em nova aba); documento Word é convertido automaticamente pra mostrar o conteúdo lido, sem precisar baixar o arquivo pra conferir
6. Aprovar ou Rejeitar

8.3 Ordem de serviço manual

Sem upload de arquivo: Entrada manual na obra — um único contrato por fornecedor, com valor do serviço, dias de trabalho, número de operários e data início/fim previstas (se souber as duas). Salvar.

8.4 Editar, encerrar ou cancelar uma OS já aprovada

Na tela de revisão de uma ordem de serviço aprovada (admin, gerente ou engenheiro), três botões:

• Editar — reabre os campos pra corrigir erro de digitação/valor/prazo. Salva em cima do que já existe, recalculando os totais.
• Encerrar contrato — pro fornecedor que teve o contrato rescindido antes do prazo previsto. Os dias já trabalhados continuam contando nos relatórios de custo/andamento; o que muda é que os pontos batidos por esse fornecedor deixam de contar como cobertos por OS a partir daí.
• Cancelar OS — pra quando a própria aprovação foi um engano (OS duplicada, aprovada pra obra/fornecedor errado). Sai de qualquer totalização de valor previsto, como se nunca tivesse sido aprovada. Só funciona enquanto nenhum ponto já tiver sido registrado sob ela — se já tem gente trabalhando, o sistema recusa e sugere usar "Encerrar contrato" em vez disso.

9.1 Cadastrar funcionário

1. Config → Equipe → + Novo Funcionário
2. Fotografe o documento (RG ou CNH) — a IA extrai nome, tipo/número de documento, data de nascimento e CPF automaticamente (revise antes de confirmar)
3. Escolha o fornecedor (se for gente da própria construtora, escolha a construtora cadastrada como fornecedor — seção 7)
4. Selecione a Função do funcionário (busca sobre o catálogo inteiro da empresa — Config → Funções, seção 5.2) — campo obrigatório, um valor só por pessoa. A função define se ele é MOD ou MOI — e, portanto, se o ponto dele passa por aprovação
5. Escolha o regime de trabalho — CLT, MEI, PJ, Sócio ou Estagiário
6. Opcionalmente, tire ou envie uma foto de referência facial
7. Salvar

9.2 Como o funcionário bate ponto — e o que faz o ponto contar no custo

Não existe mais tela de "alocar funcionário numa obra", nem qualquer pré-condição pra bater ponto. Qualquer funcionário cadastrado pode bater ponto em qualquer obra da mesma construtora — o registro é sempre aceito, não importa se ele "deveria" estar naquela obra ou não.

O que muda é só se aquele ponto conta no homem-dia/custo:

• Qualquer fornecedor (inclusive a própria construtora cadastrada como fornecedor) — só conta se o fornecedor tiver uma ordem de serviço aprovada naquela obra (seção 8). Sem isso, o ponto é salvo do mesmo jeito, mas fica marcado "Sem OS" — não entra no cálculo de homem-dia até a OS ser aprovada. Assim que a OS for aprovada, todos os pontos "Sem OS" já batidos por aquele fornecedor naquela obra passam a contar automaticamente, sem precisar bater ponto de novo.

A tela Obras avisa com um alerta vermelho ("🚫 N operário(s) sem OS") sempre que isso está acontecendo em alguma obra, pra facilitar notar e resolver (aprovando a OS pendente).

O vínculo com a catraca física também é automático: ao cadastrar/reativar um funcionário, ele já é sincronizado com todas as catracas de todas as obras da mesma empresa — não só da obra onde bateu ponto pela primeira vez.

9.3 Encerrar vínculo com uma obra

No detalhe da obra, seção "Equipe alocada": botão Encerrar ao lado do nome.

10.1 Operário

1. Depois de entrar (login por foto), a tela detecta automaticamente em qual obra você está, pela sua localização — não precisa escolher manualmente
2. Tire a foto (comparada com sua foto de referência)
3. Toque para registrar — o sistema decide sozinho se é entrada ou saída (comparando só com o último registro do mesmo dia), com base no seu último registro

10.2 Ponto assistido (engenheiro) e manual (admin/gerente)

Engenheiros também podem bater ponto de um funcionário pelo próprio celular, na frente dele — mesmas exigências de foto e localização do operário: escolha a obra, o fornecedor (qualquer fornecedor ativo da construtora, mesmo sem OS aprovada ainda) e o funcionário.

Admin e gerente têm ainda um modo administrativo: escolhem obra, fornecedor e funcionário manualmente, a foto é opcional, e existe um botão "Registrar manual, sem localização" para correções/backfill — esse é o único tipo de registro que continua sendo aprovado automaticamente, sem passar por Pendentes de Validação.

10.3 Ponto pela catraca física (quando a obra tiver uma instalada)

Em obras de maior movimento, uma catraca física com reconhecimento facial embarcado pode ser usada como canal adicional (ou único) de ponto — o reconhecimento roda no próprio equipamento, sem precisar de celular. O cadastro do funcionário no app é sincronizado automaticamente com toda catraca vinculada à obra; ao desligar um funcionário, ele é removido de todas as catracas onde estava sincronizado. Um cadastro feito direto no painel da catraca (sem passar pelo app) vira uma pendência para o gerente confirmar antes de valer como ponto oficial.

Na tela Config → Catracas da obra, cada catraca cadastrada mostra um indicador de status — Online (comunicou com o sistema recentemente), Offline (parou de comunicar) ou Nunca conectada — além dos botões Editar (corrigir apelido, número de série, definir a Direção do leitor — "Entrada", "Saída" ou "Não definida" — e o Sentido de giro pra liberação de visitante), Computadores pareados (abaixo) e Excluir (remove o cadastro do sistema; não mexe no equipamento físico, e preserva o histórico de auditoria e de acessos de visitante já registrados).

Computadores pareados — um código por computador (novo, 2026-09-17). Cada computador conectado a uma catraca tem o seu próprio código de pareamento. No card da catraca, botão Computadores pareados:

• Lista os computadores já pareados (o primeiro aparece como "Computador original")
• + Gerar código pra este computador — dê um apelido (ex.: "Notebook backup"), copie o código na hora (ele só aparece uma vez, igual senha) e cole no agente do computador novo
• Revogar — desliga só aquele computador, na hora. Os outros continuam funcionando normalmente.

Se um notebook perdeu a configuração, é só revogar o dele e gerar um código novo — antes, o botão "Gerar novo código" trocava o código de todos os computadores de uma vez e derrubava também o que estava funcionando.

10.3.1 Visitante na catraca (cliente, fiscalização — não é funcionário)

Sem cadastro, a catraca trava a entrada de quem não é funcionário terceirizado. Dois jeitos de resolver, na tela Config → Catracas da obra (admin/gerente/engenheiro):

• Cadastrar visitante — nome + foto, pra visita planejada ou recorrente. Sincroniza sozinho com as catracas ativas da obra, igual ao cadastro de funcionário. Cada identificação na catraca fica registrada, mas não é ponto — visitante nunca entra em nenhum cálculo de custo ou homem-hora, e aparece junto com os pontos na tela de Registros da obra (seção 11), sempre já liberado (nunca passa por aprovação).
• Liberar visitante agora — botão em cada catraca cadastrada, pra visita não planejada. Exige preencher o nome do visitante e uma justificativa antes de confirmar (data/hora e responsável já ficam gravados automaticamente) — destranca uma vez, sem cadastrar ninguém. Desde 2026-08-26, a confirmação tem dois botões — "Confirmar entrada" (verde) e "Confirmar saída" (laranja) — escolha o que corresponde ao sentido real da pessoa; antes toda liberação manual virava "entrada" no registro, mesmo quando era alguém saindo.

10.3.2 Monitor de Catracas (somente Admin)

Config → Monitor de Catracas — visão de todas as catracas de todas as obras num só lugar: status de conexão, último evento, pendências de sincronização, com filtro por obra/status/nome e busca por número de série (acha todas as linhas daquela catraca física em qualquer obra, ativa ou inativa). Em cada linha, botão Ativar/Desativar — serve pra corrigir uma transferência entre obras feita errada; o sistema não deixa duas linhas com o mesmo número de série ativas ao mesmo tempo (desative uma antes de ativar a outra).

Clique numa catraca pra ver o detalhe:

• Status do agente (novo, 2026-08-31) — o que o notebook ativo reporta a cada ciclo: IP local, versão do agente, último erro (ex.: "login ou senha inválidos" na catraca) e o log recente. Não é mais preciso ir até o notebook físico pra descobrir por que a catraca parou.
• Configuração remota da catraca (novo, 2026-08-31) — troca o IP:porta, login e senha que o agente usa pra entrar no equipamento, sem ir até a obra. É aplicada no próximo ciclo do agente (~20s, e só se o notebook estiver ligado); o resultado aparece em "Status do agente" logo depois. A senha é guardada criptografada.
• Sincronização de cada pessoa (com botão Reenviar quando o reenvio automático se esgota depois de 3 tentativas), histórico de comandos enviados (inclusive os de configuração remota), histórico de liberações manuais (quando, quem liberou, nome informado do visitante e justificativa) e histórico de reconhecimentos de visitante.

Atualiza sozinha a cada 30s; exportável em CSV.

10.4 Funcionamento offline

Depois de abrir o app pelo menos uma vez com internet, o registro de ponto continua funcionando sem conexão, mesmo com o app fechado e reaberto:

• Sem internet, o botão muda para "Registrar Ponto (offline)", e o card que normalmente mostra "Entrada"/"Saída" mostra "Confirmado ao enviar"
• Ao registrar, aparece a tela de confirmação com um aviso amarelo: o ponto foi salvo no aparelho e será enviado sozinho assim que a internet voltar
• Enquanto houver pontos pendentes de envio, um aviso fica fixo na tela mostrando quantos estão na fila, com um botão "Tentar agora"
• Se algum ponto específico falhar ao tentar enviar (erro real, não de conexão), ele fica destacado em vermelho — os pontos seguintes ficam esperando atrás dele até resolver, pra não inverter a ordem de entrada/saída

Não é preciso fazer nada manualmente — a sincronização acontece sozinha ao reconectar.

Se o app for fechado de verdade (não só minimizado) enquanto offline:

• Admin, gerente e engenheiro conseguem continuar batendo ponto normalmente mesmo depois de fechar e reabrir o app sem internet.
• Operário precisa de internet pra reabrir o app depois de fechado, mesmo que já estivesse logado antes — decisão deliberada de segurança. Enquanto o app estiver aberto e a conexão cair no meio do uso, o operário continua batendo ponto normalmente (fila offline, ver acima).

Tela Registros dentro do detalhe da obra (admin/gerente/engenheiro/estagiário). Três tabelas:

• Pendentes de Validação — todo registro de funcionário MOD passa por aqui; só o lançamento manual de admin/gerente (seção 10.2) e os registros de funcionário MOI (seção 5.2) já entram validados. Cada linha mostra o Motivo, com frases como "rosto não confere com a referência cadastrada (X%)", "fora do geofence (Xm)", "operário sem a função desta obra cadastrada", "saída fechada automaticamente (esqueceu de bater nessa obra antes de entrar em outra)", "horário sobreposto a um registro em outra obra", ou "Catraca Offline - Conferir Horário" (quando o evento chegou atrasado por queda de conexão do agente da catraca). Dois botões: Validar ou Recusar
• Registros Validados — já confirmados, contam como trabalhado (se o fornecedor tiver OS aprovada — ver coluna OS abaixo). Mostra quem aprovou/recusou e quando — e, se a aprovação veio do Diário de Obra com observação, o texto dela. Cada um tem um botão Excluir, pra corrigir um ponto que foi registrado errado — ele fica marcado como reprovado (não conta mais como trabalhado), mas continua no histórico pra auditoria, nunca é apagado de verdade
• Reprovados (renomeado de "Descartados", 2026-09) — recusados/excluídos, mantidos só para histórico/auditoria. Botão Restaurar pra desfazer um "Recusar/Excluir" feito por engano — o registro volta sozinho pra Pendentes ou Validados

Coluna "OS" em cada linha: badge "Com OS" (fornecedor com contrato aprovado — conta no homem-dia) ou "Sem OS" (fornecedor sem contrato aprovado ainda — o ponto fica registrado mas não conta, linha destacada em vermelho). O badge "Própria" só aparece em fornecedor "equipe própria" cadastrado antes de 2026-08-29 (seção 4).

Registros de visitante aparecem misturados na mesma lista de Registros Validados (nunca passam por Pendentes) — identificados pelo Tipo de Registro "Reconhecimento Facial – Catraca" ou "Liberação Manual".

Também é possível registrar um ponto manual direto por aqui, exportar os registros em CSV/Excel, e filtrar a lista com seleção múltipla por Tipo, Operário, Tipo de Registro, Função e Fornecedor, além do período (De/Até) — útil pra achar um registro específico numa obra com muito histórico. Clique no cabeçalho de qualquer coluna pra ordenar.

11.1 Diário de Obra — aprovar o dia inteiro de uma vez (novo, 2026-09)

Tela Diário de Obra, no detalhe da obra (admin/gerente/engenheiro/estagiário) — pensada pra quem quer decidir "esse dia está OK" sem abrir registro por registro. É só fila de aprovação, não ferramenta de análise — o histórico completo (decidido ou não) fica no Dashboard (seção 14.4).

• Só aparece dia que tem pendência — um dia 100% decidido (tudo validado ou reprovado) some da lista sozinho.
• Cada dia expande pra mostrar os fornecedores daquele dia (operários presentes/total, horas de permanência somadas, % de assiduidade); cada fornecedor expande pra mostrar os operários (primeira entrada, última saída, horas de permanência, assiduidade individual, status).
• MOD e MOI separados (2026-09-21): no cabeçalho do dia e de cada fornecedor, os números aparecem em duas linhas — MOI e MOD — e, dentro do fornecedor, os operários ficam em dois subgrupos. O subgrupo MOI mostra a etiqueta "Aprovação automática" (seção 5.2) — quem decide o dia está, na prática, decidindo o MOD.
• Botões Aprovar dia e Reprovar dia, no cabeçalho do dia — decide de uma vez todos os registros ainda pendentes daquele dia, de todos os fornecedores (estagiário só consegue aprovar, não reprovar). A decisão aparece exatamente igual na tela de Registros de Ponto (é o mesmo registro no banco, só muda como você vê).
• Observação na aprovação (2026-09-15): ao lado do botão Aprovar dia há um campo "Observação (opcional)" — ex.: "atraso justificado por chuva". O texto fica gravado junto da aprovação de todos os registros daquele dia e aparece na tela de Registros. Reprovar dia não pede observação.
• Dias já aprovados (2026-09-17): abaixo da fila, uma seção separada com De/Até e Buscar pra consultar dias que já foram totalmente aprovados (use a mesma data nos dois campos pra ver um dia só). Busca sob demanda — não carrega nada sozinha.
• Visitantes do dia aparecem como se fossem mais dois fornecedores — "Visitante Cadastrado" e "Visitante Não Cadastrado" — expansíveis pra nome/entrada/saída/permanência, sem botão de aprovação (visitante nunca precisa ser aprovado).
• "Horas de permanência" considera o refeitório interno da obra (seção 6.1): com refeitório interno, desconta 1h de almoço e a jornada prevista é 9h; sem refeitório interno, não desconta nada e a jornada prevista é 8h.

1. Relatórios → Ponto (ou pelo detalhe do funcionário)
2. Escolha o funcionário, opcionalmente a obra, e o período
3. Buscar — mostra uma linha por registro (não mais agrupado por dia), com filtros por Tipo, Obra e Tipo de Registro, e ordenação por coluna. Indicadores: ⏳ pendente de validação, ✓ aprovado pelo Engenheiro/Gestor, ⚠️ ressalva de função incompatível, "Reprovado", 📷 link de foto de evidência. Horas trabalhadas calculadas por par entrada→saída, separadas por obra
4. Exportar CSV/Excel ou Imprimir/PDF

Config → Log de Alterações — tudo que foi incluído, editado ou excluído no sistema, com quem fez e quando. Cobre inclusive comparações faciais e leituras de dado sensível. Filtrável por entidade, exportável.

14.1 Dashboard geral

Menu Dashboard. Duas visões:

• Situação Hoje — o que está acontecendo agora: obras em andamento hoje, operários presentes vs. previstos, registros pendentes de validação
• Acumulado — visão do período (ou histórico completo): obras em andamento, funcionários presentes/previstos, valor total de contratos, e o andamento geral em homem-dia, com detalhamento por fornecedor e por funcionário

Admin e gerente têm filtros extras (engenheiro, fornecedor, cliente, período). Botão BI no topo leva pro módulo de tabela dinâmica (seção 14.3). Exportar CSV e Imprimir/PDF disponíveis.

14.2 Dashboard por obra (financeiro)

No detalhe da obra: custo realizado vs. esperado por fornecedor (com o desvio percentual destacado por cor), valor de produto sempre mostrado separado (nunca misturado no cálculo de homem-dia), pendências de validação, e a tabela de andamento por fornecedor.

14.3 BI — Visualizações (Admin, Gerente, Engenheiro)

Dashboard → BI (ou /bi) — uma tabela dinâmica simplificada: escolha uma dimensão pras Linhas e outra pras Colunas (General Contractor, Obra, Fornecedor, Função, Operário, Mês ou Dia) e uma Métrica (Homem-dia, Custo em R$ ou Presenças em dias). O sistema cruza os dados automaticamente, com totais por linha, coluna e geral. Cruza só pontos já aprovados/validados. Exportar CSV/Excel disponível.

14.4 Resumo do Período — por fornecedor e operário (novo, 2026-09)

No Dashboard da obra, mesma estrutura visual do Diário de Obra (seção 11.1) — fornecedor expansível pra operário — mas pra um período, não um dia, e é ferramenta de análise: só conta registro já validado (pendente não entra).

• Abre por padrão na última semana fechada: segunda a sexta, a sábado, ou a domingo, conforme o regime de dias da obra (seção 6.1) — só considera a semana fechada a partir do dia seguinte ao fim dela (no próprio dia do fechamento, a semana ainda está em andamento).
• Filtro de data livre pra qualquer período, com botão "Última semana fechada" pra voltar ao padrão a qualquer momento.
• Por operário: dias presentes no período, horas de permanência somadas e % de assiduidade. Por fornecedor: soma de todos os operários dele.
• Dois cards de contagem de visitantes no período — Cadastrados e Não Cadastrados — separados do cálculo de fornecedor/operário.
• O card de Presença (esperados × presentes, homem-dia contratado × realizado), já existente, continua funcionando à parte, com período próprio (padrão hoje) — não foi substituído por este resumo.

Quando um admin/gerente redefine a senha de um usuário, no próximo login o sistema força a tela de troca de senha antes de liberar qualquer outra tela. Basta definir a nova senha (mínimo 6 caracteres, com confirmação).

Ícone de saída no canto superior direito da barra de navegação — pede confirmação antes de encerrar a sessão.

• Nunca compartilhe sua senha ou seu login de operário com outra pessoa
• O login por foto do operário exige uma foto ao vivo de propósito — não é possível "bater o ponto" por alguém enviando uma foto salva
• A sessão fica salva no aparelho para permitir uso offline — em celular compartilhado, sempre clique em Sair ao terminar
• Fotos, documentos e localização são dados sensíveis (LGPD) — ficam criptografados e todo acesso é registrado em log de auditoria
• Um link público de solicitação de ordem de serviço só funciona uma vez — depois de usado, quem tiver o link não consegue mais reenviar nem alterar
• Em caso de suspeita de acesso indevido, peça ao gerente ou admin para desativar/redefinir seu acesso

18.1 2026-08-26 a 2026-09-22 — MOD/MOI, General Contractor, computadores pareados e mais

• Nova classificação MOD/MOI por função (seção 5.2) — cada função é Mão de Obra Direta ou Indireta, reclassificável arrastando entre duas colunas. Ponto de MOI entra já aprovado; só MOD passa pela fila. O Diário de Obra passou a separar MOD e MOI em cada dia e fornecedor, e a lista de Equipe mostra a etiqueta ao lado da função.
• Diário de Obra: campo de observação opcional ao aprovar o dia, e nova seção "Dias já aprovados" pra consultar o histórico (seção 11.1). Estagiário ganhou os botões Registros e Diário de Obra no detalhe da obra.
• "Empresa" virou "General Contractor" na tela, e nome fantasia passou a ser obrigatório no General Contractor e no fornecedor — é o nome mostrado em todo o sistema (seções 4 e 7.1).
• Excluir General Contractor — só quando não há mais nada vinculado; a tela mostra o que impede (seção 4.1).
• Fim da "equipe própria" automática — a construtora que executa serviço é cadastrada como fornecedor normal e precisa de OS aprovada, igual a todo mundo (seção 4).
• Catraca — computadores pareados: um código de pareamento por computador, revogável individualmente, substitui o "Gerar novo código" que derrubava todos (seção 10.3).
• Catraca — transferência entre obras com um clique, ao cadastrar um número de série já ativo em outra obra; Monitor de Catracas com busca por série, ativar/desativar, status do agente (IP, versão, último erro, log) e configuração remota de IP/login/senha da catraca (seções 10.3 e 10.3.2).
• Liberação manual de visitante com entrada ou saída escolhida no botão, e notebook backup do agente assumindo sozinho se o principal cair (seção 10.3).
• O app instalado (desktop/celular) passa a procurar atualização sozinho a cada hora e ao voltar pra janela — não fica mais dias numa versão antiga.

18.2 2026-09-11 — Liberação de visitante mais rigorosa e agente com atualização automática

• Liberar visitante agora passou a exigir nome do visitante, além da justificativa que já era obrigatória — sem os dois, o sistema recusa (seção 10.3.1).
• Novo: Sentido de giro pra liberação de visitante (Editar catraca) — quando configurado, a liberação tenta travar fisicamente só o sentido escolhido (entrada ou saída), em vez de sempre destrancar os dois. Campo próprio, separado da Direção que já existia (essa continua só sobre o reconhecimento automático de funcionário/visitante cadastrado, nunca muda por causa da liberação manual). ⚠️ Ainda não confirmado no equipamento — teste na prática antes de confiar.
• Novo: agente da catraca se atualiza sozinho a partir da versão 1.0.18 — não precisa mais reinstalar manualmente a cada atualização (seção 19).
• Diário de Obra e Registros de Ponto agora mostram o nome informado do visitante não cadastrado, em vez de "Visitante" genérico.

18.3 2026-09-03 a 2026-09-04 — Diário de Obra, Resumo do Período e renomeações

• "Descartados" virou "Reprovados" e "Empreiteiro"/"Fornecedor/Empreiteiro" virou "Fornecedor" em todo o sistema — mudança só de nome na tela, nada de comportamento muda.
• Novo: Obra possui refeitório interno (cadastro/edição de obra, seção 6.1) — decide se o cálculo de horas desconta 1h de almoço (jornada prevista 9h) ou não desconta nada (jornada prevista 8h).
• Novo: Diário de Obra (seção 11.1) — fila de aprovação por dia, com fornecedor e operário expansíveis, só mostrando dia com pendência. Aprova/reprova o dia inteiro de uma vez, com os mesmos botões que já existiam na tela de Registros. Visitante cadastrado/não cadastrado aparece como informativo, sem precisar de aprovação.
• Novo: Resumo do Período no Dashboard (seção 14.4) — mesmo formato do Diário de Obra, mas por período (padrão: última semana fechada) e só com registro já validado — é análise, não aprovação. Cards de contagem de visitante cadastrado/não cadastrado no período.

18.4 2026-08-06 a 2026-08-11 — "Função" substitui "Disciplina" e mais

A maior mudança desde o lançamento. Resumo do que muda no dia a dia:

• "Disciplina" não existe mais — agora é "Função". Cada funcionário tem uma função (não mais várias), escolhida no cadastro (seção 9.1). Obra e fornecedor não têm mais disciplina/função cadastrada — sumiu do cadastro de obra (seção 6.1) e do cadastro de fornecedor (seção 7.1).
• Bater ponto ficou mais permissivo: qualquer funcionário bate ponto em qualquer obra da mesma construtora, sempre aceito. O que pode faltar é o fornecedor ter OS aprovada — nesse caso o ponto é salvo como "Sem OS", e passa a contar sozinho assim que a OS for aprovada (seção 9.2).
• Ordem de serviço virou um contrato único por fornecedor (um valor, um prazo, um efetivo) — não mais dividida por disciplina (seção 8).
• Todo ponto passa por validação do gerente/engenheiro agora, exceto lançamento manual de admin/gerente — antes, autoatendimento e ponto assistido eram aprovados automaticamente quando rosto e localização conferiam (seção 10).
• Telas de Registros de Ponto e Relatório de Ponto redesenhadas — tabelas com filtro de múltipla seleção, ordenação por coluna, coluna "OS", coluna "Motivo" e indicação de quem validou (seções 11 e 12). Visitante aparece junto com o ponto na mesma tela.
• Andamento da obra reorganizado por fornecedor (não mais disciplina), virou tela só de leitura — mudar o previsto passou a ser só via ordem de serviço (seção 6.3).
• Novo módulo de BI (tabela dinâmica simplificada, seção 14.3) e novo Monitor de Catracas (admin, seção 10.3.2).
• Catraca: direção fixa por leitor (antifraude), liberação manual de visitante passou a exigir justificativa, sincronização de funcionário passou a cobrir todas as catracas da empresa (não só onde ele tem histórico) (seção 10.3).
• Regime de dias da obra ganhou "Segunda a sexta"; hora extra da obra passou a ser calculada automaticamente a partir do horário padrão (seção 6.1). Regime de trabalho do funcionário ganhou a opção Estagiário (seção 9.1).

18.5 2026-07-31

• Alocação automática mais cedo — antes, o vínculo do funcionário com a obra (e o envio pra catraca) só nascia quando ele batia o primeiro ponto. Agora também acontece ao cadastrar/editar o funcionário e ao aprovar uma ordem de serviço, sem esperar ninguém bater ponto (seção 9.2). Equipe própria também passou a dispensar a exigência de OS aprovada.
• Marcar todas as disciplinas de uma vez no cadastro de funcionário (seção 9.1).
• Busca de fornecedor por nome no primeiro acesso do operário, além do CNPJ — e aviso claro quando o cadastro fica sem disciplina definida (seção 3.3).
• Editar e excluir uma catraca cadastrada, e status de conexão (Online/Offline/Nunca conectada) que agora reflete a realidade — antes uma catraca desconectada podia continuar aparecendo "Online" pra sempre (seção 10.3).
• Liberação manual da catraca (visitante) nos dois sentidos — antes só liberava um sentido de giro.
• Exportar CSV/Excel, filtrar por operário/data e excluir um ponto já validado por engano, direto na tela Registros da obra (seção 11).
• Visualizador de PDF na revisão de OS maior e sem painel de miniaturas atrapalhando (seção 8.2).

18.6 2026-07-29 e 2026-07-30

• Editar, encerrar ou cancelar uma OS já aprovada — antes, um erro numa ordem de serviço aprovada só dava pra corrigir por fora do sistema. Agora tem três botões na própria tela de revisão (seção 8.4).
• Primeiro acesso do operário por CPF, RG ou CNH — antes só CPF encontrava um cadastro feito pelo gerente; agora qualquer um dos três documentos funciona, e o sistema decide sozinho pra qual tela ir, sem perguntar "já fui cadastrado?" (seção 3.3).
• Visitante de obra na catraca física — cadastro leve com foto, ou liberação manual imediata pra visita não planejada, sem travar o acesso de quem não é funcionário (seção 10.3.1).
• Domínio próprio — o sistema passou a responder também em app.laborcontrol.com.br, além do endereço antigo (laborcontrol.web.app, que continua funcionando).
• Identidade visual unificada — a logo (ícone + cores) ficou igual em todo lugar: app, site, guias e apresentação.

18.7 2026-07-27

• Papel "Gestor" virou "Gerente" — mesmo papel, só o nome mostrado na tela mudou.
• Novo papel: Estagiário — cadastra/edita a equipe (funcionários terceirizados) e lança ordens de serviço, mas nunca aprova/rejeita nada nem mexe em configuração de obra. Admin e gerente podem criar um estagiário; gerente também passou a poder criar outro gerente, além de engenheiro.
• Cliente pode ser pessoa física — antes só CNPJ, agora dá pra cadastrar o contratante com CPF (com a mesma leitura automática por foto de documento que já existia pra CNPJ), e buscar um cliente já cadastrado pelo nome, sem precisar saber o CPF/CNPJ de cor.
• CEP da obra agora aparece no cabeçalho, junto do endereço.
• Ordem de serviço em Word (.docx) passou a ter leitura automática por IA de verdade — antes o upload aceitava o arquivo, mas não extraía nada dele.
• Incluir/excluir disciplina na revisão de uma OS — antes, se a IA lesse uma disciplina que não devia entrar (ou faltasse mapear uma pro catálogo da obra), não tinha jeito de corrigir e a aprovação ficava travada. Agora dá pra excluir uma linha ou incluir uma nova direto na tela de revisão.
• Datas de início/fim previstas, extraídas de documentos de OS — quando o documento tem uma data de calendário explícita (não só uma duração em dias), ela agora é lida e preenchida automaticamente na revisão.
• Pré-visualização de arquivo Word na revisão de OS — antes só PDF tinha essa prévia; agora o conteúdo do Word também aparece na tela, sem precisar baixar o arquivo.
• App de desktop para Windows — ver seção 19.

18.8 2026-07-19 a 2026-07-22

• "Tipos de obra" virou "Disciplinas" — mesmo conceito (Elétrica, Hidráulica etc.), agora com nome mais claro e a possibilidade de criar uma disciplina nova direto do cadastro de obra ou fornecedor, sem precisar ir em Configurações antes.
• "Proposta" virou "Ordem de Serviço", e agora uma única ordem de serviço pode cobrir várias disciplinas ao mesmo tempo, cada uma com seu próprio valor, prazo e efetivo.
• Fim da alocação manual de funcionário em obra. Você não "aloca" mais ninguém — a partir do momento em que a disciplina, o fornecedor e a ordem de serviço aprovada se encontram, o funcionário já pode bater ponto ali, e o sistema resolve isso sozinho na hora.
• Link público para o fornecedor enviar a ordem de serviço — copie ou envie por e-mail direto da tela da obra; o fornecedor preenche sem precisar de login.
• "Equipe própria" — toda empresa ganha automaticamente um fornecedor com o próprio nome, pra representar funcionário direto da construtora (em vez de só terceirizado), já habilitado em todas as disciplinas do catálogo.
• Gerente pode ser responsável técnico de uma obra, além de engenheiro — o campo agora é uma busca por nome, não uma lista simples, pra facilitar quando há muitos cadastrados.
• Dashboards por disciplina, fornecedor e funcionário — não importa mais qual profissional específico bateu a diária, o acompanhamento é pela disciplina e pelo fornecedor.
• Integração com catraca física (Control iD) — obras de maior movimento podem usar uma catraca com reconhecimento facial embarcado, sincronizada automaticamente com o cadastro do app.
• Log de Alterações (admin) — tela nova mostrando tudo que foi incluído, editado ou excluído no sistema.

Além de acessar pelo navegador, o LaborControl tem um app de desktop pra Windows — uma janela própria do sistema, sem precisar abrir o navegador nem lembrar do link.

1. Acesse a página de downloads (pergunte ao administrador do sistema o link atual)
2. Baixe LaborControl-Setup (app principal) e/ou AgenteDeCatraca-LaborControl-Setup (só necessário pra quem gerencia a integração com catracas físicas — seção 10.3)
3. Rode o instalador baixado e siga o assistente — não precisa de permissão de administrador do Windows
4. O app abre como uma janela normal, com o mesmo login e as mesmas telas da versão web

Em caso de dúvidas ou problemas, entre em contato com o administrador do sistema.