Los identificadores divergen
Un producto no se puede vincular, deduplicar o rastrear de forma fiable cuando sus identificadores entran en conflicto.
Casos de estudio
Búsqueda ecommerce / Sistemas de producto
La calidad de búsqueda empieza antes de buscar.
SearchSignal es un framework inspeccionable de preparación de catálogo que detecta los problemas de datos que condicionan la búsqueda ecommerce antes de que una persona escriba una consulta.
Demostrador sintético desplegado
KeywordSemanticHybrid
01
Walnut writing desk
eligibleIn stock · $1,299.00 · Walnut
ReadinessPassNormalization4 rules
01 / Premisa
Las interfaces de búsqueda heredan la calidad de la información que tienen debajo.
Ranking, filtros, sinónimos y recuperación semántica dependen de un catálogo que se pueda interpretar con consistencia. Si un registro tiene identificadores en conflicto, disponibilidad poco clara, precios mal formados o descripciones mínimas, el problema viaja hacia abajo. Después aparece como resultados irrelevantes, filtros rotos, productos que desaparecen y depuración sin un punto de partida claro.
Source record
sku WDN-04?
price $1,299
availability maybe
material walnut / wood
Canonical record
externalId WDN-04
price 129900 USD
availability in_stock
material walnut
Eligible for search02 / Problema
La búsqueda ecommerce suele fallar antes de llegar a la búsqueda.
Los datos de catálogo cambian bajo presión comercial y suelen llegar desde más de una fuente. Una migración o un nuevo modelo de recuperación puede exponer inconsistencias que ya estaban presentes. SearchSignal permite inspeccionarlas antes de que afecten a una experiencia de cliente.
Los hechos se vuelven ambiguos
Precio, disponibilidad y atributos pierden significado cuando su formato u origen no está claro.
La recuperación amplifica vacíos
Los métodos semánticos pueden hacer más influyente una información fuente escasa o mal estructurada, no más completa.
03 / Insight estratégico
La elegibilidad para búsqueda es una decisión de producto.
SearchSignal cambia el orden de trabajo. Evalúa si un producto tiene información válida e interpretable suficiente para sostener una experiencia de búsqueda antes de entrar en un índice. Un registro puede existir en un catálogo y aun así ser un mal candidato para recuperación.
¿Este producto debería poder buscarse?
04 / Sistema
Un camino visible del registro fuente al resultado.
Cada fase emite evidencia que conecta calidad de origen, decisiones de indexación y resultados de recuperación. El framework no trata la búsqueda como un problema aislado de interfaz.
- 01Catálogo fuente
Los registros ficticios conservan su estructura y sus restricciones.
- 02Mapear
Los campos pasan a un contrato de producto canónico.
- 03Validar
Se comprueban la evidencia requerida y la estructura.
- 04Normalizar
Reglas nombradas estandarizan valores interpretables.
- 05Evaluar
La preparación se evalúa según la información disponible.
- 06Elegibilidad
La admisión o rechazo conserva evidencia visible.
- 07Recuperar
Los productos elegibles se exploran con tres modos deterministas.
- 08Evaluar
Las consultas golden permiten comparar el comportamiento.
05 / Experiencia de producto
Tres superficies, un argumento.
La experiencia pública convierte un flujo técnico en una historia de producto legible sin afirmar que el demostrador es infraestructura de producción.
Landing
Explica el framework y el límite de demostración sintética.
Demo de búsqueda
Explora productos ficticios con recuperación por keyword, semántica determinista e híbrida.
Consola de preparación
Muestra escenarios de catálogo, validación, normalización, preparación, elegibilidad y admisión a indexación.
06 / Diseñar para explicar
Una decisión sirve más cuando su evidencia es visible.
SearchSignal evita correcciones ocultas y automatización opaca. Quien cuida el catálogo debe poder entender un cambio, bloqueo o admisión.
- Las reglas de normalización nombradas muestran cómo cambió un valor.
- Las decisiones de elegibilidad conservan la evidencia tras el estado.
- El comportamiento determinista hace reproducible una misma entrada.
- Los errores de proveedor y configuración siguen siendo controlados y legibles.
07 / Decisiones de producto
Las restricciones forman parte del producto.
Determinista por defecto
El comportamiento crítico de catálogo y elegibilidad es reproducible. El sistema es más acotado, pero deja un rastro más claro para inspeccionar y probar.
Normalizar de forma explícita
El framework estandariza valores solo con reglas nombradas. No inventa hechos de producto en silencio.
Separar demo y producción
Los fixtures sintéticos y proveedores deterministas no se presentan como infraestructura de comercio real.
Fallar de forma cerrada
Sin configuración del proveedor de producción, el sistema responde con un fallo controlado. No vuelve al modo demo.
Hacer visible la evidencia
Las decisiones de preparación y recuperación se pueden revisar, no solo aceptar.
Mantener límites honestos
Conectores, proveedores, persistencia y operaciones futuras se documentan como trabajo futuro.
08 / Arquitectura
Responsabilidades claras hacen el sistema más entendible.
SearchSignal es un monorepo TypeScript con pnpm. Next.js y React forman la interfaz pública. Zod define estructuras compartidas. Vitest prueba el comportamiento. Vercel es el destino de despliegue. La arquitectura separa preocupaciones para que un cambio no oscurezca otro.
Mapeo de origen
Traduce registros fuente a una estructura canónica.
Validación y normalización
Comprueba evidencia requerida y aplica reglas explícitas.
Preparación y elegibilidad
Evalúa si un registro puede sostener búsqueda.
Recuperación y evaluación
Ejecuta modos deterministas y los compara con consultas golden.
Interfaz pública
Explica el flujo mediante landing, demo y consola.
09 / Confianza mediante límites
El demostrador especifica lo que existe.
Implementado
- Catálogo ecommerce sintético
- Recuperación determinista por keyword, semántica e híbrida
- Validación y normalización de catálogo
- Evaluación de preparación y elegibilidad
- Evaluación con consultas golden
- UI pública y verificación automatizada
Futuro
- Integración real con Typesense
- Proveedor real de embeddings
- Conector de Shopify
- Persistencia duradera de comercio
- Analítica de búsqueda y sincronización en segundo plano
- Infraestructura SaaS multi-tenant
10 / Calidad y verificación
La evidencia también llega al build.
La verificación limpia registrada con Node 22 pasó instalación congelada, lint, comprobación de tipos, todos los tests, build de producción y el validador de preparación para Vercel. También cubre smoke de rutas, comprobaciones responsive y de teclado, además de fallos controlados. La evidencia de zoom real al 200% sigue documentada como pendiente.
11 / Resultado
Una forma de razonar sobre búsqueda antes del ranking.
SearchSignal es un demostrador funcional para una pregunta que suele quedar implícita: ¿está esta información de catálogo preparada para sostener búsqueda?
- Un flujo inspeccionable de preparación de catálogo
- Un sistema para explicar la elegibilidad de búsqueda
- Un entorno controlado para comparar recuperación
- Una prueba de concepto técnica con límites de producción documentados
12 / Siguiente paso
Pasos de validación lógicos, no un roadmap genérico.
SearchSignal
Una mejor búsqueda empieza con mejor información.
SearchSignal trata la calidad de búsqueda como un problema de sistemas antes de convertirlo en un problema de ranking.
