Fibra / GPON — Provisionamento da Red Óptica — Como o Quaza gestiona OLTs, caixas, ONUs e la cadeia até el cliente final
Esta wiki explica o módulo Fibra — el sistema que conecta la red óptica (OLT/splitter/ONU) al cadastro do cliente, automatizando la provisão.
Tela "ONU" — gestão central
Visão geral — la red GPON
El módulo Fibra de Quaza gestiona toda la cadeia óptica: desde la OLT (Transmisor) en el POP, pasando por as Caixas de Atendimento (splitters), até as ONUs en casa do cliente.
┌─────────────┐ fibra ┌──────────────┐ fibra ┌──────────────┐
│ OLT │──────▶│ CAJA DE │──────▶│ ONU │
│ (Transmisor) │ 1:N │ ATENCIÓN │ 1:N │ (cliente) │
│ POP │ │ (splitter) │ │ MAC + LOID │
└─────────────┘ └──────────────┘ └──────────────┘
│ │
▼ ▼
┌──────────┐ ┌──────────────┐
│ PERFIL │ ◀──── aplicado a la ONU ───── │ ContratoLogin│
│ (QoS) │ │ (cliente) │
└──────────┘ └──────────────┘
Cuando uma nova ONU es descoberta por la OLT, fica en "No Autorizada" até que un técnico la vincule con un cliente (ContratoLogin), defina perfil QoS e caixa física.
Glossário — vocabulário óptico
| Termo |
Significado |
| ONU |
Optical Network Unit — equipo en casa do cliente. Identificada por MAC o LOID. |
| OLT |
Optical Line Terminal — concentrador en el POP. Sirve até 32-64 ONUs por porta PON. |
| Transmisor / Punto Transmisor |
OLT física + ubicación (POP). |
| Caixa de Atendimento |
Caixa con splitter óptico (1:8, 1:16, 1:32, 1:64). Distribuye la fibra a as casas. |
| Perfil |
Script de configuração GPON aplicado a la ONU (varía por fabricante). |
| FlowProfile |
Perfil QoS — tasa de download/upload por servicio. |
| LOID |
Identificador lógico de ONU (alternativa al MAC, usado por alguns fabricantes). |
| Sinal RX/TX |
Potencia óptica recebida (RX) e transmitida (TX), medida en dBm. Valores típicos: -8 a -28 dBm. |
| Rede Neutra |
Otro ISP usa nuestra infraestrutura de fibra — Quaza fatura por porta al parceiro. |
| ONU No Autorizada |
ONU detectada por la OLT pero ainda sin vinculação a cliente. |
Telas e seus propósitos
| Tela |
Para que serve |
| ONU |
Gestão central de ONUs ativas — buscar, editar, ver histórico de sinales, autorizar/eliminar. |
| ONU No Autorizada |
Triagem de ONUs descobertas por la OLT. Aquí vinculas a cliente, perfil e caixa. |
| Perfil |
Scripts GPON por transmisor + fabricante. Cada marca tem seu sintaxis. |
| Punto Transmisor / OLT |
Cadastro de OLTs (IP gerencia, FTP backup, EMS, versão firmware). |
| Caixa de Atendimento |
Splitters con capacidad, georreferência, sinal disponible. |
| ONU Histórico |
Serie temporal de sinales (TX/RX/temperatura/voltagem) para diagnóstico. |
| ONU Modelo |
Catálogo de modelos de ONU (marca, série, características). |
| Rede Neutra Parceiro |
Vincular contrato/cliente al parceiro que usa nuestra infraestrutura. |
Fluxo de provisionamento de uma ONU
1 Descoberta: OLT enxerga ONU nova (MAC), Quaza registra en fibraOnuNaoAutorizada con slotno/ponno.
2 Triagem "No Autorizada": Admin abre la tela, vincula:
-
idLogin → ContratoLogin (cliente)
-
idPerfil → script GPON
-
idCaixa → caixa física
- FlowProfile (QoS), CoS
3 Autorização: Botón "Autorizar" dispara Service\Fibra\Onu::autorizar() → tarefa CRON aplica configuração.
4 Aplicação: Service\Fibra\Fibra::aplicar() → factore por fabricante (Fiberhome/Huawei/ZTE/...) → envía comandos vía TELNET/API/SSH.
5 Ativação: ONU pasa a fibraOnu con status=ATIVA. Remueve MAC reservado. Contrato pasa de PRECADASTRO a ATIVO.
Integrações con outros módulos
-
Cliente / Contrato: ONU.idLogin → ContratoLogin → Cliente. Sin contrato, sin ONU ativa.
-
RADIUS / Concentrador (Challenger): ONU pode ser provisionada vía RADIUS (PPPoE) o IPoE — depende do modo.
-
Rede: ONU usa Grupo de rede (banda) para FlowProfile.
-
Tarefa CRON: tarefas
fibraonuverificar, fibraaplicar, fibraonuprecadastrar automatizan polling/aplicação.
-
Importación CSV/FTP:
fibraonuimportar.php permite carga en masa de ONUs nuevas.
Pegadinhas frequentes
Pegadinha 1 — Modelo de ONU es obligatorio: Si el modelo muda entre marcas, el script de configuração (Perfil) também cambia. Uma ONU Huawei con script Fiberhome no se aprovisiona — falha silenciosa.
Pegadinha 2 — ONU "Concluida" en triagem: El campo concluida marca que el provisionamento terminó. Si está en false, la ONU sigue "incompleta" embora parezca ativa.
Pegadinha 3 — Histórico ≠ Histórico de Alteraciones: OnuHistorico guarda sinales (TX/RX) — es time-series. OnuHistoricoAlteracao guarda quem/quando cambió qué — es auditoría. No confundir.
Pegadinha 4 — Sinal RX baja = problema en el cliente: Si RX en la ONU es mue bajo (ej. -28 dBm), el cliente verá instabilidade. Usar ONU Qualidade para alertar automáticamente quando salir de os limites.
Pegadinha 5 — Rede Neutra fatura aparte: ONUs vinculadas a RedeNeutraParceiro temn faturamento separado (por porta). No mezcla con fatura do cliente final.
Galeria de telas
Fibra onu
Fibra onunaoautorizada
Fibra perfil
Fibra pontotransmissor
Fibra caixaatendimento
Fibra onuhistorico
Fibra onumodelo
Fibra redeneutra
FAQ
Como começar a usar este módulo?
Configure os pré-requisitos listados acima, faça um teste em ambiente seguro (ou com poucos registros), valide com a equipe, e só então ative em produção.
Preciso de permissão especial pra acessar?
Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com o administrador do Quaza.
Posso integrar com sistemas externos?
Via API REST do Quaza. Webhooks notificam eventos importantes. Consulte a equipe técnica para credenciais.
O que acontece se houver erro?
Os logs ficam no painel de tarefas/auditoria. Configure alertas (email/Slack) para falhas críticas — não confie em ninguém olhar log manualmente.
Como acompanhar mudanças?
Cada registro tem histórico (timestamp, usuário, ação). Use o filtro de auditoria pra rastrear modificações suspeitas.
O módulo funciona multi-filial?
Sim — via centro de custo (filial) atribuído ao lançamento. Relatórios filtram por filial.
Documentos relacionados
Perguntas frequentes
¿La ONU se autoriza sola?
Depende de OnuConfiguracao. Si AUTORIZACAO_AUTOMATICA, sí — sino, admin deve abrir "No Autorizada".
¿Qué hago si la OLT no descubre ONU nova?
1) Verificar fibra e splitter; 2) Comprobar tarefa CRON fibraonuverificar ativa; 3) Ver log da OLT.
¿Puedo cambiar el plan do cliente sin reprovisionar la ONU?
Sim — muda el FlowProfile vía tela ONU. La aplicação re-envía apenas el comando QoS.
¿Quantos fabricantes soporta?
17+ (Fiberhome, Huawei, ZTE, Intelbras, Parks, VSOL, Datacom, Nokia, Cianet, etc.) — cada uno con script propio.