Mando de Catálogo

¿Cómo funciona el Mando de Catálogo?

El Mando de Catálogo centraliza las decisiones semanales sobre el catálogo de Wituka: qué producir, qué promocionar al núcleo permanente del catálogo (Must Have), qué mover a Last Units y qué dejar morir en parrilla. Cruza stock por modelo+talla con histórico de ventas reales de Shopify.

De dónde salen los datos

Cada hora, el dashboard de e-commerce extrae de Shopify: catálogo (productos + variantes con stock por talla y color) y todos los pedidos del año en curso y del año anterior.
El JSON resultante (wituka_replenishment.json) se publica en ecommercewebdashboard.pampl.ing y esta app lo lee al abrirse.
Las ventas son netas de devoluciones y excluyen pedidos mayoristas, tienda física (ALLSTORE) y pedidos voided/pending — mismo filtro que el panel oficial de Shopify Analytics.

Pantallas y para qué sirve cada una

📋 Decisiones (botón principal): el tablero semanal. 4 pestañas: Producir, Promocionar a MH, Mover a LU (con sub-tabs Mover ya / Dejar en parrilla) e Historial. Cada acción se guarda localmente en este navegador.
Must Have: lista del catálogo permanente con stats de facturación y unidades. Se puede añadir/quitar productos manualmente.
Comparativa MKT: cruce con la lista oficial de Marketing/Tiendas (Excel) por nombre del modelo.
⚠️ Roturas: modelos que se quedarán sin stock en X días al ritmo actual.
Tabla principal: una fila por modelo con stock, ventas, prioridad y cantidad a pedir. Filtra por defecto sólo Must Have (es donde se concentra la decisión productiva).

Granularidad: 1 fila por modelo

Cada fila es un modelo entero (ej. "Is not that deep"), sumando todas las tallas y colores. Producción tiene MOQ por modelo (500 uds repartibles entre colores), por eso operamos al nivel modelo. El desglose por talla aparece al expandir el chevron, en las líneas ⚠ Rotas / ✓ Disponibles y, si el modelo tiene varios colores, una línea por color.

Métricas por modelo

Stock: unidades disponibles ahora mismo (suma todas las variantes).
7d / 14d / 30d / 60d / 90d: unidades vendidas en cada ventana, hasta el día anterior (último día con datos completos).
Velocidad = uds/día. Calculamos ponderada (50% últimos 7d + 30% 14d + 20% 30d) y media plana s30/30, y nos quedamos con la mayor. La ponderada captura aceleraciones; la media plana protege contra falsos negativos cuando un Must Have tiene tallas críticas rotas y por eso s7=0 (la rotura no debe parecer "ralentización").
Cobertura = stock ÷ velocidad. Días que durará el stock al ritmo actual.
Déficit = unidades que se quedarán sin servir antes de que llegue la reposición. velocidad × lead_time − stock.
Días MOQ = días que tarda el modelo en consumir el MOQ a velocidad actual. Verde ≤180d, ámbar 180-365d, rojo >365d.
Pedir: cantidad sugerida, con MOQ mínimo aplicado y opcionalmente redondeada al múltiplo.

Lead time, buffer, MOQ y múltiplo

Lead time = días desde aviso a producción hasta vuelta a tienda. Defecto 15 días.
Buffer al recibir = días de cobertura objetivo cuando llegue la reposición. Defecto 30 días.
MOQ = pedido mínimo por modelo. Wituka 500 uds (repartibles entre colores).
Múltiplo = redondeo adicional. 0 = sin redondeo.

vel_ponderada    = 0.5 × s7/7 + 0.3 × s14/14 + 0.2 × s30/30
velocidad        = max(vel_ponderada, s30/30)
stock_al_recibir = max(0, stock_actual − velocidad × lead_time)
target_al_recibir = velocidad × buffer
pedir_natural    = max(0, target_al_recibir − stock_al_recibir)
pedir            = max(MOQ, pedir_natural)
                    ↓ (si múltiplo > 0)
                   ceil(pedir / múltiplo) × múltiplo

