Known issues

Huecos y deuda conocida del proyecto — para no redescubrirlos investigando desde cero.

Lista viva de cosas que un desarrollador nuevo (humano o IA) redescubriría investigando desde cero si no quedaran anotadas aquí.

Infraestructura

infra/management-vpn/ no está versionado. Solo existe descrito en el CLAUDE.md raíz (servidor IKEv2/L2TP-IPsec en ecfera.cloud). Ver VPN de gestión.
FreeRADIUS sin routers reales apuntando. infra/freeradius/ está desplegado y verificado end-to-end, pero ningún Mikrotik de producción lo usa todavía — ver FreeRADIUS para el procedimiento de migración gradual pendiente.
Migraciones no corren solas en producción — ver Base de datos.

NOTIFICATION_QUEUE y MONITORING_QUEUE están definidas pero no conectadas a ningún processor — ver Colas (BullMQ).

Rutas registradas pero sin entrada en el menú lateral (/servicios, /regulacion) — parecen legado o acceso interno/indirecto. Si necesitas usarlas, navega por URL directa.
El orden de las secciones del sidebar es reordenable por el usuario y se persiste en localStorage (valwisp.sidebar.navOrder) — el orden visual real puede variar por usuario, no asumas un orden fijo al dar soporte.

Solo 14 de 49 módulos tienen tag/descripción manual en DocumentBuilder (main.ts) — el resto aparece agrupado en Scalar únicamente por el @ApiTags() de cada controller, sin descripción adicional.
fumadocs-openapi (generación de una página MDX por endpoint, automática desde /openapi.json) no está integrado en este sitio de documentación todavía — ver API REST → Endpoints.