docs: document virtual (logical-only) nodes

docs-es/v2.0/configuration-es.md

@@ -123,6 +123,41 @@ Para redes sin nodos padre (sin puntos de acceso o sitios estrictamente definido
 echo "{}" > network.json
 ```
 
+#### Nodos virtuales (solo lógicos)
+
+LibreQoS soporta **nodos virtuales** en `network.json` para agrupar y para monitoreo/agregación en la WebUI/Insight. Los nodos virtuales **no** se incluyen en el árbol físico de shaping HTB (no crean clases HTB y no aplican límites de ancho de banda).
+
+Para marcar un nodo como virtual, configura `"virtual": true` en ese nodo. (Compatibilidad heredada: `"type": "virtual"` también se reconoce, pero se recomienda `"virtual": true` para poder mantener un `"type"` real como `"Site"` o `"AP"`.)
+
+Ejemplo:
+
+```json
+{
+  "Region": {
+    "downloadBandwidthMbps": 1000,
+    "uploadBandwidthMbps": 1000,
+    "children": {
+      "Town": {
+        "virtual": true,
+        "downloadBandwidthMbps": 500,
+        "uploadBandwidthMbps": 500,
+        "children": {
+          "AP_A": {
+            "downloadBandwidthMbps": 200,
+            "uploadBandwidthMbps": 200
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+Notas:
+- Durante el shaping, los nodos virtuales se eliminan y sus hijos se promueven al ancestro no virtual más cercano (revisa `queuingStructure.json` para el plan físico activo).
+- `ShapedDevices.csv` aún puede usar un nodo virtual como `Parent Node` para mostrar/agrupar; LibreQoS adjuntará esos circuitos para shaping al ancestro no virtual más cercano (si el nodo virtual está en el nivel superior y no tiene ancestro no virtual, se tratará como sin nodo padre para el shaping).
+- Evita colisiones de nombres después de la promoción (dos nodos con el mismo nombre terminando al mismo nivel).
+
 #### Consideraciones de CPU
 
 <img width="3276" height="1944" alt="cpu" src="https://github.com/user-attachments/assets/e4eeed5e-eeeb-4251-9258-d301c3814237" />

docs-es/v2.0/troubleshooting-es.md

@@ -95,6 +95,12 @@ Una vez que haya identificado el error y corregido ShapedDevices.csv y/o network
 
 ```sudo systemctl start lqos_scheduler```
 
+### Colisión al promover nodos virtuales (network.json)
+
+Si LibreQoS.py falla con un error como `Virtual node promotion collision: 'AP_A' already exists at this level.`, tienes un nodo con `"virtual": true` cuyos hijos se promueven a un nivel padre donde ya existe un nodo con el mismo nombre.
+
+Renombra uno de los nodos en conflicto (los nombres deben ser únicos entre hermanos después de la promoción), o reestructura la jerarquía para que los hijos promovidos no colisionen.
+
 ### Error de segmentación (segfault) en systemd
 
 Si experimenta un segfault en systemd, este es un problema conocido en systemd [1](https://github.com/systemd/systemd/issues/36031) [2](https://github.com/systemd/systemd/issues/33643).