📋 Tablero de Decisiones — qué propone cada pestaña

📦 Producir — Must Have con cantidad sugerida > 0 (excluye Last Units). Al pulsar "Comunicar producción" se sincroniza con el workflow de la tabla principal y se exporta al CSV de órdenes con desglose por SKU+EAN+color+talla.

⬆️ Promocionar a MH — productos NO Must Have a punto de cumplir el umbral. Dos sub-tipos:

Casi confirmado: antigüedad ≥180d, s90 entre 70-99 uds (cerca del umbral 100), ratio interanual ≥0.7. O bien s90 ≥100 con ratio justo entre 0.5 y 0.7 (borderline).
Novedad en rampa: 14-180d desde publicación, proyección anual entre 600 y 999 uds (próxima a cruzar el umbral de novedad caliente: ≥1.000 uds/año).

Promocionar lo añade como Must Have manual hasta que el algoritmo lo confirme automáticamente.

⬇️ Mover a Last Units — productos en declive sostenido y con stock relevante. Para que aparezcan tienen que cumplir simultáneamente dos cosas:

Declive sostenido (criterios abajo).
Stock que merezca acción: stock ≥30 uds y cobertura natural ≥90d (al ritmo s90/90 tarda 3+ meses en vaciarse), o bien stock zombie (≥50% del stock en tallas que casi nadie pide). Productos con menos stock o cobertura corta se vacían solos y no aparecen aquí — sería ruido.

Criterios de "declive sostenido":

Antigüedad ≥365 días, NO Must Have, NO Last Units, stock >0.
Muerto: 0 ventas en 90d pero vendió ≥50 uds en 2025.
Declive: ratio interanual <0.5 (vende menos del 50% que el año pasado), s2025 ≥100, s90 ≥5.

🪦 Stock zombie y stock por talla

El stock no es uniforme: un modelo con 156 uds repartidas en S/M/L (que vendían) tiene salida natural; pero las mismas 156 uds clavadas en XS/4XL son stock muerto, casi imposible de vender al precio normal. Para detectar esto clasificamos cada talla:

Talla viva: peso ventas históricas ≥10% del modelo.
Talla muerta: peso ventas históricas <5%.
stock_zombie_pct = stock_en_tallas_muertas / stock_total.
Si ≥50% del stock está en tallas muertas → flag 🪦 Stock zombie. Fuerza el paso a "Mover ya a LU" (no se vaciará solo aunque el modelo aparente venta).

En cada card de Last Units se ve la línea 📐 Stock por talla: cada talla con sus uds de stock y su % de ventas históricas. Las verdes son vivas, las moradas son muertas.

Niveles de prioridad de reposición (tabla principal)

Cruza nivel de stock con velocidad. Un modelo a 0 que vende 1 ud al mes no es crítico — repones lo que se vende.

🔴 Crítica: stock = 0 y ≥5 uds vendidas en 30d, o cobertura < lead_time con ventas relevantes.
🟠 Alta: stock = 0 con 2-4 uds/mes, o cobertura < lead_time+7d con ≥2 uds/mes.
🟡 Media: stock = 0 con 1 ud/mes, o cobertura entre lead_time+7 y 2×lead_time con ≥2 uds/mes.
🟢 Baja: cobertura entre 2× y 4× el lead_time.
⚪ OK: cobertura > 4×lead_time o producto que no vende.

Modificadores (pueden subir un nivel)

🚀 Acelerándose: ventas últimos 7d × 30/7 superan 1.5× la velocidad 30d. Sólo si vende ≥5/mes.
🆕 Novedad: publicado <60 días con ≥10 uds en 30d.
💀 Top sin stock: stock = 0 y ventas 30d en P75 de la categoría (mínimo 5/mes). Fuerza Crítica.

Estados especiales del producto (badges)

