Como podemos ajudar?

Mapa de Rede na prática: como os clientes aparecem, como desenhar a sua rede e como funciona a Reserva de Porta

Este texto complementa a wiki geral do Mapa de Rede. Ali você já viu o que é cada camada, como filtrar clientes e como consultar viabilidade. Aqui o foco é colocar a mão na massa: entender por que um cliente vira (ou não vira) um ponto no mapa, como cadastrar a estrutura física da sua rede diretamente desenhando sobre o mapa (caixas, splitters, cabos), e o que realmente acontece nos bastidores quando você reserva uma porta.

Público-alvo: quem vai operar o dia a dia do módulo — projetista de rede, equipe de campo e quem cadastra a planta de fibra no sistema.

1. Como um cliente aparece (e é posicionado) no mapa

O ponto do cliente no mapa não é um cadastro à parte: ele é calculado a cada carregamento da tela, a partir de dados que já existem em outras telas. Na prática, para um cliente aparecer como ponto, três condições precisam estar satisfeitas ao mesmo tempo:

1. O contrato precisa estar ativo — situação do contrato = Ativo e o estado do contrato não pode ser um estado final (por exemplo, contrato cancelado ou encerrado não entra na consulta que alimenta o mapa).
2. O login do contrato precisa ter latitude e longitude preenchidas — essas coordenadas vêm do endereço cadastrado no login/contrato do cliente. Sem latitude e longitude, o cliente simplesmente não entra na lista que o mapa desenha, mesmo estando ativo e em dia.
3. Opcionalmente, uma ONU de fibra ativa vinculada ao login — quando existe, o sistema busca automaticamente o sinal mais recente da ONU, a caixa e a porta em que ela está conectada, e usa isso para decidir o ícone do ponto (vira um ícone de roteador) e a informação de sinal exibida no balão.

Ou seja: a cor, a posição e o ícone do ponto não são configurados manualmente — eles refletem o que está cadastrado no contrato, no endereço e na ONU. Se algo está errado no mapa (cliente no lugar errado, cliente sumido, sinal desatualizado), o ajuste é feito na origem do dado, não no mapa:

O que está errado	Onde corrigir
Cliente não aparece	Ficha do cliente/contrato: preencher latitude/longitude do endereço, ou verificar se o contrato está mesmo ativo
Cliente aparece no lugar errado	Endereço do contrato/login — corrigir a geolocalização do endereço
Ícone não vira roteador / sem sinal	Cadastro da ONU (Fibra): confirmar que ela está com situação Ativa e vinculada ao login correto
Caixa e porta mostradas no balão erradas	Cadastro da própria ONU: caixa e porta exibidas vêm diretamente da ONU, não da Reserva de Porta

Detalhe importante: a caixa e a porta que aparecem junto do cliente no mapa (quando ele tem ONU) são as gravadas no cadastro da ONU — não a Reserva de Porta feita lá atrás na venda. Se o técnico que instalou o cliente usou uma porta diferente da que foi reservada, o mapa vai mostrar a porta real da ONU, e a reserva original continua registrada separadamente na tela de Reserva de portas até alguém atualizá-la.

2. Cadastrando a estrutura de rede direto no mapa (caixas, equipamentos e conexões)

Além de visualizar, o Mapa de Rede permite desenhar a sua planta de fibra por cima do mapa real, sem precisar abrir telas de cadastro separadas para cada item. O painel de desenho fica dentro da própria tela do mapa, geralmente identificado como "Desenho de Rede", com um botão para cada tipo de elemento:

• Cabo FO — desenha o traçado do cabo de fibra óptica ligando dois ou mais pontos.
• CTO (Caixa de atendimento) — a caixa que atende os clientes de uma região, com capacidade de portas.
• Poste — marca o poste no trajeto da rede.
• Caixa de Emenda (CE) — caixa que emenda cabos ao longo do percurso, sem atender cliente diretamente.
• POP — o ponto de presença central da rede.
• Armário, Antena e Polígono — elementos complementares para outros tipos de estrutura e áreas de cobertura.

Passo a passo para cadastrar um elemento

1. Abra o painel de Desenho de Rede no mapa.
2. Clique no botão do tipo de elemento que quer criar (por exemplo, CTO).
3. Clique no ponto do mapa onde o elemento fica fisicamente (para cabos, clique em cada ponto do trajeto e finalize o traçado).
4. Preencha o formulário que abre: Descrição é sempre obrigatória. Para uma CTO, informe também o Tipo de caixa, a Capacidade (quantidade de portas) e, se aplicável, o Transmissor/OLT de origem. Para um cabo, informe o tipo de cabo, cor, espessura, opacidade e se é reserva técnica.
5. Salve. O elemento passa a ficar visível na camada correspondente para todos que acessarem o mapa.

