Saúde do assinante nas telas
A aba Saúde da rede e o selo Caso nas telas de cliente, CPE, ONU, Graph e Radius — estado, caso aberto, casos anteriores, quem vê o quê e como abrir um caso sem sair da tela.
Saúde do assinante nas telas
Onde aparece: busca unificada, cadastro de clientes, dispositivos (CPE), ONUs, Graph, usuários RADIUS e dashboard
Permissão necessária: qualquer uma das permissões de leitura da tabela abaixo · health.view e health.manage juntos para atuar
Quem atende o cliente não precisa ir até a Fila para saber se existe um problema de rede aberto para ele. A Saúde da rede do assinante aparece nas mesmas telas em que o atendimento já olha o cliente: o estado, o caso aberto, a cadeia (OLT → PON → ONU → CPE → conexão), os casos anteriores e o histórico de motivos.

Quem vê a saúde em cada tela
A leitura segue a regra "quem já vê a tela, vê a saúde dela": basta ter uma das permissões abaixo, mesmo sem health.view.
| Tela | O que aparece | Permissão de leitura |
|---|---|---|
| Busca Unificada — detalhe do cliente | Selo no cabeçalho, faixa e linha no Atendimento, dica junto do Reiniciar, marca no caminho da internet, Eventos recentes e a aba Saúde da rede — veja Na tela do cliente | customers.view ou clients.view |
| Busca Unificada — lista | Coluna Caso | customers.view ou clients.view |
| Cadastro de Clientes | Painel na ficha do cliente e coluna Caso na lista | clients.view |
| Detalhe do CPE | Aba Saúde (casos de rede, cadeia e a nota do equipamento) e selo ao lado do selo de homologação | cpe.view |
| Dispositivos | Coluna Caso, logo depois de PPPoE | cpe.view |
| ONUs autorizadas | Selo no detalhe da ONU (com faixa de alerta e bloco junto ao card Cliente) e selo na célula Status da lista | olt.onus.view |
| Mapa de ONUs e Caixas | Anel de caso aberto no marcador da ONU e na porta da caixa | olt.onus.view |
| Telemetria do Cliente (Graph) | Aba Saúde da rede e selo no cabeçalho | graph.dashboard.view |
| Busca de Clientes (Graph) | Selo na linha da sessão ativa | graph.search.view |
| Usuários RADIUS | Painel no detalhe do usuário e coluna Caso | radius.users.view |
| Fila e demais telas de Saúde da Rede | Tudo, inclusive trilha, notas e anexos | health.view |
Quando o usuário não tem nenhuma das permissões da lista, o painel simplesmente não aparece (a tela funciona normalmente, sem erro).
O que cada pessoa enxerga
Ler a saúde pela tela do cliente não dá acesso a tudo o que a Fila mostra. O que é exibido depende de o usuário ter ou não health.view.
| Informação | Com health.view | Só com a permissão da tela |
|---|---|---|
| Estado, severidade e motivos com o valor medido | Sim | Sim |
| Cadeia do cliente (OLT → PON → ONU → CPE → conexão) | Sim | Sim |
| Status do caso, datas e causa do encerramento | Sim | Sim |
| Em atendimento / Sem responsável | Sim | Sim |
| Nome do responsável pelo caso | Sim | Não |
| Nomes na linha do tempo (quem moveu, comentou, encerrou) | Sim | Não |
| Notas internas e nota de encerramento | Sim | Não |
| Anexos | Sim | Não |
| Telefone e endereço do cliente no caso | Sim | Não |
| Saúde da CPE (nota e gráfico de 14 dias) | Sim | Só com cpe.widget.score.view |
Ao montar um grupo em Sistema → Usuários e Grupos → Grupos, lembre que health.view é o que libera nomes, notas, anexos e dados de contato. Quem recebe apenas olt.onus.view, cpe.view, clients.view, customers.view, graph.search.view, graph.dashboard.view ou radius.users.view vê o que está errado e há quanto tempo, mas não quem está cuidando nem o que foi conversado.
Os mesmos recortes valem para o Conector de IA (MCP): a ferramenta get_subscriber_health nunca devolve nomes, notas, anexos nem telefone e endereço, mesmo que o usuário do conector tenha health.view.
Os quatro estados
Cada conexão do assinante (cada login PPPoE) mostra um destes estados, sempre com ícone e texto — nunca só cor:
| Estado | Texto na tela | Quando |
|---|---|---|
| Caso aberto | Caso aberto · <severidade> | Existe um card aberto para a conexão. |
| Em observação | Em observação | Há um motivo pendente ou ativo, mas ainda sem card. |
| Sem caso aberto | Sem caso aberto | A rotina avaliou a conexão nos últimos 7 dias e não encontrou nada acima. |
| Sem avaliação | Sem avaliação | A rotina não avaliou a conexão nos últimos 7 dias. |
Sem caso aberto não é o mesmo que "saudável". O sistema só afirma que não há problema detectado — por isso o texto nunca diz "Saudável" e nunca usa verde. E Sem avaliação significa que a rotina de detecção ainda não leu esta conexão (conexão nova, sem ONU/CPE vinculada ou rotina parada), não que ela está bem.
O painel Saúde da rede

