Manual de Gestão Técnica
Guia prático para o trabalho técnico de campo: o aplicativo do técnico (ordens, relatórios, inventário, avisos e localização sem conexão), o despacho e a revisão na web, e o diagnóstico dos problemas mais comuns.
1O que é o FieldOps e quem usa
O FieldOps organiza o trabalho técnico do ISP: o despachante cria e atribui ordens na web, o técnico as executa com o aplicativo móvel e o supervisor revisa relatórios, inventário e métricas. Tudo fica registrado com histórico: quem fez o quê, quando e por qual motivo.
| Perfil | Ferramenta | O que faz |
|---|---|---|
| Técnico | Aplicativo Android (APK da PlenoAgent) | Ver suas ordens, navegar até o local, registrar chegada e início, completar checklist e relatório, fotografar evidências, movimentar inventário e pedir ajuda ao assistente. |
| Despachante | Módulo FieldOps na web | Criar e atribuir ordens, ver calendário e mapa, revisar e devolver relatórios, ativar serviços, gerenciar turnos, ausências, habilidades, SLA e alertas. |
| Supervisor | Módulo FieldOps na web | Revisar relatórios, conciliar inventário e mudanças de rede, consultar indicadores e resolver conflitos. |
O aplicativo, a web e o assistente usam os mesmos serviços. Um relatório concluído no telefone e um ditado ao assistente passam pelas mesmas validações e deixam o mesmo histórico.
2Instalar o aplicativo e entrar
Na web, abra Gestão Técnica e entre na aba Móvel: lá está a versão publicada do aplicativo com seu tamanho, o hash SHA-256 e o Android mínimo exigido. Baixe o APK com Baixar. Se a sua empresa verifica hashes, compare o SHA-256 do arquivo com o mostrado na tela.
Instale o APK. Se o Android pedir para permitir instalar desta fonte, ative apenas para esta instalação e desative depois.
Abra o aplicativo e informe o endereço do servidor da sua empresa, seu usuário e sua senha.
Quando o aplicativo pedir permissões de localização, câmera e notificações, aceite: sem localização não há acompanhamento de turno, sem câmera não há evidências e sem notificações você não recebe os avisos de ordens atribuídas ou devolvidas. O porquê de cada permissão é explicado na tela antes de pedir.
Ao entrar, você verá suas abas: Trabalho (suas ordens), Inventário (seu material e equipamentos), Avisos (atribuições, mudanças de horário e relatórios devolvidos), Sincronização (estado da sua fila local) e Assistente (ajuda com seus dados).
Sair apaga do telefone as ordens baixadas, os rascunhos, a fila pendente, as fotos não enviadas e a chave local. Sincronize antes de sair ou de trocar de aparelho, ou esse trabalho será perdido.
3A jornada do técnico, passo a passo
Inicie seu turno ao começar o dia. O acompanhamento de localização só funciona dentro de um turno ativo e para quando você o encerra.
Abra a ordem: você verá cliente, contato autorizado, endereço, coordenadas, janela de visita, NAP/porta ou AP/setor e os equipamentos disponíveis. Se um dado diz desconhecido, ninguém o confirmou; se diz desatualizado, passou mais de 30 dias sem confirmação.
Toque em Como chegar para navegar com o mapa do telefone e registre A caminho, Chegada e Início com seus botões. A chegada é confirmada manualmente: o GPS é aproximado e nenhuma geocerca muda o estado por você.
Se precisar interromper o trabalho, use Pausar escrevendo o motivo (é obrigatório) e retome depois com seu botão. As pausas descontam do tempo de SLA, por isso o motivo fica sempre registrado.
Complete o checklist, as medições, os materiais e as fotos. Você pode salvar um rascunho a qualquer momento, mesmo sem internet.
Envie o relatório quando estiver completo. O servidor verifica requisitos, fotos verificadas e versão da ordem: se faltar algo, ele diz exatamente o quê.
Se o supervisor devolver o relatório, corrija o solicitado e envie de novo: a revisão anterior é conservada, nada é apagado.
| Estado | Significado |
|---|---|
| Atribuída | Tem responsável. O técnico ainda não atuou nela. |
| A caminho / No local / Em andamento | Viagem, chegada confirmada e trabalho em curso. |
| Pausada | Trabalho interrompido com motivo obrigatório. As pausas descontam do SLA. |
| Em revisão | Relatório enviado, aguardando o supervisor. |
| Concluída | Relatório aprovado. Só então o serviço pode ser ativado. |
| Falhada / Cancelada | Não pôde ser concluída ou foi cancelada, sempre com motivo registrado. |
Concluir um relatório nunca ativa nem fatura o serviço por si só. A ativação é solicitada pelo supervisor como ação explícita e fica registrada com seu resultado.
4Trabalhar sem conexão, e avisos
4.1A fila local
O aplicativo baixa suas ordens para trabalhar sem internet e guarda cada mudança em uma fila no telefone que sobrevive a reinícios. Ao recuperar o sinal, a fila sincroniza operação por operação. A aba Sincronização mostra quantas operações seguem guardadas apenas no telefone.
| Estado | Significado | O que fazer |
|---|---|---|
| Local | Salvo apenas no telefone. | Nada: será sincronizado sozinho. |
| Pendente | Na fila aguardando rede. | Recupere a cobertura e abra o aplicativo. |
| Sincronizado | Confirmado pelo servidor. | Nada. |
| Conflito | Algo mudou no servidor (reatribuição, outro técnico consumiu o equipamento, porta ocupada). | Leia o motivo, conserve seu rascunho e coordene com o despacho. Nada é sobrescrito sozinho. |
| Rejeitado | Sem permissão ou dados inválidos. | Corrija e tente de novo, ou peça ajuda. |
Os dados baixados vencem em 72 horas e as fotos pendentes são conservadas até verificação no servidor. Uma foto nunca é apagada do telefone antes de confirmação acima.
4.2Avisos: o que o aplicativo avisa
A aba Avisos notifica o que muda em suas ordens ao sincronizar: ordem atribuída, horário modificado e relatório devolvido. Cada aviso indica a ordem e seu motivo; com Marcar tudo como lido você limpa a lista. Os avisos chegam ao sincronizar, por isso abra o aplicativo com internet ao começar o dia para não trabalhar com informação antiga.
5Relatório: checklist, fotos e envio
Cada tipo de trabalho tem seu modelo: uma instalação de fibra pede potência óptica, serial, NAP/porta e ONU; uma de rádio pede sinal, AP e CPE. O aplicativo só exige o do seu modelo.
- Fotos: cada foto fica vinculada à ordem escolhida antes de disparar. Revise o requisito que ela cobre: o envio é bloqueado se faltar uma foto obrigatória ou se alguma não terminou de verificar.
- Confirmação do cliente: se o modelo exigir, registre Confirmada, Ausente ou Recusada com nome ou motivo. É uma confirmação operacional, não uma assinatura digital certificada.
- Envio: o botão de envio valida tudo junto. Se algo falhar, o aplicativo lista cada campo pendente para você completar e tentar de novo.
6Inventário em campo
Consulte seu material e equipamento sob custódia em Inventário. Para registrar um serial ou MAC, use o leitor de QR ou digite à mão: o aplicativo mostra para você confirmar duas vezes antes de aceitar.
Reservar separa uma unidade para sua ordem.
Entregar e Instalar a vinculam ao serviço; Devolver e Retirar a devolvem à custódia.
Substituir troca um equipamento instalado por outro dentro da mesma ordem; Inspecionar registra a revisão do equipamento sem movê-lo.
Consumir desconta materiais (cabo, conectores) com sua unidade de medida.
Se dois técnicos tentarem o mesmo serial ou porta, só o primeiro consegue; o segundo vê um conflito claro. Os conflitos de equipamento e porta nunca se resolvem como "o último que escreve vence": ficam pendentes até o despacho resolvê-los.
7Localização durante o turno
O mapa do despacho mostra sua última posição com sua idade e precisão. O estado de localização é independente do estado da ordem.
| Estado | Significado |
|---|---|
| Atual | Ponto de há menos de 2 minutos. |
| Desatualizada | Entre 2 e 10 minutos. Revise cobertura e economia de bateria. |
| Sem conexão / Permissão negada / Fora de turno | Sem pontos recentes, sem permissão ou sem turno ativo. |
Se o mapa parar de ver você, verifique nesta ordem: turno ativo, permissão de localização em Sempre ou Durante o uso mais segundo plano, economia de bateria desativada para o aplicativo e cobertura de dados.
No painel do módulo, o despachante vê o mapa com a última posição de cada técnico e pode abrir o trajeto do dia para revisar por onde passou. A empresa configura por quantos dias a localização é conservada (30 por padrão); vencido esse prazo, os pontos antigos são eliminados.
8O assistente: aplicativo e WhatsApp
8.1Ajuda dentro do aplicativo
A aba Assistente responde com seus dados autorizados ("para qual NAP vai minha próxima instalação?", "qual ONU tenho disponível?") e ajuda a montar o rascunho perguntando cada dado faltante e confirmando a ordem antes de salvar. Toda tentativa fora da sua permissão é rejeitada. O assistente precisa de internet: sem conexão, use os formulários, que funcionam igual.
8.2Falar pelo WhatsApp: como se configura
Os técnicos também podem usar o assistente pelo WhatsApp. A configuração está na web, na aba Agente do módulo:
Escolha os técnicos autorizados: só eles poderão falar com o assistente.
Escolha o modelo de IA e o modelo de transcrição (para as mensagens de voz).
Conecte o número de WhatsApp de duas formas: reutilizando uma sessão da empresa já conectada, ou escaneando um novo QR com o telefone que levará o número.
Revise o estado do agente: conectado, conectando ou desconectado. Se desconectar, volte à aba e gere um novo QR.
Se o assistente estiver indisponível (sem modelo, sem créditos ou sem WhatsApp), os formulários, a sincronização e as fotos seguem funcionando igual. O aplicativo não depende da IA para o essencial.
9Despacho e revisão na web
9.1Fila, calendário e atribuição
A fila mostra ordens sem atribuir com filtros por zona, prioridade, estado e vencimento. Ao atribuir, o sistema verifica turno, ausências, habilidades e sobreposições: se houver incompatibilidade, a atribuição para e mostra cada motivo. Você pode escolher outro responsável ou forçá-la com motivo, que fica registrado.
9.2Sugestões, SLA e alertas
Para cada ordem você pode pedir sugestões ordenadas com suas razões (disponível, habilidades, proximidade, carga). Os SLA por tipo e prioridade medem resposta, chegada e resolução no horário comercial da empresa, descontando pausas; as extensões levam motivo auditado. Os alertas avisam uma única vez por atraso, ordem sem aceite, falta de localização ou relatório devolvido, e se resolvem sozinhos quando a causa desaparece. O painel principal resume as métricas de tempo do dia (resposta, chegada e resolução) por técnico e equipe.
9.3Revisão, ativação e recorrência
Em Relatórios você aprova ou devolve com motivo; cada correção cria uma revisão nova sem apagar a anterior. A ativação do serviço é um botão explícito após a aprovação. A manutenção recorrente gera ordens automaticamente (diárias, semanais ou mensais) para serviços ou pontos de rede como NAPs, OLTs e roteadores.
10Diagnóstico e suporte
- Minhas ordens não aparecem
- Abra Sincronização e sincronize. Se acabou de reinstalar ou sair, entre de novo: o cache local foi apagado.
- Uma operação ficou em conflito
- Leia o código e o detalhe no cartão de sincronização. Não tente de novo às cegas: se outro técnico pegou o equipamento ou a porta, coordene com o despacho.
- O mapa não me mostra atualizado
- Confirme turno ativo, permissão de localização, bateria sem restrição e cobertura. Sem sinal não há pontos: o mapa mostra como desatualizado em vez de inventar sua posição.
- A câmera ou o QR não respondem
- Revise a permissão de câmera do sistema e reabra o detalhe da ordem. Você sempre pode digitar o serial à mão com dupla confirmação.
- O envio de uma foto não avança
- Mantenha o aplicativo aberto com rede. A foto é conservada no telefone e a fila retoma de onde parou.
- O assistente não responde
- Use os formulários: o essencial não precisa de IA. Avise o suporte com a hora e a mensagem de erro.
- Não recebo avisos de ordens novas
- Revise a permissão de notificações do sistema e abra o aplicativo com internet: os avisos chegam ao sincronizar. Se a ordem tampouco aparece em Trabalho, sincronize manualmente em Sincronização.
Versão do aplicativo (visível no app), seu usuário, número da ordem, hora aproximada do problema, captura do estado de sincronização e se você estava com dados, Wi-Fi ou sem rede.