21. Editor del mapa operativo de topología

• El mapa de clientes es la capa Clientes: muestra ubicación, estado, dirección, IP, teléfono, NAP/puerto, señal y otros datos del servicio.
• La topología relaciona esa capa con inventario real: Cajas NAP, Postes, OLT, MikroTik, Emisores / monitores, Cables y Zonas.
• Los cables operativos se guardan en network_links. No son simples líneas decorativas.
• Las NAP, OLT, routers, emisores y servicios proceden de sus registros operativos. Moverlos cambia sus coordenadas reales.
• Diseño heredado muestra GeoJSON histórico de network_designs en modo de consulta. Activarlo no crea inventario, conexiones ni asignaciones.

Advertencia: ocultar una capa no elimina sus datos. Del mismo modo, dibujar una línea en Diseño heredado en una versión anterior no demuestra que exista un cable operativo ni que un cliente ocupe un puerto NAP.

Ejemplo ficticio para esta sección:

• poste: POSTE-CENTRO-001, código PC-001;
• zona: Barrio Centro Piloto;
• enlace: Troncal Centro 12F;
• NAP: NAP-CENTRO-01, 16 puertos;
• cliente: Ana Pérez Pruebas, servicio #9001;
• OLT: OLT-CENTRO-01.

No use estos identificadores ni coordenadas de ejemplo en producción.

Para abrir el mapa se requiere clientes.mapa. La interfaz combina ese permiso con los siguientes:

• crear Nueva NAP, Nuevo poste o Nueva zona: gestion_red.monitoreo.nuevo;
• mover entidades, editar atributos, cables, trazados y polígonos: gestion_red.monitoreo.editar;
• eliminar NAP, postes, cables o zonas: gestion_red.monitoreo.eliminar.

Sin permiso de edición, el mapa continúa siendo consultable y el inspector de un cable muestra Modo de consulta: no tienes permiso para editar este cable. No intente ejecutar la acción por fuera del panel: las validaciones se repiten en servidor.

Controles principales:

• Seleccionar: consulta elementos y, con permiso, permite arrastrarlos.
• Navegar: desplaza el mapa sin mover inventario accidentalmente.
• Extensión: encuadra la red cargada.
• Nueva NAP, Nuevo poste, Nueva zona, Conectar y Vértices: herramientas de edición.
• Deshacer y Rehacer: historial limitado de la sesión actual.
• Tabla: abre las pestañas Clientes, NAP, Postes, OLT, MikroTik, Emisores, Zonas y Cables.
• Actualizar: vuelve a solicitar la topología.

Use Router, Emisor y Zona para limitar el ámbito. El cuadro Cliente, NAP, OLT, IP… filtra clientes y filas visibles. La tabla puede redimensionarse desde el borde superior o maximizarse; su altura se conserva en el navegador.

En Contenido puede activar o desactivar:

• Clientes;
• Cajas NAP;
• Postes;
• OLT;
• MikroTik;
• Emisores / monitores;
• Cables;
• Zonas;
• Diseño heredado.

La selección se conserva localmente en el navegador. Los mapas base son Calles (OpenStreetMap), Satélite (Esri World Imagery) y Topográfico (OpenTopoMap). Si Satélite o Topográfico falla, vuelva a Calles; los tiles públicos no ofrecen capacidad o disponibilidad garantizadas.

Validación:

1. Active una capa por vez y compruebe su contador.
2. Abra Tabla y compare el número y los identificadores.
3. Seleccione una fila; el mapa debe centrar el elemento.
4. Pulse Actualizar para confirmar que los cambios persistieron.

1. Seleccione Nuevo poste.
2. Haga clic en la ubicación real.
3. En Nuevo poste, complete:
   • Nombre: POSTE-CENTRO-001, obligatorio, máximo 120 caracteres;
   • Código: PC-001, opcional, máximo 80;
   • Material: Concreto, Madera, Metal, Fibra u Otro;
   • Altura (m): opcional, entre 1 y 100;
   • Propietario: opcional, máximo 120;
   • Estado: Activo, Planeado, Dañado o Inactivo;
   • Notas: opcional, máximo 2.000 caracteres.
4. Pulse Guardar.
5. Confirme Poste registrado; ya puede conectarse con cables.
6. Seleccione el poste > Atributos para corregir sus datos.

Para eliminar, seleccione el poste > Eliminar poste > Eliminar. El servidor bloquea la eliminación si tiene cables conectados. Retire o migre cada enlace primero.

• después de moverlo, use Deshacer en la misma sesión;
• después de editar atributos, reponga manualmente los valores documentados;
• una eliminación no tiene Deshacer: recree el poste y sus cables a partir del registro previo.

1. Seleccione Nueva zona.
2. Marque al menos tres vértices.
3. Haga doble clic para terminar.
4. En Registrar zona:
   • elija Zona existente sin polígono para completar un registro pendiente;
   • o elija Crear zona nueva y escriba Nombre de zona nueva, por ejemplo Barrio Centro Piloto.
5. Pulse Guardar.
6. Compruebe en Tabla > Zonas que Polígono indique Dibujado.

Para editar:

1. Seleccione la zona.
2. Pulse Editar polígono o active Vértices y seleccione la zona.
3. Arrastre un punto para moverlo.
4. Haga doble clic sobre la geometría para agregar un punto.
5. Haga doble clic sobre un vértice para eliminarlo.
6. Espere Polígono de zona actualizado.

El servidor exige un Polygon GeoJSON, coordenadas dentro de latitud -90..90 y longitud -180..180, y entre 3 y 1.000 vértices. La interfaz no permite dejar menos de tres.

