# Enriquecimiento de fichas — Bicicletas Maino

Última actualización: 2026-08-11 · **46 fichas entregadas en el primer bloque**

## Objetivo (corregido con el cliente)
No es montar el sitio. Es construir el **activo de datos**: enriquecer productos, mejorar copy y dejar
las imágenes independientes de Shopify. El sitio viene después.

## Auditoría del copy original (medida, no opinada)

La primera lectura fue que "el copy está decente". **Medido, era falso.**

| Métrica | Antes |
|---|---|
| Datos duros por ficha | mediana **4** |
| Fichas con CERO datos numéricos | 35 |
| Muletillas de IA | **108** apariciones ("ideal para ciclistas" ×30, "excelente opción" ×32) |
| Frases idénticas repetidas entre productos | 24 |
| Claves de spec distintas sin normalizar | 64 |

Caso extremo, el Allen MT2: *"un portabicicletas para 2 bicicletas es un soporte diseñado para transportar bicicletas"*.

## Resultado

| | Antes | Después |
|---|---|---|
| Datos duros (46 fichas) | 49 | **587** (12×) |
| Alertas de compra | 0 | **210** |
| Datos sin fuente | — | **0** |

## Estructura de ficha (definida y aplicada)
1. **H2 con el dato que diferencia a ese producto.** Sale de la alerta más distintiva, no de una spec
   genérica — si no, salen 11 titulares de cassette idénticos y se reproduce el defecto original.
   Ejemplos reales: *"El único 11-23T que queda en Ultegra de 11 velocidades"* ·
   *"Con 11-32T necesitas cambio de jaula media, no jaula corta"* ·
   *"Sistema electrónico Di2: la palanca sola no funciona"*.
2. Párrafo de apertura: identificación técnica + estado en catálogo (vigente / descontinuado / legacy).
3. **Especificaciones** — solo datos con fuente oficial.
4. **Antes de comprar** — incompatibilidades, descontinuación, qué se vende por separado.
   Esta sección no existía en ninguna ficha y es la que baja devoluciones.

## Regla que se respetó
Lo que el fabricante nunca publicó quedó **fuera**, no rellenado con cifras de vendedores:
peso del CS-HG61, del RD-4601-SS, del RD-R3000-SS, del ST-6770 y del PD-7800; stack height de los
pedales antiguos; longitud de jaula en mm (Shimano solo publica SS/GS).

## Cobertura del primer bloque

- ✅ **46 fichas** (41 productos verificados; 5 son duplicados de catálogo que comparten datos)
- ❌ **49 productos sin cubrir**: 34 sin identificación única + 13 genéricos sin código de fabricante

Los 34 ambiguos: 12 bicicletas sin año de modelo, 14 modelos SRAM/RockShox sin referencia, 8 cassettes de
familia larga. Requieren que el cliente lea el código en la caja o en el grabado del piñón mayor.

Con el bloque A el total llegó a **89 fichas enriquecidas de 169**.

## Entregado
- `maino_pocketbase.zip` — `catalog_enriquecido.json` listo para importar, `fichas_enriquecidas.json`,
  `research/verificado_*.json` con el dato crudo por producto, `errores_catalogo.json`
- `fichas_revision.html` — comparativo antes/después
- `errores_catalogo.html` — los 15 errores con acción concreta
- `piloto_enriquecimiento.html` — el piloto de 3 productos que validó el enfoque

## Pendiente (en orden, sin depender del cliente)
1. **Optimizar imágenes** — hecho: 33,7 → 14,1 MB.
2. **Limpiar copy de los productos restantes** — quitar las 108 muletillas y las 24 frases repetidas,
   reestructurar al mismo formato. Sin investigación: es reescritura sobre lo que ya hay.
3. **Normalizar las claves de spec** a un esquema de atributos por categoría — hecho: 265 → 48.

## Depende del cliente
- Planilla de identificación para los 34 ambiguos
- Datos operativos: precio, costo, stock, peso, matriz de tallas (`maino_gaps_catalogo.xlsx`)
