Ir para o conteúdo

Roteiro: Cadastrar SUP/tradução por CNL, testar lookup BDO e consultar CADUP/migração CN

Perfil necessário: admin (cadastros e migração CN); consultas e testes são viewer Menus usados: Roteamento, Plataforma Risco: médio — SUP afeta roteamento de serviços públicos e emergência (um 190 sem tradução rejeita chamada de emergência); config BDO e CADUP alimentam portabilidade e classificação; migração CN altera interpretação de tráfego de toda a CN marcada. Rollback: serviço/tradução SUP: desabilitar (Status inativo) ou excluir — o CRUD recompila e recarrega a partição classification sozinho. Config BDO: desmarcar Ativo. CADUP: reimportar o CSV ABR correto (modo replace). Migração CN: voltar status/data para o valor anterior na própria linha.

Pré-requisitos

  • [ ] Perfil admin para gravar SUP/BDO/migração.
  • [ ] CNL de origem conhecida (do CADUP ou de um teste BDO prévio) para o serviço que será traduzido.
  • [ ] Número principal E.164 BR destino do SUP (sem +, ex.: 554932400000).
  • [ ] Arquivo CSV do ABR Telecom em mãos para (re)importar o CADUP.
  • [ ] Números de teste: SUP discado (190, 1056), E.164 portado e E.164 fixo.

Passo a passo

1. Cadastrar um serviço SUP

Caminho: Roteamento → Avançado → SUP / Serviços Públicos Clique: [Novo Serviço]

Página SUP/Serviços Públicos na aba Serviços com o botão Novo Serviço destacado

A tabela lista os serviços com Código, Nome, Categoria, Tratamento, Traduções e Status. Filtre por código, categoria ou status antes de criar para evitar duplicado. A aba Traduções por CNL traz o botão [Nova Tradução], usado no passo 3.

2. Preencher o serviço

Caminho: dialog Novo Serviço SUP Clique: [Salvar]

Dialog Novo Serviço SUP com código, categoria, nome e tratamento

Preencha:

Campo Obrig. Formato/exemplo Efeito
Código SUP * sim 3 a 16 dígitos iniciados por 1: 190, 1056, 10314 código exato reconhecido no catálogo (SUP variável, ADR 0014)
Categoria * sim Emergência / Utilidade pública marca serviços emergenciais (precedência sobre SUP genérico)
Nome * sim Polícia Militar identificação
Tratamento * sim Traduzir por CNL / Encaminhar sem tradução CNL: substitui o SUP pelo número principal da CNL de origem; passthrough: preserva o código discado e exige regra no perfil de saída com destino B exato e tipo Serviço
Descrição não texto livre contexto
Serviço ativo sim checkbox marcado/limpo só serviço ativo entra na partição de classificação

Resultado esperado: toast "Serviço SUP salvo"; serviço na tabela com o Tratamento escolhido. O backend recompila as regras geradas do catálogo na partição classification e executa dp_reload classification automaticamente — se o reload falhar, o toast mostra "SUP salvo, mas dp_reload falhou". Trocar um serviço para passthrough exige que ele não tenha traduções cadastradas (o CRUD falha alto em vez de ignorar).

3. Cadastrar a tradução por CNL

Caminho: Roteamento → Avançado → SUP / Serviços Públicos → aba Traduções por CNL Clique: [Nova Tradução]

Aba Traduções por CNL com o botão Nova Tradução destacado

Preencha (dialog Nova Tradução SUP; clique em [Salvar] ao final):

Dialog Nova Tradução SUP com serviço, CNL origem e número principal

Campo Obrig. Formato/exemplo Efeito
Serviço * sim select 190 — Bombeiros (CNL) serviço traduzido; serviços em passthrough não aceitam tradução (botão Salvar desabilitado com aviso)
CNL Origem * sim numérica até 8 dígitos, ex.: 47101 CNL de origem (BDO) que dispara esta tradução
Número Principal * sim E.164 BR sem +, ex.: 554932400000 número que substitui o SUP na chamada
Prioridade sim inteiro 1–9999 (default 100) desempate para mesma CNL (menor vence)
Descrição não texto livre contexto
Tradução ativa sim checkbox só tradução ativa é usada

Resultado esperado: toast "Tradução SUP salva"; linha na tabela com SUP, Serviço, CNL Origem, Número Principal, Prioridade e Status (o dialog preenchido segue o padrão do passo 2: campos obrigatórios marcados com * e checkbox de vigência). Não pode existir duas traduções ativas com mesmo serviço/CNL/prioridade (o CRUD rejeita). Para testar o efeito, volte ao Classifier Tester com o SUP discado e confira SUP Traduzido (ver br-classification.md).

4. Consultar portabilidade no teste de lookup do BDO

Caminho: Plataforma → Sistema → BDO Lookup → aba Teste de lookup Clique: [Testar Lookup]

Aba Teste de lookup do BDO com campo E.164 e botão Testar Lookup destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Número E.164 sim 5511987654321 número consultado na BDO ativa

