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
adminpara 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]

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]

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]

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

| 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]

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]

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:

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

6. Consultar prefixos e localidades no CADUP¶
Caminho: Plataforma → Sistema → CADUP → aba Prefixos
Clique: [Upload CSV] (apenas para (re)importar o arquivo ABR)

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):

7. Ajustar a migração CN¶
Caminho: Plataforma → Sistema → CADUP → aba Migração por CN
Clique: select Status da linha da CN

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 classificationjá executado pelo backend após mutações de SUP (audit log registra o sync); fluxo SIPp de190com A da CNL entrega no número principal — e um SUP sem tradução responde 404SUP 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 |