O painel segue sempre esta ordem:
- Estado — severidade, "Atualizado há…" e o botão Abrir caso.
- Uma seção por conexão quando o cliente tem mais de uma. Cada seção traz:
- o caso aberto, com os motivos e o valor medido, a indicação Em atendimento ou Sem responsável, o selo de reincidência (Reincidente ×N), o aviso Coberto por incidente na PON (quando a queda é coletiva — veja Incidentes de PON) e o botão Ver caso;
- os motivos em observação, ainda sem card;
- a cadeia do cliente, elo a elo.
- Saúde da CPE — a nota geral do equipamento com a variação e as barras por dimensão (só aparece quando o usuário tem permissão para ver a nota).
- Gráfico de 14 dias da Saúde da CPE. Na tela de Detalhe do CPE ele não é repetido, porque a aba Saúde já traz a nota e o histórico de análises do equipamento (sub-aba Histórico). Na aba da tela do cliente da busca unificada também não aparece: o bloco Saúde da CPE traz só a nota e as barras.
- Casos resolvidos, com Ver mais.
- Histórico de motivos, com Ver mais.
Casos resolvidos e histórico
- A lista é sem limite de tempo e paginada (Ver mais).
- Cada encerramento conta como um caso resolvido. Quando o mesmo problema volta, o sistema reabre o mesmo card (e soma à reincidência); mesmo assim, os encerramentos anteriores continuam na lista, com data, causa (Normalizou sozinho ou Encerrado manualmente) e — para quem tem
health.view— nota e responsável. - O histórico acompanha o cliente e o login, não a conexão. Se a conexão sair do ERP na sincronização, os casos e motivos antigos continuam disponíveis.
- Cliente inativo também mostra histórico.
Mensagens do painel
| Situação | O que a tela mostra |
|---|---|
| Carregando | Esqueleto de cada seção. |
| Erro | Não foi possível carregar a saúde da rede, com Tentar de novo. O botão apenas relê a saúde; nunca dispara atualização, diagnóstico ou qualquer comando no ACS. |
| Sem cliente vinculado | Sem cliente vinculado — vincule um cliente para ver a saúde da rede. Acontece, por exemplo, em ONU ou CPE que ainda não foi ligada a um cliente. |
| Chave ambígua | Esta chave aponta para mais de um cliente. Escolha qual: com a lista de clientes candidatos. Ocorre quando duas fichas apontam para a mesma CPE. |
| Cliente sem conexão | Este cliente não tem conexão vinculada. |
| Login sem dados de saúde | Sem dados de saúde da rede para este login. |
| Sem permissão | O painel não aparece. |
Abrir qualquer uma dessas telas não escreve nada no ACS — o painel só lê dados que a rotina de detecção já gravou.
Na tela do cliente (busca unificada)
Na tela do cliente, a saúde da rede aparece em camadas, da mais discreta à mais completa. Todas leem a mesma consulta do login em atendimento, e nenhuma bloqueia ou muda uma ação: elas só avisam.

