Casos de uso: Búsqueda inteligente, vistaúnica, catálogo
Industrias: Comercio minorista
Productos: Atlas deMongoDB, Búsqueda en Atlas deMongoDB, Búsqueda vectorial en Atlas deMongoDB, Integracionesde Voyage AI
Resumen de la solución
Activar datos es un desafío en muchos sectores. El Comercio Unificado combina datos de múltiples canales en una capa operativa para ofrecer información precisa y accesible a los equipos internos y a las aplicaciones de los clientes.
Figura 1. Estrategia de comercio unificado
Con esta solución, puede crear una aplicación de asociado de tienda con MongoDB como ODL para una estrategia de Comercio Unificado. Esta solución ofrece una mejor experiencia al cliente y permite visibilidad del inventario, búsqueda avanzada y consultas geoespaciales.
Para lograr estos beneficios, primero es necesario romper con los sistemas aislados.
Los sistemas aislados y los datos fragmentados generan ineficiencias
Los minoristas suelen utilizar sistemas aislados, lo que significa que los datos se almacenan en diferentes plataformas y tecnologías. Esta fragmentación limita la visibilidad y dificulta el acceso de los empleados de la tienda a la información en tiempo real. Como resultado, responder a las preguntas de los clientes depende de otros departamentos y de sistemas obsoletos.
Los empleados de tienda también tienen que revisar manualmente el almacén, lo que provoca retrasos e información incorrecta. Estas ineficiencias minan la confianza del cliente y perjudican su experiencia.
Una base de datos sólida para superar las brechas
Un ODL combina datos de sistemas existentes como inventario, pedidos y perfiles de clientes, y los pone a disposición en una capa unificada. MongoDB Atlas sirve como el ODL. Su modelo orientado a documentos flexible maneja estructuras de datos diversas y complejas de diferentes sistemas y evoluciona a medida que el negocio cambia. Esta capacidad unifica los datos sin esquemas rígidos ni transformaciones complejas.
Almacenar sus datos en MongoDB impulsa la innovación de las siguientes maneras:
Búsqueda integrada e inteligencia artificial: Las funciones nativas de búsqueda de texto completo, vectorial e híbrida permiten la innovación interna, como el descubrimiento inteligente de productos y las recomendaciones personalizadas. Esta base de datos también impulsa RAG, asistentes basados en LLM y sistemas multiagente.
La pila tecnológica se simplifica: MongoDB almacena datos operativos e incrustaciones vectoriales en un solo lugar, lo que reduce la complejidad y elimina herramientas de propósito único como bases de datos vectoriales o motores de búsqueda.
Acceso en tiempo real a datos unificados: las aplicaciones pueden conectarse fácilmente a MongoDB Atlas para consumir datos sincronizados en tiempo real para los asociados de la tienda.
Figura 2. Las tres capas en cada aplicación.
Enfoque del modelo de datos
Los entornos minoristas son dinámicos, con detalles de productos e inventario en constante cambio. El modelo de documentos flexible de MongoDB gestiona fácilmente las configuraciones de las tiendas, incluyendo datos geoespaciales, de series temporales y jerárquicos. Esto crea una base sólida para un comercio unificado.
Figura 3. Aspectos esenciales de ODL: modelo flexible, sincronización en vivo, búsqueda inteligente
Esta solución equilibra simplicidad y rendimiento, permitiéndole modelar datos operativos y de búsqueda para casos de uso minorista. Así es como se modelan los datos:
Un canónico
inventoryLa recopilación rastrea datos de stock en tiempo real para cada producto en las tiendas, optimizados para escrituras de alta frecuencia.Una colección
productsoptimizada para lectura integra una matrizinventorySummaryligera con disponibilidad a nivel de tienda. Esto es ideal para un filtrado rápido, la representación de la interfaz de usuario y las consultas de búsqueda.Una sincronización basada en activadores mantiene los resúmenes de inventario actualizados en tiempo real, mediante activadores de MongoDB Atlas.
Figura 4. Esquema del producto: Texto, metadatos y vectores
Este esquema está validado para su rendimiento en el 50rango de almacenamiento. Para escenarios de mayor escala, puede adaptar el modelo de la siguiente manera:
Obtenga el inventario a nivel de tienda de forma dinámica como parte de la consulta.
Reestructurar las rutas de escritura y lectura con otras estrategias de modelado.
Arquitectura de referencia
Esta demostración utiliza una aplicación principal en Next.js y un microservicio de búsqueda avanzada dedicado. Contiene los siguientes componentes:
MongoDB Atlas: centraliza todos los datos, permite la sincronización en tiempo real y proporciona la infraestructura para el rendimiento, la disponibilidad y la seguridad.
Aplicación principal con Next.js: Aplicación full-stack que maneja la UI y la consulta geoespacial para encontrar tiendas cercanas con stock disponible.
Microservicio de búsqueda avanzada con FastAPI: un backend dedicado que maneja todos los tipos de búsqueda, como texto, semántica e híbrida, y coordina la incrustación de consultas.
Proveedor de incrustaciones con Voyage AI: genera incrustaciones vectoriales para búsqueda semántica.
Figura 5. Detrás de la demostración: Diagrama del sistema de la aplicación de asistentes de tienda con MongoDB y Voyage AI
En particular, el microservicio de búsqueda avanzada hace que la lógica de la demostración sea más clara y adaptable. Esta configuración ofrece las siguientes ventajas:
Diseño en capas: Esta solución utiliza un microservicio compuesto por interfaces para la API, una aplicación para la lógica de negocio y una infraestructura para la integración con MongoDB y Voyage AI. Esta estructura mantiene la modularidad del código base, lo que facilita las pruebas, el escalado y la adaptación. También se pueden reemplazar servicios externos, como cambiar de Voyage AI a Bedrock, actualizando únicamente la capa de infraestructura.
Flexibilidad de IA: la capacidad de cambiar entre proveedores como Voyage AI o Bedrock usando un adaptador.
Compatibilidad multicanal: una única API compatible con todas las plataformas frontend, incluidas la web, los dispositivos móviles y los chatbots, que permite poner los canales en línea con el mínimo esfuerzo.
Capacidades de microservicios de búsqueda
El microservicio de búsqueda proporciona una API unificada para gestionar múltiples mecanismos de recuperación, incluidos:
Búsqueda de expresionesregulares: coincidencia de patrones básicos utilizada como base para comparar con las funciones de búsqueda avanzada de MongoDB.
Búsqueda de texto completo: utiliza MongoDB Atlas Search para coincidencias difusas, campos potenciados y filtrado a nivel de tienda.
Búsqueda de vectores semánticos: encuentra productos conceptualmente similares utilizando incrustaciones de Voyage AI.
Búsquedahíbrida: Combina resultados de texto y vectoriales mediante RRF. Ajusta el peso del texto y la relevancia semántica según el contexto de búsqueda.
Figura 6. Desglose de la estrategia de búsqueda: texto, vectores y búsqueda híbrida.
Puede aprender a utilizar el marco de agregación para personalizar las capacidades de búsqueda revisando estos archivos.
Con MongoDB, unifica las capacidades de búsqueda en una sola plataforma, combinando precisión, comprensión semántica y datos en tiempo real. Como resultado, atiende a los compradores con mayor rapidez, empodera a los equipos de la tienda y escala en todos los canales.
Construir la solución
Para reproducir esta demostración en su propio entorno, siga estos pasos:
Crea tu base de datos en MongoDB Atlas
Inicie sesión en MongoDB Atlas.
Ponga en marcha un clúster de nivel gratuito.
Crea una base de datos llamada retail-unified-commerce o actualiza tu .env si estás usando otro nombre.
Clonar el repositorio
Clone este repositorio de GitHub ejecutando el siguiente comando.
git clone https://github.com/mongodb-industry-solutions/retail-unified-commerce.git
Importar colecciones de demostración
Después de clonar el repositorio, navegue a la carpeta con los datos de muestra.
cd retail-unified-commerce/docs/setup/collections
Allí encontrará los archivos JSON para importar a MongoDB Atlas: un conjunto de datos de muestra de 500 productos comestibles con inventario a nivel de tienda y vectores incorporados de Voyage AI:
inventory.jsonproducts.jsonstores.json
En Atlas, vaya a Browse CollectionsCree cada colección y luego haga clic en Add Data para insertar sus documentos desde los archivos JSON.
Configura tus índices
En la colección products, crea:
En la stores colección, cree un índice geoespacial.
Configurar la sincronización del inventario en tiempo real (opcional)
Agrega inventory_sync y daily_inventory_simulation Atlas Triggers para integrar actualizaciones en tiempo real en tu colección de inventario. Estas características simulan transacciones en vivo y mantienen los datos sincronizados con la colección products.
Agregar variables de entorno
Copie cada .env.example archivo a .env en los directorios frontend y advanced-search-ms.
Pegue su cadena de conexión Atlas y agregue su clave API de VoyageAI en el archivo advanced-search-ms/.env para habilitar la búsqueda basada en incrustación.
VOYAGE_API_KEY=your_voyage_api_key
Para garantizar comparaciones de vectores precisas y significativas, utilice el mismo proveedor de incrustación para sus datos y consultas de usuario. Si cambia de proveedor, deberá volver a generar los vectores, crear un nuevo índice, actualizar el .env archivo con la nueva clave API y ajustar la implementación del puerto de incrustación en la capa de infraestructura.
Construya y ejecute la aplicación con Docker Compose
Comprueba que tienes instalados Docker y Docker Compose, y que estás en la raíz de la carpeta del proyecto retail-unified-commerce. Desde allí, inicia la aplicación con el siguiente comando.
make build
Después de ejecutar la aplicación:
Abra su navegador y vaya a http://localhost:3000 para usar la aplicación de demostración.
Consulte la documentación de la API de microservicio en http://localhost:8000/docs o lea el archivo README.
Verifique el estado del microservicio en http://localhost:8000/health.
Puede utilizar estos comandos para controlar su implementación de Docker:
Detenga su aplicación: detenga todos los contenedores y elimine las imágenes con el siguiente comando:
make clean Ver registros: realice un seguimiento de la implementación de su aplicación y visualice cómo se mueven sus datos entre capas con el siguiente comando:
make logs
Aprendizajes clave
El comercio unificado genera confianza en la tienda: MongoDB permite acceder en tiempo real al estado de los estantes, la ubicación del stock y los datos de reposición. Al combinar la búsqueda inteligente con la visibilidad multicanal, proporciona a los empleados de la tienda las herramientas necesarias para ofrecer servicios consistentes e informados que impulsan la confianza y la conversión de clientes.
Un ODL convierte datos fragmentados en información útil: MongoDB actúa como ODL, consolidando datos aislados en una única fuente en tiempo real. Su modelo de documentos flexible se adapta a diversas estructuras minoristas, y su seguridad, disponibilidad y rendimiento integrados lo convierten en un recurso de nivel empresarial.
Los datos unificados permiten la búsqueda avanzada y las aplicaciones de IA: MongoDB unifica la búsqueda de texto completo, semántica y geoespacial en un solo lugar. También puede almacenar sus datos en tiempo real e incrustaciones juntos, lo que permite el descubrimiento en tiempo real e impulsa casos de uso de IA inteligente para el futuro.
Autores
Prashant Juttukonda, MongoDB
Florencia Arin, MongoDB
Angie Guemes, MongoDB
Diego Canales, MongoDB
Obtén más información
Para descubrir cómo MongoDB impulsa la innovación en el comercio minorista, visita MongoDB para comercio minorista.
Para saber cómo el comercio unificado beneficia a los minoristas, lea el blog de Comercio unificado para la innovación minorista con MongoDB Atlas.
Para explorar ODL con Atlas en detalle, consulte el documento técnico de la capa de datos operativos.