Ir para o conteúdo

Roteiro: Navegar o detalhe do cliente (linhas, DIDs, chamadas e saldo)

Perfil necessário: admin | viewer (visualização; mutações exigem admin) Menus usados: Comercial Risco: baixo (consulta; ações destrutivas do detalhe pedem confirmação) Rollback: editar o cliente pelo botão [Editar]; linhas/DIDs seguem os roteiros próprios

Pré-requisitos

  • [ ] Cliente existente (ver commercial-criar-cliente.md)

Passo a passo

1. Abrir o detalhe do cliente

Caminho: Comercial → Clientes Clique: link do nome na coluna Cliente (abre /customers/<id>)

Listagem de clientes com o botão Novo Cliente destacado

Resultado esperado: página com header do cliente (nome, StatusTag, documento), botão Editar, botão de voltar e as abas Resumo, Linhas, DIDs, Chamadas.

2. Ler o resumo (dados, faturamento, contato e saldo do período)

Caminho: detalhe do cliente → aba Resumo Clique: nenhum

Detalhe do cliente, aba Resumo, com o botão Editar destacado

Resultado esperado:

  • Cartões Dados Cadastrais, Faturamento (Limite de Crédito, Dia de Fatura) e Contato
  • Cartão Observações quando houver anotação
  • Contadores Linhas / DIDs / Chamadas (total)
  • Painel Saldo e Utilização do Período: tabela por bucket com Direção (Saída/Entrante), Escopo (Cliente/Linha), Franquia, Usado, Saldo e Utilização % do ciclo atual

3. Consultar as linhas do cliente

Caminho: detalhe do cliente → aba Linhas Clique: campo de busca Buscar por DID ou número SIP

Aba Linhas do detalhe com o campo de busca destacado

Preencha/Opções:

Controle Obrig. Formato/opções Efeito
Busca por DID ou número SIP não texto + [Buscar] filtra as linhas listadas; [Limpar busca] restaura
[Nova Linha] — botão abre o mesmo dialog do roteiro de linha, com o cliente travado

Resultado esperado: tabela com Tag do tipo, #id, identidade SIP (IPs autorizados no tronco, subscriber na linha SIP, endpoint no trânsito), DIDs (primary em destaque), Max Conc. e Status; ações por linha: Editar, Editar subscriber (linha com subscriber), Excluir.

4. Consultar os DIDs do cliente

Caminho: detalhe do cliente → aba DIDs Clique: [Novo DID]

Aba DIDs do detalhe com o botão Novo DID destacado

Resultado esperado: tabela com DID (estrela no primary), linha vinculada, flags (Primário/CLI/Outbound/serviço), Dígitos Inbound e Status; Novo DID abre o dialog do roteiro de DID com o filtro de linhas travado no cliente.

5. Consultar as chamadas do cliente

Caminho: detalhe do cliente → aba Chamadas Clique: [Buscar]

Aba Chamadas do detalhe com o botão Buscar destacado

Preencha/Opções:

Controle Obrig. Formato/opções Efeito
Data Início / Data Fim não data/hora; pré-preenchidas com hoje janela da consulta
Call-ID / Origem / Destino não texto filtros diretos
Status não Completada, Perdida, Falhou resultado da chamada
Tipo não Nacional, Internacional, Local, Mobile, Fixo, Entrante, Sainte classificação da chamada

Resultado esperado: tabela com Call-ID, Início, Origem, Destino, Duração, Direção, Bucket, Valor, Status (Atendida/Perdida/Falhada…) e Tipo.

Validação

  • [ ] Visual: contadores Resumo batem com as abas Linhas/DIDs/Chamadas
  • [ ] Funcional: painel Saldo e Utilização mostra os buckets do plano das linhas do cliente (cruzamento com Comercial → Tarifação)
  • [ ] Funcional: Editar reabre o CustomerFormDialog com os dados atuais; salvar atualiza o header

Erros comuns

Sintoma Causa provável Correção
"Cliente não encontrado" id inexistente na URL abrir pelo link na listagem de Clientes
Painel de saldo vazio linhas sem plano ou sem consumo no ciclo vincular plano e conferir tráfego tarifado
Aba Linhas sem subscriber linha SIP criada sem credencial editar a linha e preencher a credencial (roteiro de linha)
Chamadas não aparecem filtros de data/tipo estreitos demais [Limpar] restaura o range de hoje

Tabela de referência rápida

Botão Onde O que faz
[Editar] header do detalhe reabre o CustomerFormDialog do cliente
[Nova Linha] aba Linhas cria linha com o cliente travado
[Novo DID] aba DIDs cria DID com o filtro de linhas travado
[Buscar] aba Chamadas aplica os filtros de CDR do cliente