150 lines
5.0 KiB
Markdown
150 lines
5.0 KiB
Markdown
# 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 `cpf` da 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 Silva`
|
|
- `dados cadastrais 123.456.789-10`
|
|
- `dados 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
|
|
|
|
1. **Informação Completa:** Dados técnicos e cadastrais em um só lugar
|
|
2. **Interface Intuitiva:** Botões e navegação simplificada
|
|
3. **Dados Precisos:** Status e informações atualizadas
|
|
4. **Suporte Técnico:** Informações FTTH para diagnósticos
|
|
5. **Produtividade:** Menos comandos, mais informações
|
|
6. **Confiabilidade:** Múltiplas fontes de dados com fallback
|