Ir para o conteúdo

Roteiro: Validar a classificação BR de uma chamada ponta a ponta no Classifier Tester

Perfil necessário: viewer (o teste é leitura; não altera dados nem runtime) Menus usados: Roteamento Risco: baixo — o Classifier Tester consulta as mesmas tabelas do runtime (partição classification, CADUP, BDO, SUP) sem mutar estado; nenhum número é roteado. Rollback: não aplicável — teste somente leitura. Para reverter um cadastro que o teste denunciou, volte ao roteiro de origem (br-sup-bdo-cadup.md) e reverta o dado.

Pré-requisitos

  • [ ] Números A e B reais no formato que o cliente envia (o teste canonicaliza para E.164 +55...).
  • [ ] Ao menos um cenário portado e um não portado, quando portabilidade estiver em pauta.
  • [ ] CN/CNL esperadas do destino conhecidas (para conferir o resultado contra CADUP).

Passo a passo

1. Abrir o Testar Classificação

Caminho: Roteamento → Testar Classificação Clique: [Executar Teste]

Tela Testar Classificação com número A, número B e o botão Executar Teste destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Número A (origem) sim 5511999999999 origem da chamada; canonicalizado e resolvido em CN/UF/CNL
Número B (destino) sim 5511888888888, 08001234567, 190, 1056 destino a classificar (aceita forma nacional, 0800, SUP)
A-CN Override (opcional) não 11 sobrescreve a CN detectada do A para simular origem de outro DDD

Resultado esperado: painel Resultado da classificação com os campos do passo 2; o teste entra no Histórico de testes (últimos 50, em localStorage do navegador), com botões de repetir e limpar por linha.

2. Ler o resultado da classificação

Caminho: painel Resultado da classificação na mesma tela Clique: — (somente leitura)

Painel de resultado com Tipo de Chamada, CNs, Regime, Motivo do Match e Classe B

Preencha: nada. Campos do resultado e como ler cada um:

Campo O que mostra Como ler
Tipo de Chamada tag com Local, LDN, Movel, Int., Especial, Emerg., Desconhecido (backend: LOC_FIX/LOC_MOB/LDN_FIX/VC2_MOB/VC3_MOB/LDI/CNG/SUP/EMG) LOC = mesmo CN (A↔B); LDN/VC2/VC3 = mesma UF com CN diferente / UF diferente; CNG = cobrança reversa (0800/0300/0303); SUP/EMG = serviço público/emergência
CN Origem (A) CN (DDD) resolvida do A (ou do override) - significa que CADUP/BDO não resolveu a origem
CN Destino (B) CN do B canônico - idem, para o destino
Regime tag STFC, SCMP, SEAC, SMP, Desconhecido; nos fluxos simplificados atuais o backend devolve 67_cns (regime de 67 CNs) regimes não usados no caminho atual aparecem como o valor cru
Motivo do Match texto do oráculo: Mesmo CN, Mesma UF com CN diferente, UF diferente, Partição call_classification (dpid N), SUP exato em passthrough, SUP sem tradução para a CNL de origem, Numero encontrado na tabela dids, Classe B nao encontrada; fallback nacional, Dados insuficientes para resolver os CNs; fallback nacional explica por que aquele tipo foi escolhido; é o campo de depuração principal
Classe B tag Fixo, Movel, Especial, Emergencia, Desconhecido classe estrutural do B (FIX/MOB) usada para derivar LOC_FIX vs LOC_MOB, VC2 vs VC3 etc.
SUP Discado código SUP reconhecido no catálogo (ex.: 190, 1056) aparece só quando o B é um SUP cadastrado
CNL Origem BDO CNL da origem resolvida via BDO insumo para casar a tradução do SUP por CNL
SUP Traduzido número principal E.164 para o qual o SUP será substituído vazio quando não há tradução para a CNL — a chamada real seria rejeitada (404)
Erro SUP mensagem de falha do caminho SUP (catálogo desincronizado, sem CNL de origem via BDO etc.) resolver no cadastro SUP/BDO antes de confiar no teste

O backend também calcula categoria tarifária e rating bucket do tipo resultante (tariff_category, rating_bucket_code), visíveis na resposta da API — base de conferência com a Tarifação.

3. Reproduzir e comparar cenários no histórico

Caminho: card Histórico de testes (mesma tela) Clique: ícone ↻ (Repetir teste) na linha desejada

Preencha: nada — o teste da linha é reexecutado com os mesmos números.

Resultado esperado: resultado atualizado no painel e nova entrada no histórico. Use pares A/B alternados (portado × não portado, CN igual × diferente) para confirmar que a classificação muda pelo motivo certo (Motivo do Match deve mudar junto com o Tipo).

Validação

  • [ ] Visual: painel de resultado exibe Tipo, CNs, Regime, Motivo, Classe B e os campos SUP quando aplicável; histórico acumula os testes.
  • [ ] Funcional: tipo resultante bate com a expectativa de negócio por cenário (mesmo CN → Local; UF igual/CN diferente → LDN/VC2; 0800 → CNG; 190 → Emerg.; 1056 cadastrado → SUP passthrough ou tradução).
  • [ ] Runtime: os Motivo do Match que citam a partição confirmam que o OpenSIPS e o tester leem a mesma fonte (call_classification, dpid em Sistema → Configuração); divergência de resultado com chamada real investiga-se pelo CDR/call_log com o mesmo A/B.

Erros comuns

Sintoma Causa provável Correção
Informe o numero A/B e o teste não roda campos vazios preencher A e B (o override é opcional)
0800 classificado como LDI/Int. dado de CADUP/localidades desatualizado para o B ou B fora do formato canônico conferir prefixo do B em Sistema → CADUP → Prefixos e re-testar
SUP Traduzido vazio com CNL Origem BDO preenchida sem tradução ativa daquela CNL no serviço cadastrar tradução por CNL (ver br-sup-bdo-cadup.md) e repetir
Erro SUP: "Catálogo SUP desincronizado da partição classification" catálogo salvo mas dp_reload classification falhou rever operação em Roteamento → Avançado → SUP (o CRUD recarrega sozinho; falha indica problema MI)
CN Origem/Destino - número fora das faixas CADUP ou override inválido validar número no CADUP; usar A-CN Override só com CN válida (2 dígitos)
Match inesperado com motivo citando dpid regra manual na partição classification (Avançado → Dialplan) cobrindo o caso antes revisar prioridade/regex da regra manual; regras _pf/_lpn/_a são gerenciadas pelo sistema