Para reposicionar ou editar um elemento já desenhado, use a opção de alterar o mesmo tipo de elemento no painel (ela entra em modo de edição do item existente em vez de criar um novo) ou dê duplo clique sobre o elemento no mapa.

Editando o "miolo" de uma CTO: portas, splitters e conexões

Clicar sobre uma CTO no mapa abre um balão com a descrição, endereço, capacidade e uma grade de portas disponíveis (ocupadas destacadas de forma diferente das livres) — é o jeito mais rápido de checar, olhando o mapa, se ainda há porta livre numa caixa perto de um cliente novo. O balão também traz dois botões:

• Abrir Caixa — abre o editor visual interno da caixa, onde você monta o diagrama de splitters e conexões: arrasta splitters para dentro da caixa, liga a entrada/saída de fibra aos conectores dos splitters e define por onde cada porta é atendida. É esse diagrama que alimenta a informação de porta ocupada/livre mostrada no balão.
• Editar Caixa no Sistema — abre o cadastro completo da caixa (módulo Fibra) em uma nova aba, para editar dados administrativos que não fazem parte do desenho (endereço formal, anexos etc.).

Atenção ao salvar o diagrama interno de uma caixa. Diferente de um cadastro comum, o diagrama de splitters e conexões de uma CTO é salvo como um conjunto: ao confirmar as alterações, o sistema substitui a configuração anterior daquela caixa pela nova. Evite fechar a aba, perder a conexão com a internet ou navegar para outra tela no meio de uma edição do diagrama — o ideal é terminar de montar toda a configuração da caixa (todos os splitters e conexões) antes de salvar.

Quando a caixa vem de um integrador (OzMap/GeoGrid) e já existe manualmente no Quaza

Se a sua empresa usa um integrador de mapa com importação automática de caixas e splitters, é comum que uma caixa que você já tinha desenhado manualmente no Quaza apareça duplicada depois de importar o cadastro do integrador. Para esses casos existe a ferramenta Fundir caixas, disponível na tela do Integrador de mapa:

1. Abra Mapa de Rede → Integrador e edite o integrador ativo.
2. Clique em Fundir caixas.
3. Para cada caixa importada do integrador, selecione a caixa correspondente já existente no sistema (o Quaza sugere um pareamento automático quando os nomes são parecidos).
4. Confirme. O sistema transfere para a caixa importada tudo o que estava vinculado à caixa antiga do sistema — ONUs, reservas de porta, portas de rede neutra, conexões, equipamentos internos e anexos — e remove a caixa antiga.

Não é possível selecionar a mesma caixa do sistema para duas caixas importadas diferentes; o sistema bloqueia essa combinação antes de confirmar a fusão.

3. O que é a Reserva de Porta e como ela se conecta à ativação da ONU

A Reserva de Porta é o registro que trava uma porta específica de uma CTO para um cliente, entre o momento em que a venda/viabilidade foi confirmada e o momento em que o técnico efetivamente conecta e ativa a ONU dele. Ela guarda:

• O integrador usado para reservar (é o integrador quem controla o status real da porta lá fora, no OzMap/GeoGrid);
• A caixa de atendimento e o número da porta reservados;
• O cliente e, quando já existe, o login do contrato vinculado;
• Opcionalmente, a oportunidade de venda do CRM que originou a reserva;
• Um código de integração, que é o identificador dessa reserva do lado do sistema externo — é por esse código que o Quaza sabe qual registro cancelar ou ativar no integrador.

A reserva sozinha não conecta o cliente — ela só existe para garantir que ninguém mais use aquela porta enquanto o atendimento está em andamento. Existe uma wiki específica para o fluxo de autorização/ativação de ONU (o passo a passo de vincular a ONU física ao login e colocá-la operante); este texto não repete aquele conteúdo, só mostra onde a Reserva de Porta se encaixa nele: a reserva normalmente é o passo anterior — feita na consulta de viabilidade, na ficha do cliente/contrato ou na oportunidade — e a ativação da ONU é o passo posterior, quando o técnico já está em campo conectando o equipamento.

Na tela Reserva de Portas (Mapa de Rede → Reserva de portas), a coluna Conexão mostra a ONU vinculada ao login daquela reserva quando ela já existe — é um jeito rápido de ver, direto na lista, quais reservas já viraram cliente conectado de fato e quais ainda estão apenas "seguradas".

