Para qué es este documento: El ciclo SM-2 construye el cerebro estadístico completo de StockMind — el que decide cuánto pedir, cuándo pedir, y a quién. Antes de que Douglas empiece, Serlyn necesita responder las decisiones de producto que afectan lo que el cliente VE y ENTIENDE. El motor puede ser perfecto matemáticamente y fallar igual si el cliente no confía en él.
Qué ya está construido (contexto técnico, en simple)
Del ciclo SM-1, Douglas ya tiene listo:
- Clasificación de cada SKU: el sistema ya sabe si cada producto tiene demanda estable, variable, esporádica o impredecible.
- API lista: los datos de clasificación existen y se pueden consultar.
- Base de datos: estructura completa con todos los campos necesarios.
Lo que SM-2 construye: el motor que, para cada SKU, corre el pronóstico correcto y genera la orden de compra sugerida con justificación. Al final de SM-2, el backend puede decirle al sistema "pide 200 unidades de tornillos a Proveedor X en los próximos 7 días" — con el cálculo demostrado.
Lo que aún NO existe después de SM-2: la pantalla donde el cliente ve esas órdenes. Eso es SM-3.
Qué decidir antes de construir
DECISIÓN 1 — ¿Cuántos días hacia el futuro pronosticamos? ⚠️
El motor puede generar pronósticos a 30, 60 o 90 días. La elección afecta cuánto capital el cliente compromete en una orden de compra.
| Horizonte | Ventaja | Riesgo |
|---|---|---|
| 30 días | Menos compromiso, más flexible | El cliente tiene que revisar órdenes más seguido |
| 60 días | Balance entre precisión y planificación | Estándar en la industria de distribución |
| 90 días | Ideal para importadoras con lead time largo | Más margen de error en el pronóstico |
Propuesta Douglas: 30 días por default, configurable por empresa a 60 o 90 días según su operación.
Pregunta para Serlyn: ¿Validaste con algún prospecto cuántos días miran hacia adelante en su operación? ¿La ferretería piensa en semanas o en meses?
Tu respuesta:
DECISIÓN 2 — ¿Cómo explicamos al cliente por qué el sistema eligió ese método? ⚠️
Para cada SKU el motor elige entre 14 métodos estadísticos. El cliente no necesita saber los nombres, pero sí necesita CONFIAR en la recomendación.
Opciones de explicación en la UI:
Opción A — Explicación técnica simplificada
"Para este SKU usamos el método Holt-Winters porque tiene estacionalidad anual. Precisión histórica: ±12% de error."
Opción B — Explicación orientada al negocio
"Este producto tiene ventas que suben en diciembre y bajan en febrero. El sistema aprendió ese patrón y lo usó para calcular cuánto pedir."
Opción C — Solo el resultado, sin explicación
"Pedir 200 unidades antes del 5 de junio." (sin justificación visible)
Opción D — Explicación bajo demanda (colapsada, clic para ver)
Resultado visible → botón "¿Por qué esta cantidad?" → abre el detalle técnico
Pregunta para Serlyn: ¿Los prospectos con los que has hablado preguntan "¿por qué?" o solo quieren saber "¿cuánto?"? ¿Cuál opción genera más confianza?
Tu respuesta:
DECISIÓN 3 — ¿Qué nivel de servicio (fill rate) ofrecemos por plan? ⚠️
El "nivel de servicio" determina con qué agresividad el sistema protege contra quiebres de stock. Traducido al cliente:
| Nivel de servicio | Lo que significa para el cliente | Plan asociado |
|---|---|---|
| 95% | "En promedio, 19 de cada 20 veces que un cliente llega, el producto está disponible" | Starter / Growth |
| 97.5% | "En 39 de cada 40 veces" | Pro |
| 99% | "En 99 de cada 100 veces" | Enterprise |
Un nivel más alto = más stock de seguridad = más capital inmovilizado. Es un trade-off explícito.
Pregunta para Serlyn: ¿Cuándo presentas esto a un prospecto, lo entenderían en términos de "probabilidad" o preferirían verlo como "stock de seguridad extra en días"? ¿Quieres que sea configurable por el cliente dentro de su plan, o lo fijamos nosotros?
Tu respuesta:
DECISIÓN 4 — ¿Qué pasa con los SKUs que el sistema no puede pronosticar bien? ⚠️
Algunos SKUs tienen muy pocos datos históricos (menos de 30 días de historia) o son completamente nuevos. El sistema los detecta y los etiqueta como "En calibración".
Opciones de comunicación al cliente:
Opción A — Badge "En calibración" con días restantes
"🌱 En calibración — faltan 18 días para pronóstico confiable"
Opción B — SKU oculto del motor hasta tener datos suficientes
El cliente no ve ese SKU en la vista de órdenes hasta que haya datos suficientes.
Opción C — Pronóstico conservador con advertencia
Sistema genera una orden más pequeña y lo dice explícitamente: "Pronóstico provisional — pocos datos disponibles"
Pregunta para Serlyn: ¿Cuántos SKUs "nuevos" o "recientes" tiene en promedio una ferretería de tamaño mediano? ¿Qué espera el cliente ver en esos casos?
Tu respuesta:
DECISIÓN 5 — ¿Cómo notificamos cuando el motor corrió? ⚠️
El motor corre automáticamente cada noche a las 3am. Al día siguiente el cliente tiene órdenes nuevas esperando. Necesita saberlo.
Canales de notificación disponibles: - [ ] Email resumen con las órdenes generadas - [ ] Notificación push en la app (SM-7, no disponible en SM-2) - [ ] Badge en el dashboard (contador de órdenes pendientes) - [ ] Ninguno — el cliente revisa cuando quiere
Pregunta para Serlyn: ¿El cliente tipo (dueño de ferretería, jefe de compras) quiere que le llegue el email al despertar, o prefiere que la info lo espere en la app cuando entra? ¿Tienes preferencia entre email diario vs. resumen semanal?
Tu respuesta:
No-gos propuestos (para confirmar) ⚠️
SM-2 es solo el motor, no el frontend. Douglas propone que estas cosas queden fuera. Serlyn confirma o veta:
| No-go propuesto | ¿Confirmar? |
|---|---|
| No incluye pantalla de resultados (eso es SM-3) | [ ] Confirmar [ ] Vetar — razón: |
| No incluye Prophet ni LightGBM (son SM-6, para clientes con 2+ años de datos) | [ ] Confirmar [ ] Vetar — razón: |
| No incluye integración con Alegra — el motor usa los datos ya importados | [ ] Confirmar [ ] Vetar — razón: |
| No incluye WhatsApp — si el setup de Meta Business tarda >4 sem, pasa a V1 | [ ] Confirmar [ ] Vetar — razón: |
| No incluye pronóstico por categoría o proveedor (solo por SKU individual) | [ ] 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
Checklist — Shape listo para construcción
- [ ] Decisión 1 respondida (horizonte de pronóstico)
- [ ] Decisión 2 respondida (nivel de explicación al cliente)
- [ ] Decisión 3 respondida (nivel de servicio por plan)
- [ ] Decisión 4 respondida (SKUs sin datos suficientes)
- [ ] Decisión 5 respondida (canal de notificación)
- [ ] No-gos confirmados o vetados
Cuando todos los checkboxes estén marcados → Douglas empieza TASK-015 (SM-2).
Shape Request SM-2 · Motor Pronóstico y OC · Mayo 2026 · Cheryx Group