Manual do Usuário
Bem-vindo à Wiki do Rota+. Aqui você encontrará guias detalhados sobre todas as funcionalidades do sistema.
Atualizações Implementadas
Sistema de Atualização Automática
O Rota+ agora verifica automaticamente se há novas versões disponíveis:
- Verificação Automática: O sistema verifica a cada 5 minutos se há uma nova versão disponível.
- Notificação Inteligente: Quando uma atualização é detectada, você será notificado com um popup informativo.
- Atualização Simples: Basta aceitar a atualização e a página será recarregada automaticamente com a nova versão.
- Sem Interrupções: O sistema garante que você não perca dados durante o processo de atualização.
Modo Local com IndexedDB
Para contornar limitações de quota do Firebase, implementamos armazenamento local:
- Armazenamento Local: Todos os dados de clientes são salvos localmente no navegador usando IndexedDB.
- Performance Melhorada: Operações de leitura e escrita são mais rápidas sem depender da internet.
- Sem Limites de Quota: Não há mais preocupação com limites do Firebase para dados de mapa.
- Indicador Visual: Um popup informa que o sistema está operando em "Modo Local".
Sincronização Firebase (Upload/Download)
Sincronize seus dados locais com o Firebase quando necessário:
- Upload Manual: Botão "Enviar para Firebase" permite fazer backup dos dados locais na nuvem.
- Download Manual: Botão "Baixar do Firebase" restaura dados da nuvem para o armazenamento local.
- Barra de Progresso: Acompanhe o progresso da sincronização em tempo real.
- Controle Total: Você decide quando sincronizar, evitando uso desnecessário de quota.
Geocodificação Filtrada por VLAN
Otimização do processo de geocodificação:
- Processamento Inteligente: Apenas clientes com VLAN configurada são geocodificados.
- Economia de Recursos: Reduz o uso da API de geocodificação e melhora a performance.
- Dados Mais Precisos: Foca nos clientes que realmente precisam de localização geográfica.
Melhorias na Interface N1
Visualização aprimorada do quadro Kanban:
- Cards Coloridos por Status: Cada status tem uma cor distinta para facilitar identificação visual.
- Animação de Pulso: Cards "Sem Atendimento" pulsam para chamar atenção.
- Modo Claro/Escuro: Cores otimizadas para ambos os modos de visualização.
- Badge "ROTA UP": Rotas resolvidas agora exibem corretamente o status "ROTA UP" em verde.
Correções Importantes
- Botão Resolver Restaurado: O botão "Resolver" foi restaurado na seção Atividades N2.
- Seleção de Cidade Mobile: Corrigido problema de seleção de cidade na versão mobile.
- Layout Mobile: Removido espaçamento excessivo entre menu e conteúdo.
- Upload XLSX: Corrigida funcionalidade de upload de arquivos Excel no mapa.
- Logout Mobile: Botão de logout agora funciona corretamente em dispositivos móveis.
- Salvamento de VLAN: Corrigido problema onde VLAN não era salva ao clicar em OK no popup.
Dashboard Interativo
- Cards Clicáveis: Cards do dashboard agora são clicáveis e navegam para suas respectivas seções.
- Logo Clicável: O logo "Rota+" agora funciona como link para retornar ao dashboard.
- Navegação Intuitiva: Melhora significativa na experiência de navegação do sistema.
💡 Dica Importante: Sempre mantenha seu navegador atualizado e aceite as atualizações do sistema quando notificado. As novas versões trazem melhorias de performance, correções de bugs e novos recursos!
OLT
É o equipamento principal na central do provedor que envia internet para as casas.
PON
É a porta ou "plugue" na OLT onde vários clientes são conectados através da fibra.
N1 (Nível 1)
Equipe de atendimento inicial que recebe as ligações e tenta resolver problemas básicos.
N2 (Nível 2)
Equipe técnica mais avançada para analisar problemas complexos que o N1 não resolveu.
dBm (Sinal)
Unidade de medida da força do sinal de luz na fibra. Quanto mais próximo do ideal, melhor.
Login e Acesso
Para acessar o sistema, utilize o e-mail e a senha fornecidos pelo administrador. Na primeira vez, é recomendável trocar sua senha. O sistema mantém você conectado para facilitar o acesso rápido.
Interface Principal
A interface é dividida em duas partes: o menu de navegação à esquerda, com todas as seções do sistema, e a área de conteúdo principal à direita, onde as informações são exibidas.
Visão Geral
O Dashboard é a central de controle do Rota+. Ele oferece uma visão em tempo real da saúde da rede e das operações.
Cards de Métricas
- Rotas Paradas Ativas: Contagem total de incidentes pendentes ou em andamento.
- Clientes em Migração: Total de clientes aguardando conclusão de migração.
- PONs Críticas: Monitoramento de portas PON com níveis de sinal fora do padrão. Clique no card para ver detalhes.
- Última Atualização: Hora da última sincronização de dados.
Visualização dos Cards de Métricas
Interface do Dashboard mostrando os cards de métricas principais
Assistente Proativo (IA)
O sistema utiliza inteligência para analisar padrões e sugerir ações preventivas ou identificar anomalias na operação.
Mapa de Calor de Riscos
Visualização gráfica que destaca áreas (bairros/regiões) com maior incidência de falhas recentes, permitindo ações proativas.
Gráficos e Análises
Visualizações gráficas e tabelas de dados do Dashboard
Demonstração em Vídeo
Assista à demonstração completa do Dashboard em ação:
Vídeo mostrando a navegação e interação com os elementos do Dashboard
Fila de Atividades N2
Painel dedicado para operadores N2 monitorarem e tratarem chamados que escalaram do N1.
Sistema de Alertas Gerais
Ferramenta crítica para comunicação em massa com todos os usuários do sistema.
- Novo Alerta: Use o botão "Enviar Alerta Geral" para exibir um banner no topo de todas as telas (ex: "Manutenção Massiva").
- Histórico: O botão "Histórico de Alertas" permite auditar todas as comunicações passadas, quem enviou e quando.
Instalação via Play Store (Recomendado)
A forma mais fácil de instalar é pela loja oficial do Android:
- Abra o aplicativo "Play Store" no seu celular.
- Na busca, pesquise por "Rota+ Técnico".
- Clique em "Instalar" para baixar o aplicativo oficial.
Configuração Inicial Obrigatória
No primeiro acesso pelo celular, um assistente de configuração (wizard) irá guiá-lo em 4 passos essenciais, caso ainda não tenha permitido:
- Ativar Notificações: Permita para receber alertas de novas rotas em tempo real.
- Ativar Localização (GPS): Necessário para registrar a localização do início dos atendimentos.
- Ativar Microfone: Permite que você grave relatos em áudio.
- Conclusão: Após todas as permissões, o acesso é liberado.
Notificações em Tempo Real
O sistema envia notificações instantâneas para os técnicos sobre novas rotas. Fique atento:
- As notificações funcionam mesmo que o aplicativo esteja fechado ou a tela bloqueada.
- As notificações foram aprimoradas para incluir um som de alerta customizado e um padrão de vibração para garantir que nenhum chamado seja perdido.
Utilizando o App no Dia a Dia
- Visualizar Rotas: A tela principal exibe todas as rotas ativas (Pendentes ou Em Andamento) para as suas cidades.
- Iniciar Atendimento: Em uma rota "Pendente", clique em "Iniciar". O sistema registrará a hora e sua localização atual, e o status da rota mudará para "Em Andamento".
- Registrar Resolução: Em uma rota "Em Andamento", clique em "Resolver". Uma tela se abrirá para que você possa digitar o relato ou, de forma mais prática, gravar um áudio explicando a solução.
Como Cadastrar uma Nova Rota
- Vá para a seção "Rota Parada".
- Clique no botão "+ Nova Rota Parada".
- Preencha todas as informações: Cidade, Bairro, Rua, detalhes do equipamento (OLT, Placa, PON) e a Hora da Queda.
- Clique em "Salvar". A rota será criada com o status "Pendente".
Dica de Ouro: Assim que você salva, o sistema converte automaticamente o endereço (rua, bairro, cidade) em coordenadas GPS. Isso é fundamental para os relatórios de campo!
Visualização da Lista de Rotas
Tela principal mostrando a lista de rotas paradas ativas
Formulário de Nova Rota
Modal de cadastro com todos os campos necessários para criar uma nova rota
Demonstração Completa
Veja o processo completo de cadastro de uma nova rota:
Vídeo demonstrando o fluxo completo de criação de rotas paradas
Ferramentas Administrativas
O menu "Gestão" agrupa ferramentas essenciais para a manutenção da base de dados e operações especiais.
1. Ruas sem Atendimento
Cadastro de logradouros que por algum motivo técnico ou comercial não podem receber instalações. Importante para o N1/Vendas consultar antes de ofertar planos.
2. Clientes em Migração
Controle do fluxo de migração de clientes (ex: rádio para fibra). Acompanhe o status: Pendente, Agendado e Concluído. Gráficos de progresso estão disponíveis no Dashboard.
3. PONs Irregulares
Monitoramento de portas PON com sinal degradado (ex: atenuação alta). Registre a leitura de potência (dBm) para gerar histórico e agendar manutenções preventivas.
4. Referência PON
Base de conhecimento que vincula Ruas a PONs específicas, facilitando o diagnóstico de falhas massivas baseadas em localização.
Relatório Técnico e Auditoria de Campo
Esta seção é focada em analisar a performance e as atividades dos técnicos em campo, usando dados precisos de geolocalização.
- Distância da Rota: Esta coluna exibe a distância em linha reta entre as coordenadas GPS do endereço cadastrado da rota e as coordenadas GPS do técnico no exato momento em que ele clicou em "Iniciar" no aplicativo.
- Como Funciona:
- Ao cadastrar uma nova rota, nosso sistema no servidor converte o endereço em coordenadas GPS e as salva.
- Quando o técnico inicia o atendimento, o app captura a localização dele.
- O relatório então compara as duas localizações para calcular a distância.
- Badge de Suspeita (≤150 m): Se a distância calculada for de 150 metros ou menos, o sistema exibe uma badge vermelha de "Suspeita". Isso ajuda a identificar rapidamente atendimentos que foram iniciados muito próximos ao local da falha, o que pode ser um indicador de eficiência ou um ponto para análise.
Central de Inteligência
O menu "Relatórios" oferece visões analíticas profundas sobre a operação.
1. Relatório Geral
Visão macrostática da operação com filtros poderosos (Data, Cidade, Bairro):
- TMR (Tempo Médio de Resolução): Métricas de eficiência em horas.
- Gráficos: Incidentes por Cidade, Bairro e Causas de Falha.
- Falhas de Infra: Análise de incidentes agrupados por OLT e Placa.
- Exportação: Exporte os dados filtrados para Excel para análises externas.
2. Relatório Técnico
Focado em auditoria de campo e geolocalização.
3. Histórico de Ações
Log de auditoria completo do sistema. Rastreie quem criou, editou ou resolveu rotas, garantindo total transparência e segurança.
Filtros de Relatório
Interface de filtros para personalizar relatórios
Gráficos e Análise IA
Visualizações gráficas e análise inteligente dos dados
Demonstração de Relatórios
Veja como gerar e analisar relatórios:
Vídeo demonstrando o sistema de relatórios e análise de dados
Gerenciar Usuários
Na seção "Gerenciar Usuários", administradores podem:
- Criar novos usuários: Defina o nome, e-mail, senha inicial e a permissão (Admin, Usuário, Técnico ou Visualização).
- Entender o perfil 'Visualização': Este é um perfil de acesso somente leitura. Usuários com essa permissão podem ver as telas de Dashboard, Rota Parada e Ruas sem Atendimento, mas não podem criar, editar ou excluir nenhum registro.
- Associar Técnicos a Cidades: Ao criar ou editar um usuário "Técnico", você pode selecionar uma ou mais cidades de atuação para ele.
- Redefinir Senhas: Clique no ícone de chave () para enviar um link de redefinição de senha para o e-mail do usuário.
- Editar e Excluir: Altere permissões, cidades ou remova usuários do sistema.
Lista de Usuários
Interface de gerenciamento de usuários do sistema
Formulário de Novo Usuário
Modal de cadastro de novo usuário com todos os campos necessários
Demonstração de Gerenciamento
Veja como gerenciar usuários no sistema:
Vídeo mostrando o processo de criação e gerenciamento de usuários
O Quadro de Rotas
O N1 utiliza um quadro visual (Kanban) para organizar os atendimentos. Cada "Card" é uma rota.
- Arrastar e Soltar: Mova os cards entre as colunas para mudar o status (ex: de "Pendente" para "Em Andamento").
- Busca Rápida: Use a barra de pesquisa no topo do quadro para encontrar uma rota pelo nome do cliente ou rua.
- Colunas:
- Pendente: Aguardando técnico.
- Sem Atendimento: Técnico foi, mas não conseguiu contato.
- Gerar OS: Rota identificou problema no cliente, precisa abrir OS.
- Resolvido: Problema solucionado.
Quadro Kanban N1
Interface do quadro Kanban mostrando as colunas de status
Interação com Cards
Demonstração da funcionalidade de arrastar e soltar cards
Demonstração do Kanban
Veja como funciona o quadro Kanban em ação:
Vídeo mostrando a gestão visual de rotas no quadro Kanban
Como gerar relatórios com IA
O Rota+ possui uma IA integrada que analisa os dados para você.
- Vá para a página "Relatórios".
- Escolha os filtros (data, cidade) se desejar.
- Clique no botão Gerar PDF.
- Aguarde: A IA vai ler os dados, identificar padrões (ex: "Bairro X tem muitas quedas de energia") e escrever um resumo automático no topo do PDF.
Dica: Não precisa gerar o relatório 10 vezes. Gere uma vez, leia a análise da IA e pronto!