Glosario
| Termino | Definición |
|---|---|
| Tenant | Tu instancia de Mibizum. Slug único, aislado del resto de comercios. Ver Conceptos. |
| Data source | Catalogo dentro de un tenant. Default productos; puedes tener varios (recetas, posts, etc.). Ver Conceptos. |
| Item | Elemento indexado en un data source. Tiene id, name y campos opcionales. Ver Conceptos. |
| Sinónimo | Relación word -> [variantes]. Cuando el cliente busca una variante, Mibizum aplica la word. Tres origenes: manual, learned, suggested. Ver Guías > Sinónimos. |
| Regla de curación | Intervención manual sobre el ranking. Dos modos: pin (fija un puesto) y override (reemplaza todo). Ver API > Reglas. |
| Smart Mibizum | El aprendizaje IA del buscador. Cuatro modos: off, shadow, hybrid, auto. Ver API > Sugerencias IA. |
| Sessión ID | UUID opaco que identifica la sesión de un cliente. TTL 24h en localStorage. No es PII. |
| API key publica | mb_pk_*. Solo lectura. Segura en frontend. |
| API key privada | mb_sk_*. Lectura + escritura. NUNCA en frontend. |
| Confidence | Número 0-1 que Smart asigna a una sugerencia. Por debajo de auto_confidence_threshold (default 0.85) no se aplica automáticamente. |
| Band | Categoría de una acción del aprendizaje IA: auto (aplicada sola), suggested (esperando confirmación humana), discarded (filtrada como spam), manual (creada por humano vía panel). |
| Hit | Cada item devuelto por /search. Incluye score, highlight y los campos del item. |
| Facet | Agregado por valor para un campo del item (e.g. cuantos hits por cada categoría). |
| Filter | Expresión para restringir resultados (e.g. in_stock=true AND price<30). |
| Score | Relevancia normalizada del motor (mayor = más relevante). No comparable entre queries distintas. |
| Tracking | Reporte de eventos del cliente (search, click, conversión) para alimentar métricas y aprendizaje. |
| Adapter | Módulo de integración para una plataforma concreta (e.g. Magento). Thin shim sobre el SDK JS. |
| Widget | Componente visual que se monta en la tienda. Personalizable desde el panel. |
| Onboarding wizard | Flujo de 3 pasos al crear el tenant: memoria del negocio + safety + bienvenida. |
| Business memory | Notas en texto libre que el merchant escribe para dar contexto al aprendizaje IA. Máximo 5000 chars. |