Como documentar a rede de fibra óptica do seu provedor

O técnico mais antigo da equipe pede demissão numa sexta-feira, e na segunda o provedor percebe que ele levava na cabeça um mapa mental de quase toda a rede de distribuição do bairro mais antigo da cidade: qual CTO atende qual rua, onde fica exatamente aquela caixa de emenda enterrada há três anos, qual fusão específica já deu problema duas vezes. Nada disso estava escrito em lugar nenhum acessível para o resto da equipe. Esse tipo de situação não é raro — é a norma em provedores que cresceram rápido sem parar para transformar conhecimento de campo em documentação estruturada, e o custo dela só aparece quando já é tarde para evitar.

O que "documentar a rede" realmente significa

Documentar não é ter um desenho bonito da rede guardado em algum computador. É manter um registro vivo, acessível e atualizado de três camadas de informação que se conectam entre si: a geografia (onde cada elemento físico está localizado), o estado operacional (quantas portas de cada CTO estão ocupadas, qual a potência óptica em cada trecho) e o histórico (quando cada fusão foi feita, por quem, com qual perda registrada). Faltando qualquer uma dessas três camadas, a documentação vira só um retrato parcial que ajuda pouco na hora real de um chamado técnico.

As peças que compõem a documentação completa

• Mapa georreferenciado: a posição real de cada poste, CTO, caixa de emenda e rota de cabo, sobreposta a um mapa ou imagem de satélite.
• Registro de ocupação por CTO e por OLT: quantas portas estão em uso, quantas livres, para não vender instalação num ponto que já está no limite.
• Registro de fusões: cada emenda óptica, com data, técnico responsável, perda medida e posição exata na bandeja da caixa de emenda.
• Orçamento de potência óptica por trecho: quanto de sinal se perde do início ao fim de cada rota, para saber a margem restante antes de aceitar mais uma divisão.
• Histórico de manutenção: quais pontos já tiveram reparo, rompimento por terceiros ou reforma, e quando.

Por que o mapa sozinho não basta

Um mapa bonito no Google Earth mostra por onde a fibra passa, mas não responde perguntas operacionais do dia a dia: quantas portas ainda sobram naquela CTO específica, qual foi a perda da última fusão feita ali, se aquele trecho já está no limite do orçamento de potência óptica. Documentação de rede de verdade cruza geografia com esses dados operacionais — sem isso, o mapa é uma fotografia estática que envelhece rápido e não ajuda muito além de "mostrar onde fica" o quê já foi desenhado no passado. E quanto mais a rede cresce, maior a distância entre o mapa estático e a realidade física que ele deveria representar.

Passo a passo para levantar a documentação do zero

1. Reúna o que já existe, mesmo que fragmentado: arquivos KML soltos, planilhas antigas, fotos de instalação, memória da equipe técnica mais experiente.

2. Valide em campo o que está desatualizado — postes que mudaram de lugar, CTOs remanejadas, rotas que já não existem mais do jeito que foram projetadas originalmente.

3. Registre cada CTO com sua capacidade real de portas e o número atualmente ocupado, não uma estimativa aproximada.

4. Documente cada fusão existente que for possível confirmar, com a perda medida na época da instalação, se esse dado sobreviveu em algum registro.

5. Centralize tudo num sistema com banco de dados por trás, não em arquivos soltos espalhados entre computadores diferentes da equipe.

6. Estabeleça a rotina daqui para frente: toda fusão nova, toda CTO instalada, todo remanejamento de rota precisa virar registro no mesmo dia, não "quando sobrar tempo".

KML/KMZ: a porta de entrada mais comum

Para provedores que já têm alguma documentação, mesmo que informal, o formato mais comum de origem é o KML/KMZ — o padrão de arquivo geográfico usado pelo Google Earth e por praticamente qualquer ferramenta de geoprocessamento do mercado. Importar esses arquivos existentes para um sistema que mantenha a rede viva é geralmente o ponto de partida mais rápido, porque aproveita o trabalho de projeto já feito em vez de redesenhar a rede inteira do zero. O caminho inverso também importa: exportar a rede em KML quando é preciso apresentá-la a uma prefeitura ou a uma concessionária de energia para negociar compartilhamento de infraestrutura, conforme discutido em regras como a Resolução 614 da Anatel sobre compartilhamento de postes.

O mito de que documentação é trabalho de projeto, não de operação

Existe a ideia de que documentar a rede é responsabilidade do time de projeto no momento da obra, e que depois disso a documentação "está pronta". Na prática, rede FTTH muda o tempo todo: fusão de reparo feita às pressas numa emergência, CTO remanejada porque um poste foi trocado, splitter substituído por um de razão diferente numa expansão. Se a documentação não é atualizada como parte da rotina operacional — e não só no momento da instalação original — ela começa a divergir da realidade física em poucos meses, e o problema se agrava silenciosamente até um chamado técnico expor a diferença. Tratar documentação como tarefa contínua da equipe de campo, com o mesmo peso de uma instalação ou de um reparo, é o que evita esse apagão de informação se repetir a cada troca de funcionário.

Fusões documentadas em board visual, não em planilha perdida

O ponto mais frágil da documentação tradicional costuma ser justamente o registro de fusões: a informação mais técnica e mais difícil de reconstruir depois do fato. O ZISP resolve isso com um board visual de cada caixa de emenda, mostrando a posição exata de cada fusão na bandeja, a perda registrada e o técnico responsável, tudo ligado ao mesmo mapa de rede FTTH onde ficam postes, rotas e CTOs — com suporte a importação e exportação de KML/KMZ para aproveitar o que já foi projetado antes. Em vez de abrir uma planilha desatualizada ou ligar para o técnico que fez o serviço, a equipe abre o board daquela caixa específica e vê exatamente o que foi feito ali. Veja como funciona em sistema.zisp.com.br.