Utilidades de Búsqueda

Utilidades de Búsqueda es la página de administración a nivel del sistema para la infraestructura de búsqueda de la plataforma. Muestra la salud en tiempo real de todos los componentes de búsqueda, presenta estadísticas del índice por tipo de entidad y proporciona botones de acción para operaciones de mantenimiento, incluyendo reconstrucciones completas del índice, reindexado por entidad y limpieza destructiva de caché. Utiliza esta página cuando los resultados de búsqueda estén desactualizados, incompletos, o cuando un microservicio reporte datos indexados faltantes.

Acceso a la Página

Ruta: /search-utilities
Ruta de Menú: Configuración → Sistema → Utilidades de Búsqueda
Audiencia principal: Solo administradores del sistema. Se accede mediante el inicio de sesión de administrador del sistema en system.portal.net — no el portal del tenant.

Qué puedes hacer aquí

Ver el estado de salud general del servicio de búsqueda y el estado de cada componente interno (Reconstrucción de Índice, Caché de Esquemas, Caché de Datos, Respaldo PostgreSQL, RabbitMQ).
Revisar estadísticas: total de esquemas registrados, total de entidades indexadas y conteos por tipo de entidad con su microservicio asociado y peso de puntuación de búsqueda.
Reconstruir el índice de búsqueda completo desde cero (destructivo — usar solo cuando otras acciones sean insuficientes).
Reindexar todos los tipos de entidad registrados en todos los servicios conectados en una sola operación.
Reindexar un tipo de entidad específico sin afectar a los demás.
Limpiar el índice de términos (destructivo — elimina todos los términos indexados; la búsqueda no estará disponible hasta que se complete el reindexado).
Limpiar el índice de un registro de entidad individual por tipo e ID (limpieza dirigida para una entrada corrupta u huérfana).

Tareas comunes

Abrir Configuración → Sistema → Utilidades de Búsqueda en system.portal.net.
Verificar la tarjeta de Salud — todos los componentes deben mostrar estado saludable. Si un componente no está saludable, investigar la causa raíz antes de ejecutar acciones de mantenimiento.
Revisar la tarjeta de Estadísticas para los conteos de entidades por tipo. Si un conteo es menor al esperado, ejecutar un reindexado dirigido para ese tipo de entidad.
Para resultados desactualizados generalizados en múltiples tipos de entidad, usar Reindexar Todos los Servicios.
Para un único tipo de entidad faltante o desactualizado, usar Reindexar Tipo de Entidad y seleccionar el tipo en el menú desplegable.
Verificar que el conteo de entidades en la tarjeta de Estadísticas haya vuelto al valor esperado después de que la operación se complete.

Notas

Las acciones que activan procesamiento asíncrono (Reindexar Todo, Reindexar Tipo de Entidad) envían un comando y regresan inmediatamente. La tarjeta de Estadísticas puede no reflejar el conteo actualizado hasta que termine el trabajo en segundo plano.
La acción Reconstruir Índice reconstruye el índice completo desde cero y muestra una barra de progreso en tiempo real. Se ejecuta de forma sincrónica y puede tardar varios minutos en conjuntos de datos grandes. Activarla solo cuando sea estrictamente necesario.
Limpiar Índice de Términos es irreversible y hace que la búsqueda no esté disponible hasta que se complete el reindexado. Se requiere un diálogo de confirmación. Usar solo como último recurso para corrupción catastrófica del índice.
Limpiar Entidad dirige a un único registro por tipo e ID. Elimina ese registro del índice de búsqueda sin afectar a los demás. Usarlo para resolver resultados de búsqueda duplicados o con datos obsoletos para un elemento específico.
El estado de RabbitMQ en la tarjeta de Estadísticas muestra si el servicio de búsqueda puede recibir mensajes de indexación asíncrona. Si está desconectado, las actualizaciones del índice en tiempo real no se procesarán — solo el reindexado manual actualizará el índice.

Utilidades Disponibles

Verificación de Salud

Muestra el estado en tiempo real de todos los componentes del servicio de búsqueda. Actualiza la tarjeta en cualquier momento usando el botón de actualización.

Componente	Qué reporta
Reconstrucción de Índice	Fecha y hora de la última reconstrucción completa, o advertencia si nunca se ha ejecutado una
Caché de Esquemas	Número de esquemas de entidad registrados en la caché
Caché de Datos	Número de entidades actualmente en caché en memoria
Respaldo PostgreSQL	Si la capa de persistencia de PostgreSQL está disponible y el conteo de entidades persistidas
RabbitMQ	Si la conexión al broker de mensajes está activa (Conectado / Desconectado)

Estadísticas del Índice

Muestra una tabla de todos los tipos de entidad registrados ordenados alfabéticamente. Para cada tipo, muestra:

Nombre visible — etiqueta localizada (recurre a la clave interna del tipo de entidad si no hay traducción registrada)
Microservicio — el servicio propietario del tipo de entidad
Peso de puntuación — el peso de relevancia de búsqueda relativo para este tipo
Conteo — total de registros indexados de este tipo

Reconstruir Índice

Elimina y reconstruye el índice de búsqueda completo. Una barra de progreso rastrea las entidades procesadas vs. el total y el porcentaje estimado de completitud. El último estado de reconstrucción (Completado, Fallido o En Ejecución) y la duración en segundos se muestran al finalizar.

Cuándo usarlo: el servicio de búsqueda reporta errores de esquema estructurales, o una reconstrucción anterior falló a mitad y dejó el índice en un estado inconsistente.

Reindexar Todos los Servicios

Envía un comando de reindexado a todos los microservicios registrados simultáneamente. Se activan tanto la indexación local en proceso como la reindexación remota asíncrona a través de RabbitMQ. Una notificación de éxito muestra el total de operaciones, dividido entre local y remoto.

Cuándo usarlo: los resultados de búsqueda están desactualizados en múltiples tipos de entidad después de una migración de datos, importación o despliegue.

Reindexar Tipo de Entidad

Selecciona un tipo de entidad específico del menú desplegable y haz clic en el botón de acción. Si la operación se maneja de forma asíncrona, se muestra una confirmación de “comando enviado”. Si se maneja de forma sincrónica, el conteo actualizado de entidades se muestra inmediatamente.

Cuándo usarlo: un tipo de entidad en particular (p. ej., Socios de Negocio o Artículos) muestra resultados faltantes o desactualizados mientras que otros tipos están saludables.

Limpiar Índice de Términos

Elimina permanentemente todos los términos indexados del índice de búsqueda. Un diálogo de confirmación advierte que la búsqueda no estará disponible hasta que el reindexado se complete. El diálogo requiere un clic de confirmación explícito para continuar.

Cuándo usarlo: el índice de términos está corrupto e impide que el servicio de búsqueda inicie correctamente. Siempre seguir esta acción con una operación de Reindexar Todos los Servicios o Reconstruir Índice.

Limpiar Entidad

Elimina un único registro del índice de búsqueda especificando su tipo de entidad e ID de registro. No se muestra diálogo de confirmación — la acción se ejecuta inmediatamente al hacer clic en el botón.

Cuándo usarlo: un registro específico aparece duplicado o muestra datos desactualizados en los resultados de búsqueda y un reindexado completo no es práctico.

Páginas Relacionadas

Microservicios — registro de servicios; verificar que todos los servicios estén activos y saludables antes de ejecutar operaciones de reindexado
Gestión de Tenants — cuando se alcance el contexto de búsqueda a un tenant específico