Para qué es este documento: El motor de clasificación ABC×XYZ ya está construido y funcionando. Los datos existen. Antes de construir la pantalla que el cliente final ve, Serlyn debe responder las preguntas de este documento. Sin estas respuestas no se empieza el frontend.
Qué ya está construido (contexto técnico)
Douglas ya tiene funcionando:
- Motor estadístico completo: clasifica cada SKU como A/B/C (valor), X/Y/Z (variabilidad) y uno de 4 patrones de demanda: smooth, erratic, intermittent, lumpy.
- API lista:
GET /api/v1/skusdevuelve cada producto con su clasificación.POST /api/v1/motor/classifydispara el motor. - Importación CSV: el cliente ya puede subir su inventario desde Excel.
Lo que aún NO existe: la pantalla donde el cliente VE esos resultados y decide qué hacer con ellos.
Qué decidir antes de construir
DECISIÓN 1 — ¿Qué ve el cliente al entrar por primera vez? ⚠️
El cliente acaba de registrarse. Todavía no subió su CSV. Tiene tres estados posibles:
| Estado | Descripción |
|---|---|
| A | Sin inventario importado |
| B | CSV importado pero motor no corrió |
| C | Motor corrió — tiene clasificación completa |
Pregunta para Serlyn: ¿Cómo se ve el dashboard en cada estado? ¿Hay un flujo de onboarding paso a paso (tipo wizard), o el cliente llega al dashboard vacío con un botón?
Tu respuesta:
DECISIÓN 2 — ¿Cómo se muestra la clasificación? ⚠️
Hay tres formas principales de presentar los resultados del motor. Cada una tiene un trade-off:
Opción A — Tabla con filtros
┌─────────────────────────────────────────────────────────────┐
│ [A] [B] [C] [X] [Y] [Z] [smooth] [lumpy] Buscar... │
├──────┬────────────┬──────┬──────┬─────────────┬────────────┤
│ Cód │ Descripción│ ABC │ XYZ │ Patrón │ Stock │
├──────┼────────────┼──────┼──────┼─────────────┼────────────┤
│ S001 │ Tornillos │ A │ X │ smooth │ 1,450 │
│ S002 │ Bisagras │ A │ Z │ lumpy │ 230 │
│ S003 │ Pintura │ B │ Y │ erratic │ 45 │
└──────┴────────────┴──────┴──────┴─────────────┴────────────┘
Ventaja: familiar (parece Excel), fácil de exportar. Desventaja: no muestra el "por qué".
Opción B — Matriz visual 3×3 (ABC × XYZ)
X (estable) Y (variable) Z (caótico)
┌──────────────┬──────────────┬──────────────┐
A │ 12 SKUs │ 8 SKUs │ 3 SKUs │
│ [ver lista] │ [ver lista] │ [ver lista] │
├──────────────┼──────────────┼──────────────┤
B │ 7 SKUs │ 14 SKUs │ 5 SKUs │
├──────────────┼──────────────┼──────────────┤
C │ 4 SKUs │ 9 SKUs │ 18 SKUs │
└──────────────┴──────────────┴──────────────┘
Ventaja: un vistazo revela la salud del inventario. Desventaja: más trabajo de UI, puede confundir si el cliente no conoce el método.
Opción C — Cards por patrón de demanda
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ SMOOTH │ │ ERRATIC │ │INTERMITTENT │ │ LUMPY │
│ Pronóstico │ │ Alta var. │ │ Poca frec. │ │ Impredec. │
│ confiable │ │ frecuente │ │ baja var. │ │ muy alta │
│ │ │ │ │ │ │ │
│ 24 SKUs │ │ 11 SKUs │ │ 8 SKUs │ │ 3 SKUs │
│ [gestionar]│ │ [gestionar]│ │ [gestionar]│ │ [gestionar]│
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
Ventaja: orientado a acción, explica el "qué hacer". Desventaja: el cliente puede no entender los términos.
Pregunta para Serlyn: ¿Cuál opción quieres, o una combinación? ¿Lo validaste con algún prospecto?
Tu respuesta:
DECISIÓN 3 — ¿Qué puede hacer el cliente sobre un SKU clasificado? ⚠️
Cuando el cliente hace clic en un SKU específico, ¿qué acciones tiene disponibles?
Opciones que podemos construir (marcar las que aplican):
- [ ] Ver el historial de movimientos del SKU
- [ ] Editar datos del SKU (costo, lead time, MOQ) desde la vista
- [ ] Override manual de clasificación (el cliente puede cambiar A→B si no está de acuerdo)
- [ ] Marcar SKU como inactivo (para excluirlo del motor)
- [ ] Ver el método de pronóstico asignado (ej: "se usará IMAPA para este SKU")
- [ ] Ver stock actual vs. stock sugerido (si ya hay pronóstico corrido)
Pregunta para Serlyn: ¿Cuáles de estas acciones son prioritarias para el cliente en SM-1? ¿Alguna más que no está en la lista?
Tu respuesta:
DECISIÓN 4 — Terminología para el cliente final ⚠️
Los términos técnicos del motor no pueden aparecer en la UI tal cual. Necesitamos traducirlos:
| Término técnico | Opciones de label para el cliente | ¿Cuál elegís? |
|---|---|---|
smooth |
"Demanda estable" / "Pronóstico fácil" / "Estable" | |
erratic |
"Demanda variable" / "Difícil de predecir" / "Variable" | |
intermittent |
"Demanda esporádica" / "Ventas irregulares" / "Intermitente" | |
lumpy |
"Demanda impredecible" / "Ventas en picos" / "Impredecible" | |
ABC class |
"Prioridad A/B/C" / "Valor A/B/C" / dejar A/B/C solo | |
XYZ class |
"Variabilidad X/Y/Z" / ocultar / mostrar solo en tooltip |
Pregunta para Serlyn: ¿Cuáles labels usamos? ¿Validaste alguno con prospectos?
Tu respuesta:
DECISIÓN 5 — ¿Qué pasa justo después de correr el motor? ⚠️
El motor tarda entre 10 segundos y 2 minutos dependiendo del catálogo. El cliente hizo clic en "Clasificar mi inventario" y espera.
Opciones:
A) Pantalla de carga con progreso ("Analizando 150 SKUs… 47% completado") B) El cliente puede seguir navegando y recibe una notificación cuando termina C) Redirección automática a la vista de clasificación cuando termina
Pregunta para Serlyn: ¿Cuál de las 3 preferís? ¿Importa mucho o es detalle menor?
Tu respuesta:
No-gos propuestos (para confirmar) ⚠️
Douglas propone que estas cosas queden fuera de SM-1. Serlyn confirma o veta:
| No-go propuesto | ¿Confirmar? |
|---|---|
| No incluye órdenes de compra automáticas (son SM-2) | [ ] Confirmar [ ] Vetar — razón: |
| No incluye pronóstico numérico (cuánto pedir) en esta vista | [ ] Confirmar [ ] Vetar — razón: |
| No incluye comparación con datos históricos de otro período | [ ] Confirmar [ ] Vetar — razón: |
| No incluye exportación a Excel/PDF de la clasificación | [ ] Confirmar [ ] Vetar — razón: |
| No incluye multiusuario por empresa (un solo admin por ahora) | [ ] Confirmar [ ] Vetar — razón: |
¿Hay algún no-go que agregarías?:
Cómo entregar tus respuestas
Opción 1: Responder directamente en este doc y pasarlo a Douglas
Opción 2: Conversación de 30 minutos con Douglas antes del Betting Table
Opción 3: Voice note / video con las respuestas
Una vez que Serlyn responda las 5 decisiones, Douglas construye el frontend en 1 semana.
Checklist — Shape listo para construcción
- [ ] Decisión 1 respondida (estados de onboarding)
- [ ] Decisión 2 respondida (tipo de visualización)
- [ ] Decisión 3 respondida (acciones por SKU)
- [ ] Decisión 4 respondida (terminología UI)
- [ ] Decisión 5 respondida (flujo post-motor)
- [ ] No-gos confirmados o vetados
Cuando todos los checkboxes estén marcados → Douglas empieza TASK-016.
Shape Request SM-1 · Vista de Clasificación · Mayo 2026 · Cheryx Group