Eventos de Localização
Como a localização dos técnicos é capturada por eventos (e não em tempo real contínuo), o LuariX OS guarda o histórico de cada ação: qual evento o técnico executou, em qual horário e com qual posição registrada naquele momento.
Esta tela é a trilha auditável da localização — complementa o mapa (que mostra apenas a última posição) com o passado: todas as posições que cada técnico registrou, em ordem cronológica.
Para quem é
- Super Administrador — vê os eventos de todos os técnicos (com filtro por prestadora);
- Prestadora — vê apenas os eventos dos próprios técnicos (nunca de outra prestadora);
- Técnico — não acessa; ele é a origem da localização.
O que é um "evento de localização"
Cada vez que uma posição é registrada, ela vem acompanhada de um evento que explica o porquê:
| Evento | Quando acontece |
|---|---|
| Login | O técnico entrou no sistema web |
Abrir OS (open_order) |
O técnico abriu uma OS no painel |
Iniciar OS (start_order) |
O técnico iniciou a execução de uma OS |
Finalizar OS (finish_order) |
O técnico concluiu a execução de uma OS |
| Manual | O técnico enviou a localização manualmente (web ou 📍 Atualizar localização no Telegram) |
Ação no Telegram (telegram_action) |
O técnico tocou em qualquer botão do bot (aceitar, listar, concluir…) — a última posição conhecida é registrada como ação |
| Live start / update | O técnico ativou o live location (1h/4h/8h) e as atualizações em background consentiidas |
Cada evento também registra a fonte da posição: web (painel), telegram (bot) ou system (automática).
Eventos de Localização: técnico, evento, horário, fonte, coordenadas e OS associada.
A tela
Indicadores (cards no topo)
Resumo do período: total de eventos, e os totais por tipo de ação (web, Telegram, automática) — para ver de onde vem a localização da operação.
A lista de eventos
Cada linha mostra:
- Técnico — nome (terceirizado ou interno);
- Evento — badge com o tipo (Iniciou OS, Ação no Telegram, Login…);
- Horário — quando a posição foi capturada (
captured_at); - Fonte — badge Web / Telegram / Sistema;
- Coordenadas — latitude e longitude da posição;
- Precisão — a acurácia do GPS (quando disponível);
- OS associada — se o evento ocorreu no contexto de uma OS (protocolo clicável).
Filtros
| Filtro | Quem vê | O que faz |
|---|---|---|
| Prestadora | Só Super Administrador | Filtra os eventos de uma prestadora |
| Técnico | Todos | Filtra por técnico (terceirizado ou interno) |
| Evento | Todos | Filtra pelo tipo de evento (login, abrir/iniciar/finalizar OS, manual, Telegram, live…) |
| Fonte | Todos | Filtra por Web / Telegram / Sistema |
| Período | Todos | Limita pelo horário da captura |
Assim como no mapa e na auditoria, os filtros ficam salvos ao sair e voltar — e a lista carrega uma página de cada vez, leve mesmo com meses de histórico.
Como usar na prática
- "Onde o técnico estava quando concluiu a OS?" → filtre por Finalizar OS + período e veja as coordenadas do evento.
- "O técnico está realmente se movimentando?" → filtre por um técnico e veja a sequência de horários e posições ao longo do dia.
- "Estamos recebendo posições?" → o card de total por fonte mostra se a operação depende do Telegram, do web ou está sem eventos.