Resultado esperado: bloco Resultado com o JSON da resposta (operadora/RNL/CNL de destino, provedor etc.). Erro Nenhuma configuração BDO ativa aparece como 404 — cadastre a config (passo 5). Cada teste real é gravado no Log com latência e custo (veja abas Dashboard e Log na sequência).

5. (Opcional) Configurar o driver BDO

Caminho: Plataforma → Sistema → BDO Lookup → aba Configurações Clique: [Nova Config]

Aba Configurações do BDO com o botão Nova Config destacado

Preencha (dialog Nova Config; clique em [Salvar] ao final):

Campo Obrig. Formato/exemplo Efeito
Nome * sim BDO principal identificação
Driver * sim csv / http mecanismo do lookup
URL Template * sim https://api.exemplo/lookup/{e164} endpoint com placeholder do número
Ativo sim switch única config ativa é usada pelo runtime/teste
Atributos não pares do schema: timeout_ms, cache_ttl, headers.X-API-Key, circuit_breaker_threshold/window/cooldown timeout, cache e proteção do driver HTTP

Resultado esperado: config listada com URL e flag Ativo; o Dashboard da mesma tela passa a refletir as consultas das últimas 24h:

Dashboard do BDO com Total Consultas, Taxa Cache Hit, Latência média e Custo Total

E o Log lista Data/Hora, E164, Cache Hit, Latência, Custo e Resposta, filtrável por período:

Log do BDO com consultas, cache hit, latência, custo e resposta

6. Consultar prefixos e localidades no CADUP

Caminho: Plataforma → Sistema → CADUP → aba Prefixos Clique: [Upload CSV] (apenas para (re)importar o arquivo ABR)

Aba Prefixos do CADUP com o botão Upload CSV destacado

Preencha: a busca da toolbar casa por CN, prefixo, operadora ou área local (ex.: buscar 47 para conferir a CNL do teste SUP). A tabela mostra CN, Prefixo, faixa MCDU (início/fim), Operadora, Classe, CNL, UF, Área Local/Tarifária, Portado e vigência. Um badge Dados desatualizados aparece quando o lote está velho.

Para importar: escolha o .csv do ABR (até 10 MB); o modo é replace (substitui o conjunto). Resultado esperado: toast N inseridos, M ignorados (K linhas) e a tabela recarregada. A aba Localidades é a fonte do par A↔B que o Classifier Tester usa (filtro por CN/UF; código, CN, UF, nome, município):

Aba Localidades do CADUP com filtro por CN e UF

7. Ajustar a migração CN

Caminho: Plataforma → Sistema → CADUP → aba Migração por CN Clique: select Status da linha da CN

Aba Migração por CN com select de status e data editável

Preencha:

Campo Obrig. Formato/exemplo Efeito
Status sim Pré-migração / Em transição / Concluído estágio da migração CN; alterar grava na hora
Data Migração não AAAA-MM-DD no calendário; clique no texto sublinhado para editar data oficial do evento; limpa para Não definida

Resultado esperado: toasts "Status atualizado"/"Data atualizada"; valores persistidos na linha. CNs em migração explicam classificações estranhas no Classifier Tester (portabilidade/RN1 mudando de operadora) durante o período.

Validação

  • [ ] Visual: serviço/tradução aparecem nas abas com Status correto; teste BDO devolve JSON; CADUP mostra prefixo/localidade buscados; migração CN reflete o status escolhido.
  • [ ] Funcional: Classifier Tester com o SUP discado e um A da CNL cadastrada devolve SUP Discado, CNL Origem BDO e SUP Traduzido preenchidos; lookup BDO do número portado devolve a operadora esperada.
  • [ ] Runtime: opensips-cli -x mi dp_reload classification já executado pelo backend após mutações de SUP (audit log registra o sync); fluxo SIPp de 190 com A da CNL entrega no número principal — e um SUP sem tradução responde 404 SUP not configured for CNL (comportamento seguro).

Erros comuns

Sintoma Causa provável Correção
"Informe um SUP de 3 a 16 dígitos, iniciado por 1" código fora do padrão (ex.: 1900…, 0910) corrigir o código; SUP sempre inicia em 1
Botão Salvar da tradução desabilitado serviço em passthrough trocar o Tratamento do serviço para Traduzir por CNL (antes remover traduções pendentes) ou criar regra exata no perfil
Erro de prioridade duplicada ao salvar tradução já existe tradução ativa com mesmo serviço/CNL/prioridade usar prioridade diferente ou editar a existente
"SUP salvo, mas dp_reload falhou" MI do OpenSIPS indisponível/permissão opensips-cli -x mi dp_reload classification manual; o catálogo já está no banco, só a memória ficou velha
404 Nenhuma configuração BDO ativa no lookup nenhuma config marcada Ativo ativar uma config na aba Configurações
Lookup falha com timeout/circuit breaker driver HTTP lento ou limiar do breaker atingido ajustar timeout_ms/circuit_breaker_* nos atributos e re-testar
Badge Dados desatualizados no CADUP import antigo reimportar o CSV ABR atual (modo replace)
Tradução não dispara na chamada real CNL de origem diferente da cadastrada, ou tradução/serviço inativo conferir CNL via Teste de lookup (CNL Origem BDO no Classifier) e Status do serviço/tradução