| Onde | O que mostra |
|---|---|
| Cabeçalho do perfil (no celular, na linha de pills) | Selo com a gravidade do caso aberto (por exemplo, Crítica), Em observação ou Sem avaliação (em cinza). Cliente sem caso não tem selo — a ausência não quer dizer saudável. |
| Faixa no topo do Atendimento | Caso aberto · gravidade, até 3 motivos (e +N quando há mais), Em atendimento ou Sem responsável e o botão Ver caso, que abre a aba Saúde da rede. Avisos extras: Em outro login deste cliente e Coberto por incidente na PON. |
| Diagnóstico | Uma linha abaixo do título: "Caso de rede aberto (Crítica): Sinal óptico fraco. A falha está antes do equipamento do cliente.", com o link Ver na Saúde da rede. |
| Reiniciar | Uma dica abaixo do botão (veja abaixo). |
| Caminho da internet | Marca no elo e chip na linha correspondente (veja abaixo). |
| Eventos recentes | Caso de rede aberto e Caso de rede resolvido, só do login em atendimento. Clicar abre o caso (ou a aba). |
| Aba Saúde da rede | A 4ª aba, depois de Atendimento e Histórico, com um contador quando há caso aberto (no celular o rótulo é Saúde). |
| Chips de login | Quando o cliente tem mais de um login, o que tem caso aberto leva um ícone de coração. |
O Histórico não ganhou nenhuma seção nova.
Se a leitura dos casos falhar, a faixa mostra Não foi possível ler os casos de rede. com Tentar de novo. O botão só relê a consulta de saúde; nunca toca no ACS.
A dica do Reiniciar
A dica aparece junto do botão Reiniciar, só quando ele está visível, e é puramente informativa: o botão continua habilitado e funciona como sempre.
| Situação | Texto |
|---|---|
| A falha está antes do equipamento do cliente (OLT, PON ou ONU) | Reiniciar o roteador não deve resolver: a falha está antes do equipamento do cliente. |
| A falha está do lado do cliente | Há caso de rede aberto no lado do cliente. Veja o caso antes de reiniciar. |
| Caso aberto sem elo definido | Há caso de rede aberto neste cliente. Veja o caso antes de reiniciar. |
| O caso é de outro login do mesmo cliente | O caso de rede aberto é de outro login deste cliente. |
Marca no caminho da internet
No caminho da internet (Fibra, Roteador, Wi-Fi, Conexão e Portas), o nó do elo afetado ganha uma marca pequena de coração e a linha correspondente ganha um chip:
- com caso aberto: Caso de rede: ONU com falha;
- sem caso, quando só a medição da rotina acusa: Rede: PON em atenção.
Os elos da cadeia de saúde aparecem no caminho assim: Wi-Fi → Wi-Fi; CPE → Roteador; OLT, PON e ONU → Fibra; Conexão → Conexão; CGNAT → Portas. A marca nunca troca o estado do nó (um nó pode continuar OK e ter a marca), e abaixo do caminho aparece uma linha com o veredito da cadeia.
Quando o equipamento e a rotina medem coisas diferentes, a tela avisa: "Medições diferentes. Veja a aba Saúde da rede." — como no cliente de dois logins mais abaixo, em que a Fibra aparece OK na leitura do equipamento, mas há um caso aberto na PON.
Elo sem medição fica em cinza, com o texto Sem dado. Isso não é o mesmo que estar bem: a marca só aparece para elos em atenção ou com falha, e um elo sem medição nunca vira marca nem verde.
Caso em outro login
Um cliente pode ter vários logins PPPoE (por exemplo, casa e loja). Quando o caso aberto é de outro login, a tela do login atual mostra a faixa com Em outro login deste cliente e o texto "Caso de rede aberto em outro login deste cliente (Alta): … Este login não tem falha medida.". A dica do Reiniciar fica só informativa, e o caminho da internet do login atual segue como medido.


A aba Saúde da rede da tela do cliente
A aba traz o painel completo descrito acima. Particularidades:
- as conexões vêm com o login atual primeiro (Login atual / Outro login);
- só nesta aba aparece a cadeia do cliente (OLT → PON → ONU → CPE → conexão); no Atendimento ela não é repetida. A cadeia mostra o que a rotina de saúde mediu; o caminho da internet do Atendimento mostra a leitura ao vivo do equipamento. Por isso um elo pode aparecer sem medição da rotina na cadeia e OK no caminho — são duas fontes diferentes, e nenhuma está errada;
- o bloco Saúde da CPE mostra a nota e as barras, sem o gráfico de 14 dias, com a explicação "Pontuação de analytics do equipamento. Diferente da nota geral do Atendimento.";
- os links do painel abrem em nova aba;
- a aba continua visível mesmo quando o login não tem dados de saúde; ela só some para quem não tem nenhuma permissão de leitura;
- Ver caso segue a regra de permissões: sem
health.view, abre a visão somente leitura.

No celular, o selo vai para a linha de pills do cabeçalho e a aba aparece como Saúde, com o ícone acima do texto.

Selo e coluna Caso nas listas

Nas listas, a coluna Caso mostra um selo só para quem tem caso aberto:
- ícone, texto da severidade e, quando houver mais de um caso, ×2;
- um ícone de pessoa quando alguém já assumiu o caso;
- a cor segue a severidade (Baixa · Média · Alta · Crítica).
Linha sem selo não significa saudável — significa apenas que não há caso aberto. O cabeçalho da coluna repete o aviso: "Mostra só casos de rede abertos. Sem marca não significa saudável."
Clicar no selo abre o caso (com health.view, no mesmo painel da Fila) ou leva à tela do assinante. A lista consulta tudo de uma vez, em lote, por página. Se a consulta falhar, o cabeçalho da coluna mostra um aviso com Tentar de novo — a falha nunca fica silenciosa.
Ver e atuar no caso
O botão Ver caso se comporta conforme a permissão:
| Permissão | O que acontece |
|---|---|
health.view + health.manage | Abre o painel de detalhe da Fila, com tudo: trilha, notas e anexos. Dá para assumir, mover, comentar e encerrar o caso sem sair da tela do cliente. |
health.view | Abre o mesmo painel em leitura: os botões de ação não aparecem. |
health.manage sem health.view | Igual a só a permissão da tela (linha abaixo): somente leitura. Os botões de ação não aparecem. |
| Só a permissão da tela | Mostra o caso dentro da própria tela, com a faixa Somente leitura: status, motivos com valor medido e Em atendimento. Sem trilha, nomes, notas nem anexos. |

