5.0 KiB
5.0 KiB
Melhorias Implementadas no Módulo TopSapp
Problemas Resolvidos
✅ 1. CPF do Cliente Não Era Mostrado
Problema: O CPF dos clientes não aparecia nas buscas. Solução:
- Implementado mapeamento correto do campo
cpfda API - Adicionado fallback para campos alternativos (
cpfCnpj,documento) - CPF agora é exibido corretamente em todas as interfaces
✅ 2. Status Incorreto dos Clientes
Problema: Clientes ativos apareciam como inativos. Solução:
- Criado método
interpretarStatusCliente()que analisa múltiplos campos - Verifica
ativo,bloqueado,id_status, datas de bloqueio/desativação - Status agora reflete corretamente a situação real do cliente
✅ 3. Seleção de Clientes Múltiplos
Problema: Quando havia múltiplos clientes, não havia opção de escolha. Solução:
- Interface com botões inline para seleção
- Lista até 10 clientes com informações resumidas
- Botões específicos para "Ver Dados" e "Ver Faturas"
- Navegação intuitiva entre múltiplos resultados
Novas Funcionalidades
🆕 1. Dados Cadastrais Completos
Comandos:
dados cliente João Silvadados cadastrais 123.456.789-10dados cliente 12345(ID do cliente)
Informações Exibidas:
- Dados Pessoais: Nome, CPF, RG, email, telefones
- Endereço Completo: Rua, número, complemento, bairro, cidade, UF, CEP
- Status do Cliente: Ativo/Inativo baseado nos serviços
- Data de Cadastro: Quando o cliente foi registrado
- Observações: Notas importantes sobre o cliente
🆕 2. Informações Detalhadas dos Serviços
Para cada serviço contratado:
- Plano: Nome do plano contratado
- Login e Senha: Credenciais de acesso
- Dados de Rede: IP atual, último IP, status de conexão
- Velocidades: Download e upload contratados
- Cobrança: Valor mensal, dia de vencimento, modalidade
- Status: Liberado, Bloqueado, Desativado com ícones coloridos
🆕 3. Dados FTTH Completos
Informações Técnicas:
- Base/OLT: Identificação da central
- PON: Porta PON específica (ex: 16-7, 12-11)
- Service Port: Porta de serviço na OLT
- Serial da ONU: Identificação única do equipamento
- Perfil da ONU: Modelo e configuração (ex: AN5506-02-B)
- Sinais Ópticos: RX e TX com data/hora da última medição
- Status de Conexão: Online/Offline em tempo real
- Último Acesso: Data e hora da última conexão
🆕 4. Endereço de Instalação
Dados Completos:
- Endereço: Rua, número, complemento
- Localização: Bairro, cidade, UF, CEP
- Coordenadas: Latitude e longitude para localização GPS
- Diferenciação: Endereço de cobrança vs. endereço de instalação
🆕 5. Histórico do Serviço
Datas Importantes:
- Cadastro: Quando o serviço foi criado
- Ativação: Quando começou a funcionar
- Último Bloqueio: Se teve bloqueio recente
- Desativação: Se o serviço foi cancelado
🆕 6. Interface Melhorada
Navegação:
- Botões Inline: Ações rápidas sem digitar comandos
- Múltiplas Opções: Ver dados, faturas, serviços
- Visual Organizado: Informações agrupadas logicamente
- Ícones Intuitivos: Status visuais com cores e símbolos
Comandos Disponíveis
Busca de Clientes
buscar cliente João da Silva
buscar cliente 123.456.789-10
buscar cliente Guarai João (especifica instância)
Dados Cadastrais
dados cliente João Silva
dados cadastrais 123.456.789-10
info cliente 12345
Faturas
ver faturas 123.456.789-10
faturas cliente João Silva
Serviços
listar serviços 123.456.789-10
ver serviços cliente João
Integração com API TopSapp
Endpoints Utilizados
- ObterClientes: Dados básicos do cliente
- ObterClientesServicos: Informações completas dos serviços
- ObterDocReceber: Faturas em aberto
Tratamento de Erros
- Fallback Inteligente: Se um endpoint falha, usa dados de outro
- Múltiplas Tentativas: Diferentes abordagens para obter dados
- Logs Detalhados: Rastreamento completo para debugging
Otimizações
- Cache de Sessão: Reutiliza autenticação por 30 minutos
- Requests Paralelos: Busca dados simultaneamente quando possível
- Dados Unificados: Combina informações de múltiplas fontes
Configuração
Variáveis de Ambiente Necessárias
TOPSAPP_GUARAI_USER=usuario_guarai
TOPSAPP_GUARAI_PASS=senha_guarai
TOPSAPP_PEDRO_AFONSO_USER=usuario_pedro
TOPSAPP_PEDRO_AFONSO_PASS=senha_pedro
Instâncias Suportadas
- Guarai/Colmeia: https://131.0.192.6:9910
- Pedro Afonso: https://45.189.140.18:9910
Benefícios das Melhorias
- Informação Completa: Dados técnicos e cadastrais em um só lugar
- Interface Intuitiva: Botões e navegação simplificada
- Dados Precisos: Status e informações atualizadas
- Suporte Técnico: Informações FTTH para diagnósticos
- Produtividade: Menos comandos, mais informações
- Confiabilidade: Múltiplas fontes de dados com fallback