Para eliminar, seleccione la zona > Eliminar zona. Solo se elimina si no tiene clientes asignados.

1. Seleccione Nueva NAP.
2. Haga clic en su posición real.
3. En Nueva caja NAP, complete:
   • Nombre: NAP-CENTRO-01, máximo 150;
   • Número de puertos: 1 a 512;
   • Potencia de llegada (dBm): opcional, -60 a 10;
   • Ubicación o referencia: máximo 500.
4. Pulse Guardar.
5. Confirme Caja NAP registrada en inventario.
6. Seleccione la NAP y revise Puertos, Conectados, Potencia de llegada y Disponibles.

Para editar, seleccione la NAP > Atributos. No reduzca Número de puertos por debajo del puerto ocupado más alto; el servidor rechazará el cambio.

Para eliminar, use Eliminar NAP. La confirmación advierte que no se puede deshacer y el servidor solo la elimina si no tiene clientes conectados. Al eliminarla también se retiran sus cables, por lo que debe exportar y revisar los enlaces antes.

1. Seleccione Conectar.
2. Elija el primer extremo.
3. Cuando aparezca Ahora selecciona el segundo extremo, elija el segundo.
4. Para una conexión admitida, se abre Registrar cable.
5. Complete:
   • Nombre: Troncal Centro 12F, máximo 120; si queda vacío se genera uno;
   • Tipo: feeder, distribution, backbone, drop o wireless;
   • Capacidad / hilos: 1 a 100.000;
   • Estado: active, planned, damaged o inactive;
   • Color;
   • Grosor: 1 a 12;
   • Notas: máximo 2.000 caracteres.
6. Pulse Guardar.
7. Seleccione el cable y valide origen, destino, longitud calculada, capacidad, estado y notas.

Combinaciones admitidas por la interfaz:

• NAP–OLT, NAP–NAP, NAP–router y OLT–router;
• NAP–poste, OLT–poste, poste–poste y poste–router;
• antena–servicio, antena–router y antena–poste;
• NAP–servicio, mediante el flujo especial de asignación de cliente.

Un enlace no puede conectarse consigo mismo. Los extremos deben existir. El trazado debe ser un LineString GeoJSON de 2 a 500 vértices. La ocupación se limita a la capacidad. Si se conectan otra vez los mismos extremos, el sistema actualiza/repara el enlace existente en lugar de crear un duplicado.

Para cambiar datos, seleccione el cable > Atributos. Para cambiar el recorrido, use Editar trazado o Vértices:

• clic sobre un segmento: agrega un vértice;
• arrastrar un vértice: lo mueve y guarda;
• doble clic sobre un vértice: lo elimina;
• un cable debe conservar al menos dos vértices.

Para eliminar, use Eliminar > Eliminar. Esta acción borra el enlace de la topología, no desconfigura fibra ni equipos físicos.

Este procedimiento modifica el servicio real: actualiza NAP/puerto y crea o sincroniza la acometida.

1. Confirme que la NAP y el cliente tienen coordenadas correctas.
2. Seleccione el cliente.
3. Pulse Asignar a NAP.
4. El mapa cambia a Conectar y solicita Selecciona una caja NAP.
5. Seleccione la NAP.
6. En Vincular cliente a [NAP], revise el cliente y elija Puerto NAP.
7. Pulse Guardar.
8. Espere Cliente vinculado y acometida registrada.
9. Pulse Actualizar y valide:
   • NAP y puerto en el inspector del cliente;
   • puerto marcado como ocupado;
   • cable drop entre NAP y servicio;
   • ausencia de una segunda ocupación del mismo puerto.

La operación usa una transacción con bloqueo. Rechaza puertos fuera del rango u ocupados por otro servicio. Para NAP–cliente, el cable queda forzado a tipo drop, capacidad 1 y ocupación 1.

1. Si el servicio tenía una NAP/puerto anterior, vuelva a asignarlo a esa NAP y ese puerto, siempre que siga libre.
2. Confirme que el puerto asignado por error quedó libre y que la acometida se sincronizó.
3. Si debe dejar el servicio sin NAP, hágalo desde la edición funcional del servicio; el editor del mapa no ofrece una acción Desasignar NAP.
4. La asignación no entra en Deshacer/Rehacer.

Solo se puede mover inventario con Seleccionar y permiso de edición. Navegar mueve el mapa, no los marcadores.

1. Active Seleccionar.
2. Arrastre una NAP, poste, OLT, MikroTik, emisor/monitor o cliente.
3. Suelte en la posición correcta.
4. Espere Ubicación y cables actualizados.
5. Pulse Actualizar y confirme las coordenadas en Inspector.
6. Revise todos los cables conectados: el editor ajusta el primer o último vértice al nuevo extremo.

Al mover un cliente o una NAP también se sincronizan las acometidas NAP–cliente. Use Deshacer inmediatamente si el punto fue incorrecto. Si la sesión ya se cerró, restaure las coordenadas documentadas manualmente.

1. Active Diseño heredado en Contenido.
2. Compare sus líneas grises discontinuas con Cables.
3. Use el diseño solo como referencia para localizar trazados pendientes.
4. Cree enlaces operativos con Conectar; no edite la línea heredada.
5. Desactive la capa para la validación final y confirme que la red sigue representada mediante inventario y cables reales.

La migración técnica de diseños históricos exige auditoría por consola y no es una acción del editor. Solo deben migrarse nodos que coincidan inequívocamente con entidades reales; los demás deben permanecer como referencia.