Ferramentas de documentação para provedores de internet

O técnico mais antigo da equipe pede demissão numa sexta-feira. Na segunda, ninguém sabe explicar por que a CTO 14 do bairro Jardim das Flores está com três portas puladas, nem onde fica o backup da configuração do Mikrotik que segura a rede daquele setor inteiro. Isso não é exagero — é rotina em provedor pequeno, porque a documentação, quando existe, mora na cabeça de uma ou duas pessoas. Enquanto a empresa é pequena, funciona. No dia em que alguém sai, adoece ou simplesmente esquece, o provedor descobre o preço de nunca ter escrito nada.

Documentar não é burocracia de empresa grande. É o que separa um provedor que sobrevive à saída de um funcionário-chave de um que trava a operação por semanas tentando reconstruir informação que já existiu um dia.

Por que a documentação vira ponto cego em provedor pequeno

No começo, o dono sabe tudo: cada CTO, cada cliente difícil, cada senha de rádio. Conforme a base cresce, esse conhecimento devia migrar para algum lugar formal — mas raramente migra, porque documentar parece menos urgente do que instalar o próximo cliente. O resultado é uma empresa que roda no "perguntar pro Fulano", e quando Fulano tira férias, adoece ou muda de emprego, a operação trava. Isso vale tanto para a rede física quanto para processos administrativos: forma de calcular comissão, modelo de contrato, procedimento de suspensão por atraso. Se está só na cabeça de alguém, não é processo — é sorte.

O que documentar primeiro (nem tudo tem a mesma urgência)

Nem todo provedor tem tempo para documentar tudo de uma vez. A ordem de prioridade costuma ser:

• Topologia de rede: onde fica cada CTO, splitter, caixa de emenda e qual OLT/porta atende cada região. Sem isso, todo chamado técnico vira investigação do zero.
• Configuração de equipamentos críticos: Mikrotik, OLT, switches de core — com backup de configuração e não só a senha decorada.
• Contratos e modelos jurídicos: contrato de prestação de serviço, comodato de equipamento, termos que a empresa usa oficialmente.
• Processos financeiros: como funciona a régua de cobrança, quem aprova desconto, como é calculada comissão de vendedor.
• Procedimentos de atendimento: script de triagem de suporte, critérios para abrir ordem de serviço, o que escalar e para quem.

Rede primeiro, porque é o que mais rápido vira prejuízo quando falta — e mapear infraestrutura com precisão também facilita a vida na hora de negociar compartilhamento de postes ou justificar investimento junto a entidades como a ABRINT, que reúne boa parte dos provedores regionais do país.

Documentação de rede: o caso mais crítico

Fibra óptica sem mapa documentado é o exemplo mais caro de conhecimento tácito. A rede existe fisicamente, mas só na memória de quem passou o cabo. Isso trava expansão (ninguém sabe se sobra porta de splitter numa CTO sem ir lá fisicamente), atrasa reparo (procurar rompimento sem mapa é caminhar a rua atrás de poste) e vira problema sério quando o técnico que documentou tudo "de cabeça" sai da empresa. Um mapa em KML/KMZ, com CTO, splitter e trajeto de cabo marcados, transforma isso em informação consultável por qualquer pessoa da equipe, não só por quem instalou.

Ferramentas que resolvem cada tipo de documentação

Não existe uma ferramenta única que documenta tudo — cada camada pede uma abordagem diferente:

1. Mapas de rede georreferenciados: Google Earth/KML para visualização simples, ou um sistema de gestão com mapa de rede nativo para provedores que já têm centenas de CTOs.

2. Wiki interna: Notion, Confluence ou até uma pasta bem organizada no Drive, para processos administrativos e scripts de atendimento — desde que alguém mantenha atualizado.

3. Backup automatizado de configuração de rede: scripts que salvam a config do Mikrotik periodicamente, para não depender de "alguém lembrar de exportar".

4. Repositório de contratos e modelos: um lugar único para os PDFs de contrato/comodato vigentes, versionado, sem "contrato_final_v3_agora_sim.docx" espalhado pelo computador de cada um.

5. Planilha compartilhada como último recurso: melhor que nada, mas frágil — sem controle de quem editou o quê por último, e fácil de sobrescrever sem querer.

Passo a passo para começar a documentar sem parar a operação

Ninguém para a empresa duas semanas para documentar tudo. O jeito realista é fatiar:

1. Escolha uma frente por vez — comece pela rede, que costuma doer mais rápido.

2. Defina o formato mínimo viável (não precisa ser perfeito: um KML com os pontos principais já resolve 80% do problema).

3. Delegue a atualização para quem executa a tarefa no dia a dia (o técnico que instala documenta a CTO que acabou de mexer, não fica para "depois").

4. Audite periodicamente — uma vez por mês, confira uma amostra da documentação contra a realidade.

5. Torne a consulta parte do fluxo de trabalho: se o técnico só olha o mapa quando dá pane, ele nunca vira hábito.

O mito de que documentação é coisa de empresa grande

Um erro comum é achar que documentar só compensa quando o provedor já tem centenas de funcionários. É o oposto: quanto menor a equipe, mais cara é a dependência de uma única pessoa saber tudo. Numa empresa grande, o conhecimento se dilui entre muita gente; numa pequena, ele se concentra em duas ou três pessoas — e a saída de qualquer uma delas é um risco operacional real, não hipotético.

E se a equipe não tiver tempo para manter isso atualizado?

Essa é a objeção mais comum, e é legítima: documentação que não é mantida vira pior que nenhuma documentação, porque passa confiança falsa. A saída não é abandonar o esforço, é reduzir o escopo até caber na rotina. Prefira um mapa de rede sempre atualizado a um manual de 40 páginas que ninguém abre. E prefira ferramentas que documentam como efeito colateral do trabalho normal — por exemplo, um sistema em que provisionar uma ONU já registra automaticamente a CTO de origem — a processos que exigem uma etapa extra manual que a equipe vai pular na correria.

Antes de perder mais uma informação para a memória de alguém

Se a rede do seu provedor só existe de forma completa na cabeça de um técnico específico, isso não é sorte que vai durar para sempre — é uma dívida que a empresa está acumulando sem perceber. O ZISP documenta a rede FTTH em mapa com KML/KMZ, registra fusões e permite consultar CTO, splitter e trajeto de qualquer ponto sem depender de quem instalou. Conhecer o sistema.zisp.com.br é um bom passo para tirar esse conhecimento da cabeça das pessoas e colocar num lugar que a empresa toda pode consultar.