🟢 Must Have: producto del catálogo permanente (demanda demostrada). Detalle en el modal Must Have.
✨ Novedad (en MH): novedad caliente con ≥1.000 uds/año proyectados.
✏️ Manual: añadido al MH manualmente desde la app.
🟠 Last Units: en la colección "Last units 2026" de Shopify. No fabricar más.
⚠️ MOQ no viable: el modelo tarda >1 año en consumir el MOQ.

Búsqueda

El campo de búsqueda matchea por nombre, color, SKU o EAN de cualquiera de las variantes del modelo.

Exportar CSV

Hay tres exports distintos:

Tabla principal: filas accionables del filtro actual, una por modelo, con reparto sugerido por color.
Decisiones / Órdenes producción: una fila por (modelo × color × talla) con SKU, EAN, % color, % talla y uds a producir. Listo para enviar a fábrica.
Roturas: modelos que romperán en X días con fecha estimada de rotura.

Separador ; para que Excel lo abra directamente.

Persistencia local (localStorage)

El navegador guarda: workflow producir/recibir, overrides manuales del Must Have, decisiones tomadas en el tablero (por semana ISO) y fecha de última revisión. Borrar localStorage limpia todo (no afecta a Shopify ni a producción real).

Must Have de Wituka

¿Cómo se calcula esta lista?

Un producto entra en Must Have cuando demuestra demanda sostenida. Es un concepto identitario: si forma parte del alma de la marca y vende bien, es Must Have, aunque ahora mismo no haga falta producirlo. La decisión operativa de producir o no es independiente y se gestiona en la columna Pedir y los avisos ⚠️ MOQ no viable de la tabla principal.

Criterios de demanda (todos obligatorios):

Volumen mínimo: ≥ 100 unidades vendidas en los últimos 90 días (≥1,1 uds/día).
Antigüedad ≥ 180 días (ya ha tenido tiempo de demostrarse).
Vende en los últimos 30, 60, 90 días y en 2025: ventas continuas, no un pico aislado.
No está en caída intratrimestre: velocidad 30d ≥ 50% de la velocidad 90d.
No está en caída interanual: velocidad actual (s90/90) ≥ 70% de la velocidad media de 2025.
No está en Last Units (descatalogación).

NO se aplican filtros operativos. Aunque un Must Have tenga stock para 10 años o aunque su MOQ tarde en consumirse, sigue siendo Must Have. Eso solo afecta a si hay que producirlo ahora (lo ves en la columna Pedir, que será 0 en esos casos), no a si es identitario.

Por qué velocidad media y no ponderada. En el resto de la app usamos velocidad ponderada (50% últimos 7d, 30% 14d, 20% 30d) para reaccionar rápido a tendencias. Pero el Must Have es estable: debe demostrar consistencia histórica, no entrar por un repunte de la última semana. Por eso aquí usamos la media plana s90/90.

✨ Excepción para novedades calientes. Productos publicados entre 14 y 180 días entran al Must Have si demuestran ritmo muy fuerte: velocidad ponderada anualizada ≥ 1.000 uds/año (≈2,7 uds/día sostenido). Captura bombazos como Summer Vibes que claramente ya son must-have aunque acaben de salir. Aparecen con badge ✨ Novedad.

El listado se recalcula automáticamente cada hora con los datos frescos del dashboard. Si un producto deja de cumplir, sale. Si una novedad ≥180d empieza a cumplir, entra automáticamente.

	Producto	Categoría	30d	90d	2025

Comparativa Must Have: MKT vs App

Comparación entre la lista oficial de Must Have de Marketing/Tiendas (Excel) y los Must Have que detecta automáticamente esta app. Cruce por nombre del modelo.

⚠️ Roturas previstas

Modelos que se quedarán sin stock pronto al ritmo de ventas actual. Se calcula sobre la velocidad ponderada (50% últimos 7d + 30% 14d + 20% 30d).

Horizonte: días Solo Must Have

	Producto	Categoría	Stock	Vel/d	Cobertura	Rompe el…