As ações Ativar reserva e Cancelar reserva não são apenas uma troca de status dentro do Quaza: elas chamam o integrador de mapa de verdade (via a mesma integração usada na consulta de viabilidade) para confirmar a ocupação ou liberar a porta lá fora. Por isso:

• Uma reserva já Ativa não pode ser ativada de novo — o sistema bloqueia e explica que a reserva já está ativa.
• Uma reserva já Cancelada não pode ser cancelada de novo, pelo mesmo motivo.
• Sem um integrador ativo cadastrado, nenhuma das duas ações funciona — o sistema avisa que não há integração de mapas disponível.

4. Erros comuns

Situação	O que está acontecendo	Como resolver
Cliente some do mapa depois de uma migração/importação em massa de endereços	O mapa só desenha quem tem latitude/longitude preenchidas no login do contrato. Uma importação que não geocodificou os endereços deixa esses campos vazios.	Corrija/geocode o endereço na ficha do cliente ou do contrato. Não há ajuste possível direto no mapa — o dado de origem precisa ser corrigido.
"Nenhuma integração de mapa disponível" ao tentar ativar/cancelar uma reserva ou testar conexão	Essas ações (e a consulta de viabilidade) dependem de um integrador de mapa com situação Ativa. Sem isso, a chamada nem chega a sair para o OzMap/GeoGrid.	Cadastre ou reative um integrador em Mapa de Rede → Integrador. Lembre-se: só pode existir um integrador ativo por vez.
Caixa CTO aparece duplicada no mapa depois de configurar um integrador com importação automática de caixas	A importação trouxe do OzMap/GeoGrid uma caixa que já existia, desenhada manualmente, no Quaza.	Use Fundir caixas na tela do Integrador para unir a caixa importada com a caixa do sistema, preservando ONUs, reservas e o diagrama interno.
Edição do diagrama interno de uma CTO (splitters/conexões) "sumiu" depois de uma queda de conexão durante o salvamento	O diagrama interno é salvo como um conjunto único (a configuração anterior é substituída pela nova). Uma falha no meio do salvamento pode deixar a caixa com uma configuração parcial.	Reabra a caixa (Abrir Caixa) e refaça a montagem do diagrama até o fim antes de salvar novamente. Evite editar a mesma caixa em duas abas ao mesmo tempo.
Porta mostrada no mapa é diferente da porta que consta na Reserva de Porta	O balão do cliente no mapa mostra a caixa/porta gravadas na própria ONU, não a reserva original. Se o técnico ativou o cliente em outra porta, os dois registros ficam divergentes.	Confira e, se preciso, atualize a Reserva de Porta correspondente para refletir a porta realmente usada, ou trate isso como parte do processo de ativação de ONU.

5. Boas práticas para usar o mapa no planejamento de expansão

• Mantenha os endereços geocodificados antes de tirar conclusões do mapa. Um bairro sem clientes visíveis pode simplesmente ser um bairro sem latitude/longitude cadastrada, não um bairro sem clientes. Rode o Ajusta Bairro periodicamente para manter os nomes de bairro padronizados — isso também melhora a qualidade dos filtros usados no planejamento.
• Use a grade de portas disponíveis de cada CTO como termômetro de saturação. Antes de aprovar uma venda nova numa região, abra a caixa mais próxima no mapa e veja quantas portas ainda estão livres — é mais rápido do que consultar viabilidade caixa por caixa quando você já conhece a região.
• Desenhe a rede com a granularidade que você realmente vai manter atualizada. Cadastrar postes e caixas de emenda é opcional para a viabilidade funcionar (ela olha para as caixas com porta), mas ajuda MUITO o time de campo a enxergar o trajeto real do cabo quando for expandir ou consertar uma rota.
• Depois de ativar um integrador com importação de caixas, rode a fusão de caixas antes de continuar desenhando manualmente. Isso evita ter duas fontes de verdade (uma caixa "do Quaza" e uma "do integrador") competindo no mesmo ponto do mapa.
• Use o mapa de concentração para decidir onde vale a pena levar uma nova CTO ou aumentar capacidade. Áreas de alta concentração de clientes com caixas já no limite de portas são o sinal mais direto de que uma expansão ali se paga rápido.
• Trate a Reserva de Porta como parte do funil comercial, não só como controle técnico. Reservas antigas em situação Reservada (nunca ativadas) indicam vendas que pararam no meio do caminho — vale revisá-las periodicamente e cancelar as que não vão virar cliente, liberando a porta para outra oportunidade.