Ficha Universal y versionado
La estructura central de Noobit: la ficha de cada producto, con su historial de versiones.
La Ficha Universal es el modelo de datos central de Noobit. Cada producto que entra — desde CSV, sync, webhook o escáner — se convierte a esta estructura antes de cualquier otra cosa. El pipeline y las publicaciones trabajan siempre contra ella, nunca contra el formato original del proveedor.
Por qué existe
En un catálogo real los datos llegan de muchos sitios: el CSV de un proveedor, el sync de WooCommerce, lo que un operario escaneó con el móvil, lo que Noobit encontró al investigar en la web. Si cada fuente usa su propio formato, el código se llena de condicionales y las ediciones se contaminan.
La Ficha Universal lo lleva todo a un único formato: mismos nombres de campo, mismas convenciones. Todo lo que venga después (generación de contenido, procesamiento de imágenes, publicación) trabaja contra una sola realidad.
Qué contiene
La IA reescribe el título comercial, nunca el nombre de catálogo. Y redacta el contenido a partir del Conocimiento del producto: los hechos de todas tus fuentes, cada uno con su procedencia. Lo explicamos en Conceptos · Conocimiento.
Historial de versiones
Cada edición manual, cada redacción con IA y cada importación crean una versión nueva. La anterior no se borra: queda con su fecha y su autor, en la pestaña Versiones de la ficha. Lo que llega de la tienda (precio, stock y demás datos) actualiza la versión vigente, sin crear otra.
Varias fuentes, una ficha
Cuando un producto llega de dos fuentes (un CSV semanal y tu tienda WooCommerce, por ejemplo), Noobit guarda lo que aporta cada una por separado, y en la pestaña Fuentes decides cuáles lee la IA. El dato duro (precio, stock, EAN, peso) manda siempre desde su fuente. El contenido redactado (título, descripciones, SEO) solo lo cambia una acción tuya: ni la tienda ni un CSV nuevo lo pisan, salvo que marques «Sobrescribir contenido redactado» al importar. Si alguien lo edita en la tienda, lo verás en Conflictos.
Precios: el vigente y el de antes
La ficha guarda el precio que paga hoy tu cliente y, solo si hay oferta, el precio de antes (el tachado). Cuando publicas precios, la ficha manda: si no tiene precio de antes, la oferta también desaparece en la tienda, incluida una oferta programada que aún no ha empezado.
Por eso, antes de publicar precios por primera vez, conviene sincronizar los precios desde tu tienda: así Noobit aprende tus ofertas.
Lo que no está en la Ficha Universal
Intencionalmente, algunos datos no viven en la Ficha Universal sino aparte:
- Publicaciones: qué versión está publicada en qué tienda
- Tareas: el historial de operaciones del pipeline
- Aprobaciones: las pendientes y las resueltas
- Avisos, registro de actividad y consumo
Esto mantiene la Ficha Universal limpia (solo datos del producto en sí) y permite operar sobre metadatos operacionales sin tocar el contenido.
Implicación práctica
Cuando exportas o preparas una salida, lo que sale es siempre la Ficha Universal. No tienes que pensar en si el dato vino de WooCommerce, de un CSV o del escáner: ya está normalizado. La complejidad queda en la entrada.