A CTO (Caixa de Terminação Óptica / caixa FTTH) é onde os clientes são conectados na rua, via portas (o drop de fibra que vai até a casa). Esta tela cadastra as CTOs, mostra a ocupação (quem está em cada porta) e alimenta o provisionamento de ONT (a "Caixa FTTH" + "Porta FTTH" escolhidas lá vêm daqui).
📍 Onde fica (mesma tela nos dois painéis):
- Admin: Infraestrutura → Ctos
- Help Desk: Infraestrutura → Ctos
Botões no topo: Criar e Mapa (CTOs).
# Gerenciar CTOs
¶ A lista de CTOs
Colunas visíveis: Nome, OLT, PON, Capacidade. Pelo botão de colunas dá pra mostrar também POP, Rack, Slot, RX Médio, Latitude/Longitude, Anotações, Criado/Atualizado em.
- Capacidade = número total de portas da caixa (8, 16, 32…).
- OLT / PON = de onde vem a fibra (a porta óptica da OLT que alimenta a CTO).
- RX Médio = sinal óptico médio da caixa (dBm).
¶ Filtros (botão Filtros)
- Projeto · Olts · PON — por localização/equipamento.
- Sem PON · Sem OLT · Sem Coordenadas — saneamento: acha CTOs com cadastro incompleto (sem vínculo de fibra ou sem localização no mapa).
- Período de Cadastro — faixa de datas.
¶ Mapa (CTOs)
O botão Mapa (CTOs) abre o Mapa de Infraestrutura — mostra as CTOs (e opcionalmente CEOs, postes, cabos e logins) nas coordenadas cadastradas, com a ocupação de cada caixa (portas usadas/total). Dá pra filtrar por projeto, buscar por nome/código e criar/editar/remover elementos direto no mapa.
💡 Pra a CTO aparecer no mapa, precisa ter Latitude e Longitude preenchidas (use o filtro "Sem Coordenadas" pra achar as que faltam).
¶ 
¶ Criar / Editar uma CTO
¶ Localização (de onde vem a fibra)
- OLT (obrigatório) — a OLT que alimenta a caixa. Ao escolher, libera o Slot.
- Slot — placa da OLT.
- PON (obrigatório) — a porta óptica (PON) da OLT onde a CTO está conectada.
¶ Informações
- Nome (obrigatório) — ex: "CTO-001".
- Capacidade — quantas portas a caixa tem (define quantas posições a ONT pode ocupar).
- RX Médio — sinal óptico médio (dBm).
- Descrição / Anotações — observações livres.
- Latitude / Longitude — coordenadas (para o mapa).
¶ Imagens
- Imagens — fotos da caixa (múltiplas), seção recolhível.
¶ 
¶ Ocupação — aba ONTs
Ao abrir uma CTO, a aba ONTs lista quem está conectado em cada porta, ordenado pela posição:
| Coluna | O que mostra |
|---|---|
| Posição CTO | a porta da caixa (Posição 1, 2, 3…) |
| Login | o usuário/cliente naquela porta |
| Patrimônio / Serial / MAC | identificação da ONT (clique para copiar) |
| Modelo | modelo da ONU |
| Sinal RX | sinal do cliente — 🟢 melhor que −20 · 🟡 −20 a −25 · 🔴 −25 ou pior |
| Índice PON | ID da ONU na PON da OLT |
| Status | ✅ provisionada / ❌ não provisionada |
Assim você vê rapidamente quantas portas estão ocupadas e quais estão livres.
¶ Ação em massa: Enviar Notificação
Selecionando ONTs na aba, o botão Enviar Notificação manda uma mensagem (WhatsApp / E-mail / SMS) para os clientes daquela caixa — útil para avisar manutenção/queda que afeta a CTO inteira. A mensagem aceita variáveis: {cliente}, {cliente_completo}, {email}.
¶ Liga com o provisionamento de ONT
Quando você provisiona uma ONT (ver Provisionar ONU), os campos Caixa FTTH e Porta FTTH vêm daqui:
- Caixa FTTH = a CTO.
- Porta FTTH = a posição na CTO. As posições ocupadas aparecem com o login/cliente que está nelas; as livres aparecem como "(livre)".
Por isso manter a Capacidade e a ocupação corretas é o que evita ligar dois clientes na mesma porta.
¶ Situações comuns
| Situação | O que fazer |
|---|---|
| Ver quem está numa caixa | Abrir a CTO → aba ONTs |
| Caixa não aparece no mapa | Preencher Latitude/Longitude (filtro "Sem Coordenadas") |
| Caixa sem fibra vinculada | Filtro Sem OLT / Sem PON → editar e vincular OLT/PON |
| Avisar clientes de uma caixa (queda/manutenção) | Aba ONTs → selecionar → Enviar Notificação |
| Cliente novo precisa de porta | Conferir portas livres na aba ONTs antes de provisionar |
⚠️ A Capacidade limita as portas disponíveis no provisionamento. Se estiver errada (menor que o real), faltam posições; se maior, oferece portas que não existem.