ADR 0012 — Modelo de dados unificado (rede física + OLT/ONU)¶

Status: Aceita · Data: 09/11/2026 · Proposta revisada: F1 — Modelo de dados

Contexto¶

Os dois sistemas antigos guardavam a mesma realidade em dois lugares: a documentação de rede tinha CTOs, portas e "clientes"; o provisionamento tinha ONUs com uma descrição de texto (vlan.cto.porta-cliente) que era a única ligação entre eles. Qualquer divergência entre os dois virava retrabalho em campo.

Decisão¶

A ONU é a entidade central e única: liga a OLT (porta PON) à rede física (porta da CTO) e carrega o nome do cliente. Não há cadastro de clientes.
Propriedade: Parceiro → VLAN → ONU. A VLAN principal da ONU define o dono; VLANs adicionais (raras) só do mesmo dono ou da operadora.
Cadeia física explícita: porta PON → fibra de saída → fusões → fibra de entrada do splitter → (cascatas) → porta da CTO → ONU. A porta PON de cada splitter é calculada por esse caminho, não digitada.
Caixas com tipo (CTO, CEO, DIO). Só CTO atende cliente; splitters podem ficar em caixas ou no POP/armário.
Geografia em geography (4326): comprimentos e distâncias em metros, sem projeção.
Sinal em dois níveis: leituras detalhadas por 90 dias (configurável) + resumo diário permanente.
Uma porta da CTO, uma ONU (restrição no banco). Ao provisionar numa porta ocupada, a ONU antiga fica "sem porta", com evento registrado.
Configurações em tabelas de registro único (formato da descrição, limiares, parâmetros ópticos), editáveis no admin e auditadas.

Consequências¶

A descrição na OLT passa a ser gerada a partir dos dados (formato configurável), e a divergência entre o gravado e o esperado é detectável.
A migração dos sistemas antigos (F5) precisa converter a descrição de texto em VLAN, CTO e porta, e apontar o que não casar.
Mudanças na rede (fusão, splitter, porta PON) disparam recálculo da origem dos splitters; em redes muito grandes pode virar tarefa em segundo plano.