Configuración y ajustes

Índice de búsqueda

Índice de búsqueda

La búsqueda global de lazyit (la paleta de comandos ⌘K en la barra superior) funciona con un motor de búsqueda dedicado que mantiene un índice aparte de tus datos, tolerante a errores de tecleo. El índice abarca activos, artículos, usuarios, ubicaciones y aplicaciones. Esta página explica cómo se mantiene sincronizado el índice y qué hacer cuando se desfasa.

Cómo se mantiene actualizado el índice

Normalmente no tienes que pensar en el índice — lazyit lo mantiene al día por ti:

  • Sincronización en vivo. Cuando se crea, actualiza o elimina un registro, lazyit actualiza el índice en segundo plano. Esto es deliberadamente tolerante a fallos: si el motor de búsqueda no está disponible un momento, tu escritura igualmente se completa — la búsqueda solo se retrasa hasta que el índice se pone al día.
  • Autorreparación al arrancar. Cuando la aplicación arranca, espera a que el motor de búsqueda esté disponible, comprueba cada índice y reconstruye automáticamente, en segundo plano, cualquiera que falte o esté vacío. Esto cubre un primer despliegue y una actualización del motor de búsqueda (que arranca con un índice nuevo y vacío) sin ningún paso manual. No hace nada cuando los índices ya tienen datos, así que es seguro en un parque grande.
  • Reconciliación periódica. Un proceso en segundo plano reconstruye periódicamente los índices a partir de la base de datos para reparar cualquier desfase por una actualización en segundo plano que se haya perdido. La frecuencia es cada hora por defecto y un operador puede ajustarla.

Solo se indexan los artículos de la base de conocimiento publicados, así que el contenido de un borrador no puede aparecer en la búsqueda. Los registros borrados de forma lógica se quitan del índice, así que nunca aparecen en los resultados.

Cuando la búsqueda no devuelve nada

Si la búsqueda global no muestra resultados, distingue dos casos:

  • “Búsqueda no disponible”. El motor está caído o inaccesible. La búsqueda se degrada con elegancia y te lo indica, en lugar de fingir que no hay coincidencias. Suele resolverse solo cuando el motor vuelve; si persiste, comprueba que el servicio de búsqueda está en marcha. Consulta Servicios.
  • Resultados incompletos justo después de desplegar o actualizar. Una instancia recién desplegada, o cuyo motor de búsqueda se acaba de actualizar, arranca con los índices vacíos. La autorreparación al arrancar los reconstruye en segundo plano — dale unos minutos. Si después siguen faltando resultados, ejecuta una reindexación completa.

Reindexar

Una reindexación completa reconstruye todos los índices a partir de la base de datos. Es la reparación determinista para cualquier desfase. No hace falta tras un primer despliegue ni tras una actualización — de eso se encarga la autorreparación al arrancar. Se ejecuta desde el servicio de la API:

bun run reindex:all

Ejecútalo cada vez que sospeches que la búsqueda está desfasada (por ejemplo tras restaurar una copia de seguridad o tras una caída prolongada del motor de búsqueda). La reconstrucción es sin tiempo de inactividad — la búsqueda sigue sirviendo el índice antiguo hasta que el nuevo se intercambia.

La reindexación lee de tu base de datos existente y solo escribe en el índice de búsqueda; nunca cambia tus registros. Siempre es seguro ejecutarla.

Salud del índice, de un vistazo

  • Los registros nuevos y modificados aparecen en la búsqueda en cuestión de momentos — si no, el motor puede estar caído.
  • Tras un despliegue o una actualización, la búsqueda se completa sola en pocos minutos. Tras una restauración o una caída larga, ejecuta reindex:all para garantizar un índice completo.
  • “Búsqueda no disponible” se refiere al motor, no a tus datos — tus registros están intactos y las escrituras siguen funcionando.

Para ejecutar y supervisar el propio servicio de búsqueda, consulta Servicios y Solución de problemas.