# Changelog Todos los cambios notables en este proyecto serán documentados en este archivo. El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/), y este proyecto adhiere a [Semantic Versioning](https://semver.org/lang/es/). --- ## [1.5.0] - 2025-11-27 ### ✨ Añadido - **Configuración Avanzada de IPs Administrativas por Segmento**: Sistema completo de gestión de rangos administrativos personalizados por segmento. - Editor visual protegido por contraseña - Configuración JSON por segmento - Múltiples rangos iniciales y finales por segmento - Interfaz amigable para gestionar rangos - **Botón de Configuración Avanzada** (⚙️): Acceso rápido al editor desde la interfaz principal. - **Modal de Autenticación**: Protección por contraseña para acceso al editor. - **Fallback Inteligente**: Segmentos no configurados en JSON usan automáticamente rangos globales. ### 🔧 Mejorado - **AdminRangeHelper.php**: Nueva clase helper para procesar configuración JSON por segmento. - **IpSearchService.php**: Lógica mejorada con soporte para rangos personalizados y fallback. - **Validación de Cambios**: Advertencia al salir del editor con cambios sin guardar. ### 🎨 Interfaz - Editor visual completo con formularios dinámicos - Tabla de segmentos configurados - Agregar/eliminar rangos en tiempo real - Diseño responsive con soporte para temas claro/oscuro ## [1.4.0] - 2025-11-27 ### ✨ Añadido - **Rangos de IPs Administrativas Configurables**: Ahora puedes configurar qué rangos de IPs se consideran administrativas mediante 4 campos numéricos en la configuración del plugin (inicio/fin de rango inicial y final), en lugar de tener valores fijos (1-30 y 254). ### 🔧 Mejorado - **Flexibilidad**: Permite adaptar la clasificación de IPs según las necesidades específicas de cada red. - **Backend y Frontend**: Toda la lógica de clasificación ahora usa configuración dinámica. ## [1.3.3] - 2025-11-27 ### ✨ Añadido - **Modo Claro/Oscuro**: Botón toggle (☀️/🌙) en esquina superior derecha para cambiar entre temas con persistencia en localStorage. - **Tema Claro**: Paleta de colores profesional para uso diurno con fondo claro y textos oscuros. ### 🔄 Mejorado - **Tabla Móvil**: Optimizada para pantallas pequeñas ocultando columna "Tipo de IP" y mostrando el badge bajo la dirección IP (3 columnas en lugar de 5). - **Límite por Defecto**: Cambiado a 5 IPs para búsquedas más rápidas. - **Tipografía**: Direcciones IP más destacadas con fuente más grande y negrita. ## [1.3.2] - 2025-11-26 ### ✨ Añadido - **Botón de Cancelar Verificación**: Nuevo botón dinámico que aparece durante la verificación por ping, permitiendo detener el proceso en cualquier momento mientras se conservan los resultados ya obtenidos. ### 🔄 Mejorado - **Responsividad Móvil**: Optimizada la alineación de checkboxes en dispositivos móviles para una mejor experiencia visual. ## [1.3.1] - 2025-11-26 ### 🔄 Refinado - **Renderizado Secuencial**: Las IPs de cliente aparecen una por una en la tabla conforme se inician sus verificaciones, creando un efecto visual más limpio y ordenado. - **Limpieza de Resultados**: Si se selecciona un límite (ej. 5 IPs), la tabla solo muestra esas 5 IPs de cliente (más las administrativas), ocultando el resto del segmento. - **Textos UI**: Actualizados para mayor claridad ("Válida para cliente", "Sólo validada con UISP"). ## [1.3.0] - 2025-11-26 ### ✨ Añadido - **Carga Progresiva**: Los resultados de la búsqueda aparecen inmediatamente y la verificación por ping se realiza en segundo plano, actualizando el estado en tiempo real. - **Feedback Visual Mejorado**: Nuevos iconos de estado (⏳ Verificando, ✅ Disponible, ⚠️ En uso) en la tabla de resultados. - **Filtro de IPs Administrativas**: Nuevo checkbox para ocultar/mostrar IPs de administración (1-30, 254) al instante. ### 🔄 Mejorado - **Rendimiento**: La interfaz ya no se bloquea durante la verificación por ping. - **Experiencia de Usuario**: Se puede ver el progreso de la verificación IP por IP. --- ## [1.2.1] - 2025-11-26 ### ✨ Añadido - **Límite de IPs para verificación**: Nuevo selector para limitar la cantidad de IPs a verificar con ping (5, 10, 20 o Todas) - Evita timeouts en segmentos grandes - Prioriza IPs de cliente (las administrativas se muestran sin verificar cuando hay límite) - **Defaults mejorados**: Checkbox de verificación activado por defecto (si está habilitado en config) ### 🔄 Mejorado - **Optimización de verificación**: Al usar un límite, las IPs administrativas se excluyen del ping para acelerar el proceso - **Interfaz de usuario**: Feedback visual más claro sobre el límite aplicado --- ## [1.2.0] - 2025-11-26 ### ✨ Añadido #### Verificación por Ping - **Clase `PingService.php`**: Servicio de verificación de IPs mediante ping - Ping paralelo a múltiples IPs simultáneamente (hasta 30 IPs por lote) - Timeout configurable (default: 1 segundo) - Detección automática de disponibilidad del comando ping - Procesamiento en lotes para evitar sobrecarga de red - Fallback graceful si ping no está disponible - **Parámetro de configuración `enablePingVerification`**: Control global de verificación por ping - Modo opcional: usuario decide en cada búsqueda - Checkbox condicional en frontend (solo visible si está habilitado) - Parámetro `verify_ping` en API REST - **Detección de dispositivos no registrados**: Identifica IPs que responden a ping pero no están en UISP - Filtra automáticamente IPs que responden - Advertencias en logs para IPs no registradas - Estadísticas de ping en respuestas #### Integración - **Frontend**: Checkbox "Verificar con ping" (condicional según configuración) - Solo visible si `enablePingVerification` está habilitado - Integrado en formulario de búsqueda - Indicador de progreso durante verificación - **API REST**: Soporte para parámetro `verify_ping` en ambos endpoints - `event.ip_request`: Incluye estadísticas de ping en respuesta - `event.ip_check`: Indica si IP específica responde a ping - Campo `ping_verified` en todas las respuestas - Campo `ping_stats` con métricas detalladas ### 🔄 Mejorado - **`IpSearchService::buscarIpsDisponibles()`**: Ahora acepta parámetro `$verifyPing` - Integración transparente con `PingService` - Filtrado automático de IPs que responden - Logging detallado de resultados de ping - **Respuestas de API**: Información enriquecida con datos de ping - Estadísticas: total verificado, respondiendo, no respondiendo - Tiempo de ejecución de verificación - Lista de IPs que responden (posibles conflictos) ### 🔧 Técnico - **Ping paralelo**: Implementación usando procesos en background - Archivos temporales para capturar resultados - Espera asíncrona con timeout - Limpieza automática de archivos temporales - **Performance**: Optimizado para grandes rangos de IPs - Procesamiento en lotes de 30 IPs - Timeout total controlado - Mínimo impacto en tiempo de respuesta --- ## [1.1.0] - 2025-11-26 ### ✨ Añadido #### API REST Completa - **Endpoint `event.ip_request`**: Búsqueda de IPs disponibles en un segmento de red - Acepta parámetro `segment` para especificar el tercer octeto (0-255) - Retorna lista de IPs disponibles y en uso - Filtra automáticamente IPs administrativas (1-30, 254) - Incluye contadores de IPs disponibles, en uso y filtradas - **Endpoint `event.ip_check`**: Verificación de estado de una IP específica - Acepta parámetro `ip` con dirección completa (172.16.X.X) - Retorna estado: disponible, en uso o desconocido - Incluye información del tipo de IP (administrativa vs. cliente) - Proporciona recomendaciones de uso - **Soporte para webhooks**: Habilitado `supportsWebhookEvents: true` en manifest - **Manejo de peticiones JSON**: Detección automática de Content-Type para API vs Frontend #### Arquitectura y Código - **Clase `ApiHandlers.php`**: Manejadores dedicados para eventos de API REST - `handleApiRequest()`: Router principal de eventos - `handleIpRequest()`: Procesamiento de búsqueda de IPs - `handleIpCheck()`: Procesamiento de verificación de IPs - **Clase `IpSearchService.php`**: Servicio de búsqueda de IPs con lógica de negocio - `buscarIpsDisponibles()`: Búsqueda de IPs en segmento específico - `obtenerIpsEnUso()`: Obtención de IPs desde API UNMS - `isAdminIp()`: Método estático para detectar IPs administrativas - `getIpType()`: Método estático para obtener información del tipo de IP - **Sistema de filtrado de IPs**: Clasificación automática de IPs administrativas vs. cliente - Rango administrativo: .1-.30 y .254 - Rango cliente: .31-.253 - Etiquetas visuales en frontend - Filtrado automático en API REST #### Documentación - **README.md completo**: Documentación profesional del plugin - Guía de instalación y configuración - Documentación completa de API REST - Ejemplos de uso en múltiples lenguajes (cURL, PHP, JavaScript, Python) - Tabla de códigos de error - Troubleshooting y soporte - **CHANGELOG.md**: Archivo dedicado para control de versiones ### 🔄 Mejorado - **Separación de responsabilidades**: Lógica de negocio separada en clases dedicadas - **Manejo de errores mejorado**: Respuestas JSON estructuradas con códigos de error descriptivos - **Sistema de logging**: Logs más detallados y organizados para debugging - Registro de tipo de petición (HTML vs JSON) - Logging de eventos API procesados - Información de errores con stack traces - **Compatibilidad dual**: Frontend HTML y API REST funcionan simultáneamente - Detección automática del tipo de petición - Sin interferencia entre modos - **Validación de datos**: Validación robusta de parámetros en API - Validación de formato de IP - Validación de rangos de segmento - Mensajes de error descriptivos ### 🔧 Técnico - **Namespace PHP**: `SiipAvailableIps` para evitar conflictos - **Manejo global de errores**: Error handler para convertir errores PHP en respuestas JSON - **Configuración SSL**: Soporte para certificados autofirmados en desarrollo - **Timeouts configurados**: Timeouts de conexión y ejecución para API UNMS --- ## [1.0.1] - 2025-11-25 ### ✨ Añadido - **Frontend web moderno**: Interfaz de usuario con diseño responsive y atractivo - Diseño con gradientes y glassmorphism - Tipografía Google Fonts (Inter) - Animaciones suaves y micro-interacciones - Modo oscuro integrado - **Búsqueda de IPs por segmento**: Campo de entrada para tercer octeto - **Función copiar al portapapeles**: Botón de copia rápida para cada IP - Feedback visual al copiar - Compatible con navegadores modernos - **Estadísticas en tiempo real**: Contadores de IPs disponibles y en uso - Tarjetas de estadísticas visuales - Actualización dinámica tras búsqueda - **Integración con API UNMS**: Conexión directa con UISP Network - Obtención de IPs en uso desde dispositivos - Soporte para HTTPS - Manejo de errores de conexión ### 🔄 Mejorado - **Conexión con API UNMS**: Optimización de peticiones HTTP - Timeouts configurables - Mejor manejo de errores de red - Logging de respuestas - **Búsqueda de IPs**: Algoritmo optimizado para comparación de rangos - Ordenamiento de IPs por último octeto - Cálculo eficiente de IPs disponibles - Validación de segmentos (0-255) ### 🐛 Corregido - Mejoras en la estabilidad de conexión con API UNMS - Corrección de validación de segmentos fuera de rango - Fix en ordenamiento de IPs en tabla de resultados --- ## [1.0.0] - 2025-11-25 ### ✨ Lanzamiento Inicial #### Funcionalidades Core - **Búsqueda básica de IPs**: Funcionalidad principal del plugin - Búsqueda en rangos 172.16.X.x - Detección de IPs en uso - Cálculo de IPs disponibles - **Integración con UISP CRM**: Plugin nativo para UCRM - Instalación vía interfaz de plugins - Configuración desde panel de administración - Acceso desde menú de reportes - **Interfaz web básica**: Primera versión del frontend - Formulario de búsqueda simple - Tabla de resultados - Diseño básico responsive #### Configuración - **Parámetros de configuración**: - Dirección IP/dominio del servidor - Token de API UCRM - Token de API UNMS (opcional) - Modo debug - Nivel de logging #### Integración - **API UNMS**: Conexión con UISP Network para obtener IPs - **Sistema de logs**: Archivo `plugin.log` para debugging - **Compatibilidad**: UCRM 1.0.0+ y UNMS 1.0.0+ --- ## Tipos de Cambios - **✨ Añadido**: Para nuevas funcionalidades - **🔄 Mejorado**: Para cambios en funcionalidades existentes - **🐛 Corregido**: Para corrección de bugs - **🔧 Técnico**: Para cambios técnicos internos - **🗑️ Eliminado**: Para funcionalidades removidas - **⚠️ Deprecado**: Para funcionalidades que serán removidas - **🔒 Seguridad**: Para parches de seguridad --- ## Versionamiento Este proyecto sigue [Semantic Versioning](https://semver.org/lang/es/): - **MAJOR** (X.0.0): Cambios incompatibles con versiones anteriores - **MINOR** (0.X.0): Nueva funcionalidad compatible con versiones anteriores - **PATCH** (0.0.X): Correcciones de bugs compatibles con versiones anteriores --- **Última actualización**: 26 de noviembre de 2025