Precios y enlaces salen del catálogo
El catálogo se exporta desde la tienda en un commit fijo. La API verifica cada producto, precio y enlace antes de mostrarlo, y oculta un precio vencido en lugar de adivinarlo.
Caso de estudio · Proyecto para cliente
Pequeverso: una tienda con asistente de compras con IA
Una tienda en Next.js de recursos educativos imprimibles, un back office privado y un asistente de compras con IA que responde a partir del propio catálogo de la tienda.
3
repositorios públicosTienda, back office y API del asistente, cada uno con su propia CI.
288
casos de evaluación escritos a mano18 familias de intención que recorren todo el camino HTTP/SSE en CI con un modelo de prueba; validan el pipeline y los controles, no la calidad del modelo.
303
turnos con el modelo realUna ejecución de evaluación sobre una versión anterior del asistente, antes del lanzamiento.
USD 10
tope mensual de gasto en LLMValor configurable, reservado de forma atómica antes de cada llamada al modelo.
Trabajo independiente para un cliente. Desarrollé la tienda, el back office y la API del asistente; la marca, los productos y la decisión de lanzar el asistente son del cliente.
Tres aplicaciones para una tienda pequeña
Pequeverso vende recursos educativos imprimibles para familias con niños de 3 a 7 años. Desarrollé su tienda pública, un back office privado y un asistente de compras con IA que responde las preguntas de los compradores sobre el catálogo.
Hotmart se encarga del pago, la entrega y los reembolsos, así que la tienda puede concentrarse en explicar bien los productos y llevar a los compradores al checkout.
El problema
Los compradores tienen preguntas antes de pagar: qué incluye el kit, para qué edades sirve, cómo funciona la garantía. Un chatbot genérico puede inventar un precio, un descuento o un enlace, y en una tienda una respuesta equivocada es peor que ninguna.
Además, la tienda tenía que informar compras e intención de compra a Meta para la publicidad, y el asistente tenía que mantenerse dentro de un presupuesto mensual pequeño y fijo.
Qué desarrollé
La tienda: Next.js con checkout de Hotmart, Meta Pixel en el navegador y un relay de la Conversions API en el servidor, más una verificación automática después de cada publicación que confirma que producción sirve el commit integrado.
El back office: una app privada con inicio de sesión OAuth, roles solo por invitación y un panel de operaciones con la salud del asistente, la vigencia del catálogo, las ejecuciones, la latencia, los tokens y el gasto.
El asistente: GraphRAG sobre LangGraph que combina recuperación léxica, con pgvector y con Neo4j sobre el catálogo de la tienda. El servidor valida cada producto, precio y enlace antes de que llegue al comprador, y aplica un tope de gasto mensual antes de cada llamada al modelo.
Arquitectura
Tres aplicaciones, desde el navegador del comprador hasta el back office privado.
- TiendaNext.js, React y TypeScript. Páginas de producto, checkout de Hotmart y un panel nativo del asistente que permanece apagado hasta el lanzamiento.
- MediciónMeta Pixel en el navegador, replicado por un relay de la Conversions API en el mismo origen con los mismos IDs de evento.
- API del asistentePython y FastAPI. Sesiones con protección CSRF, respuestas transmitidas por SSE y un contrato HTTP versionado.
- RecuperaciónUn flujo acotado en LangGraph con recuperación léxica, pgvector y Neo4j, sobre un catálogo exportado desde la tienda.
- ControlesValidación en el servidor de productos, precios y enlaces, más reservas de presupuesto contra el tope mensual.
- Back officeNext.js con inicio de sesión OAuth y roles en PostgreSQL; lee los datos de operaciones de la API desde el servidor.
Decisiones de ingeniería
Un tope de gasto en cada solicitud
Antes de cada llamada al modelo, la API reserva el costo máximo posible contra el presupuesto mensual, así las solicitudes concurrentes no pueden superarlo. El tope predeterminado es de USD 10 al mes.
Evaluado antes del lanzamiento
288 casos escritos a mano en 18 familias de intención recorren todo el camino HTTP/SSE en CI. Una versión anterior también se evaluó en una ejecución de 303 turnos con el modelo real.
Las operaciones son privadas
El back office es una app separada. Solo pueden entrar el propietario y las personas invitadas, y lee desde el servidor datos de operaciones sin contenido de conversaciones, nunca desde el navegador.
Explora el producto
Capturas reales de los repositorios públicos: la tienda, el asistente ejecutándose en local con un modelo de prueba y el back office con datos sintéticos. Amplía una pantalla para ver el detalle.
16 / 16
Página de inicio de la tienda Pequeverso con el kit Grafismo Fonético, su precio y un botón de compra 
Página de soporte de la tienda con opciones de reembolso y contacto, y el botón del asistente en la esquina 
Panel del asistente en su tamaño real de escritorio, con bienvenida, preguntas sugeridas y el cuadro de mensaje 
Panel del asistente respondiendo una pregunta sobre la garantía con dos fuentes desplegadas, con un modelo de prueba 
Asistente abierto en la tienda mientras espera una respuesta, con un control para cancelar la solicitud 
Vista ampliada del asistente con la respuesta, sus fuentes, una ficha de producto con precio validado y materiales relacionados 
Asistente en un teléfono con la respuesta, las fuentes desplegadas, una ficha de producto y el cuadro de mensaje fijo 
Página de estado del back office en un teléfono, con disponibilidad y presupuesto restante marcados como datos sintéticos 
Resumen de disponibilidad del back office: acepta preguntas, presupuesto mensual restante, respuestas completadas y tiempo hasta el primer texto 
Resultados de solicitudes de las últimas 24 horas y 30 días, con percentiles de latencia, uso de tokens y códigos de fallo 
Presupuesto mensual con uso informado, gasto estimado y reservado frente al límite configurado, con datos sintéticos 
Últimas ejecuciones con estado, modelo, idioma, latencia e identificadores sintéticos opacos, sin contenido de conversaciones 
Panel del catálogo con la revisión de la tienda, la última sincronización verificada, la ventana de precios y los documentos indexados 
Gráficos de actividad diaria con ejecuciones y costo por día, y la tabla de datos accesible debajo 
Informe de actividad del sitio con nueve eventos sintéticos y filtros por período, página, sección y ancho de pantalla 
Página de accesos del back office para invitar personas con un rol y revocar invitaciones pendientes, con cuentas de prueba
Estado actual
La tienda está en línea en pequeverso.com, y cada publicación a producción se verifica automáticamente después del despliegue.
El asistente está implementado y evaluado, pero todavía no se lanzó. Sigue desactivado en la tienda publicada hasta que su servidor esté desplegado y se apruebe el lanzamiento.
Evidencia
Tienda en líneapequeverso.com, con checkout de Hotmart (se abre en una pestaña nueva)Código de la tiendaTienda en Next.js en GitHub (en inglés) (se abre en una pestaña nueva)Código del back officeApp privada de operaciones, código público en GitHub (en inglés) (se abre en una pestaña nueva)Código de la API del asistenteBackend con FastAPI y LangGraph en GitHub (en inglés) (se abre en una pestaña nueva)
Los tres repositorios son públicos. La aplicación del back office es privada y sus capturas usan datos sintéticos.