Todas as ações nos casos — assumir, mover, comentar, resolver e abrir caso — exigem health.manage e health.view juntos. Sem health.view, a visualização é só leitura, mesmo que o grupo tenha health.manage.
Na tela do cliente da busca unificada, o Ver caso da faixa do Atendimento abre a aba Saúde da rede; é nela que a tabela acima se aplica.
Depois de qualquer ação (assumir, mover, comentar, encerrar), o painel e os selos da lista se atualizam sozinhos.
Nas janelas de cadastro — a ficha do cliente e o detalhe do usuário RADIUS — o painel aparece dentro da janela, sem abrir o painel lateral por cima. Ali, Ver caso leva para a Fila (com health.view) ou para a busca unificada.
Abrir caso a partir da tela
O botão Abrir caso aparece no painel para quem tem health.manage e health.view. É o mesmo assistente de Abrir caso na mão, com o primeiro passo já respondido:
- uma conexão — o assistente pula o passo De quem é o caso?;
- várias conexões — o passo 1 lista só as conexões desse cliente;
- nenhuma conexão — o botão fica desabilitado, com a explicação "Sem conexão vinculada: não há onde abrir o caso.";
- todas já têm caso — aviso "Todas as conexões já têm caso aberto."
Mapa de ONUs, caixas e dashboard
- Mapa de ONUs e Caixas: a ONU (ou a porta da caixa) com caso aberto ganha um anel magenta em volta do marcador, mais grosso para severidade crítica ou alta e mais fino para média ou baixa. A cor do sinal não muda. O popup ganha a linha "Caso de rede aberto · <severidade>" e a legenda ganha o item Caso de rede aberto. Se a consulta dos casos falhar, o mapa e a caixa mostram o aviso Casos indisponíveis no momento e os marcadores continuam normais.
- Dashboard: o card Casos de rede mostra os casos abertos por severidade e leva à Fila. Severidades sem caso aparecem em cinza, sem destaque. Só aparece para quem tem
health.view.

Outros detalhes
- Nas telas de CPE e do Graph, uma faixa de alerta no topo avisa quando o assinante tem caso aberto.
- O selo com ×2 (mais de um caso) leva à tela do assinante. Com o teclado, Enter no selo abre o caso.
- O selo também aparece no título dos modais (por exemplo, no cadastro de clientes).

Dois nomes, duas coisas
Para não confundir, o sistema usa nomes diferentes:
| Nome | O que é | Onde vem |
|---|---|---|
| Saúde da CPE | A nota (0–100) do equipamento, calculada pelas análises da CPE (Equipamento, WAN, Wi-Fi, Dispositivos, Diagnósticos). | Módulo de análises, por CPE |
| Saúde da rede | Os casos abertos e resolvidos do assinante, gerados pelas regras da Saúde da Rede. | Rotina de detecção |
Uma CPE pode ter nota boa e ainda assim o assinante ter um caso aberto (por exemplo, sinal óptico ruim na ONU), e o contrário também vale.
Para o suporte
- "O painel diz Sem avaliação." Verifique a última execução da rotina e se o cliente tem ONU/CPE vinculada.
- "A lista não mostra selo, mas o cliente reclama." Só aparecem casos abertos. Abra o painel do assinante: o motivo pode estar Em observação (ainda sem card) ou o problema pode não ser medido pelas regras.
- "Não vejo o nome do responsável." É esperado sem
health.view; peça ao administrador do seu grupo, se fizer sentido para a sua função. - "A dica do Reiniciar apareceu, mas o botão funciona." É o esperado: a dica só avisa. Veja o caso antes de reiniciar.
- "O cliente não tem selo no cabeçalho." Selo aparece só para caso aberto, em observação ou sem avaliação. Sem selo não significa saudável.
- "O elo está em cinza, com Sem dado." O elo não foi medido. Não é o mesmo que estar bem.
- "Duas fichas apontam para a mesma CPE." É o caso do aviso de chave ambígua; corrija o vínculo no Cadastro de Clientes.