# Dónde está todo — Bicicletas Maino

Última actualización: 2026-09-03

## Qué está en el proyecto de Claude (cualquier chat lo puede leer)

| Archivo | Qué contiene |
|---|---|
| `datos/catalogo_compacto.json` | Los 169 productos con título, marca, categoría, SKU, precio, stock, specs canónicas, filtros y alertas. **Sin las descripciones enriquecidas**, con `excerpt` truncado a 200 caracteres |
| `datos/compatibilidad.json` | 138 pares compatibles y 302 incompatibles, con el motivo técnico |
| `datos/validar_catalogo.py` | Validador reutilizable |
| `claude/estado-migracion.md` | Estado general, stack, modelo de datos, seguridad del checkout |
| `claude/protocolo-verificacion.md` | Cómo se verifican las specs y por qué eBay está prohibido como fuente |
| `claude/fuentes-por-marca.md` | Archivo documental de 28 marcas |
| `claude/enriquecimiento-fichas.md` | Estructura de ficha, métricas antes/después |
| `claude/higiene-catalogo.md` | Duplicados, fotos cruzadas, variantes mal modeladas |
| `claude/maqueta-tienda.md` | La maqueta visual |

## Qué NO está y hay que recuperar del chat de la migración

Verificado el 2026-09-03: **ya no están en el PC**. Solo quedan como adjuntos del chat.

| Archivo | Peso | Qué es |
|---|---|---|
| `maino_pocketbase.zip` | 489 KB | Bundle completo: `catalog_enriquecido.json` con las descripciones HTML, `fichas_enriquecidas.json`, esquema de PocketBase, scripts, datos crudos de investigación |
| `maino_imagenes_optimizadas.zip` | 15 MB | Las 338 imágenes en WebP (14,1 MB, 58% menos) |
| `maino_imagenes_parte1/2.zip` | 32 MB | Imágenes originales sin optimizar |
| `maino_gaps_catalogo.xlsx` | 40 KB | Planilla para que el cliente complete precio, costo, stock y peso |

## Nota sobre la matriz de compatibilidad

El `compatibilidad.json` del proyecto (138 / 302) clasifica los incompatibles en **281 por velocidades
y 21 por capacidad**. `estado-migracion.md` describe una revisión posterior con la regla de **sistema**
(Shimano vs Campagnolo vs SRAM) evaluada antes que la de capacidad, que da 132 / 189 / 15.
**Esa revisión no está en el dato del proyecto**; vive en el bundle de la migración.
Al recuperar el zip hay que reemplazar el JSON por la versión con regla de sistema.

## Aviso para quien retome el trabajo

Antes de dar por bueno cualquier dato nuevo, leer `claude/protocolo-verificacion.md`. La regla dura del
proyecto es que **eBay y MercadoLibre están prohibidos como fuente de specs**, y que lo que el fabricante
no publica se deja vacío en vez de rellenarlo. En esta migración aparecieron **4 códigos de producto que
no existen** justamente por fichas copiadas de vendedores.