Para qué es este documento: SM-3 es el ciclo donde StockMind se convierte en un producto que un cliente real puede usar. Todo lo construido en SM-1 (clasificación) y SM-2 (pronóstico + OC) finalmente tiene una pantalla. Las decisiones de este documento definen qué ve el cliente, en qué orden, y qué puede hacer. Si Serlyn no responde esto, Douglas construye el frontend a ciegas.
Qué ya está construido antes de SM-3
Para cuando empiece SM-3, Douglas ya tiene listo:
- Motor completo: clasifica SKUs y genera órdenes de compra con justificación.
- API completa: todos los endpoints de inventario, pronóstico, órdenes y proveedores están listos.
- Base de datos: toda la estructura existe, con datos de clasificación y pronóstico por SKU.
Lo que SM-3 construye: la interfaz completa en React — dashboard principal, tabla de inventario, vista de detalle de SKU, gestión de órdenes de compra, configuración de empresa, y el wizard de onboarding. Al final de SM-3, un cliente piloto real puede entrar, subir su inventario, ver su clasificación, revisar las órdenes sugeridas y aprobarlas o rechazarlas.
Qué decidir antes de construir
DECISIÓN 1 — Estructura de navegación (qué secciones tiene la app) ⚠️
Propuesta de navegación (sidebar izquierdo):
┌─────────────────────┐
│ StockMind │
├─────────────────────┤
│ 📊 Dashboard │ ← resumen ejecutivo
│ 📦 Inventario │ ← tabla de SKUs
│ 🛒 Órdenes de compra│ ← OCs generadas y su estado
│ 🏭 Proveedores │ ← directorio de proveedores
│ ⚙️ Configuración │ ← empresa, usuarios, integración
└─────────────────────┘
Alternativa compacta (sin "Proveedores" en nav principal — se accede desde el detalle de una OC):
📊 Dashboard | 📦 Inventario | 🛒 Órdenes | ⚙️ Config
Pregunta para Serlyn: ¿El cliente tipo (dueño de ferretería) entra primero a ver el resumen o va directo a las órdenes? ¿Quieres "Proveedores" como sección separada desde el día 1 o puede estar enterrado en Configuración?
Tu respuesta:
DECISIÓN 2 — El dashboard principal: ¿qué métricas son las más importantes? ⚠️
El dashboard es lo primero que el cliente ve cada día. Necesitamos mostrar las 4-6 métricas más relevantes para que en 10 segundos el dueño sepa si su inventario está sano.
Candidatos de métricas:
| Métrica | Descripción | Urgencia |
|---|---|---|
| SKUs en stockout | Productos que ya no tienen stock | 🔴 Crítico |
| SKUs próximos a stockout | Productos que se acaban en <7 días | 🟠 Urgente |
| Órdenes pendientes de aprobación | OCs generadas esperando tu OK | 🟡 Acción requerida |
| Valor total en órdenes pendientes | En CRC — cuánto capital se va a comprometer | 🟡 Financiero |
| Precisión del motor (última semana) | % de veces que el pronóstico estuvo cerca | 🟢 Informativo |
| SKUs en calibración | Productos con pocos datos aún | 🟢 Informativo |
| Total de SKUs activos | Cuántos productos tiene el catálogo | 🟢 Contexto |
Pregunta para Serlyn: ¿Cuáles 4-5 de estas métricas son las que un dueño de ferretería miraría cada mañana? ¿Alguna que falta y sería crítica para tu prospecto?
Tu respuesta:
DECISIÓN 3 — Órdenes de compra: flujo de aprobación ⚠️
El motor genera órdenes de compra sugeridas. El cliente las revisa y aprueba (o rechaza). Hay dos flujos posibles:
Flujo A — Aprobación individual
Lista de OCs pendientes
↓
Ver detalle de la OC (proveedor, SKUs, cantidades, motivo)
↓
[Aprobar] o [Rechazar con comentario] o [Modificar cantidad]
↓
OC aprobada → se puede imprimir o enviar por email al proveedor
Flujo B — Aprobación masiva (bulk)
Lista de OCs pendientes con checkboxes
↓
Seleccionar varias
↓
[Aprobar seleccionadas] → se aprueban todas de golpe
↓ (opcional: ver detalle antes de aprobar)
Flujo C — Combinado (individual + bulk disponibles)
Ambos flujos estarán disponibles. ¿Cuál debe ser el flujo principal (el que aparece primero)?
Pregunta para Serlyn: ¿El cliente tipo va a revisar cada OC una por una o prefiere aprobar todo de golpe? ¿Cuántas OCs diarias esperaría tener en promedio una ferretería mediana?
Tu respuesta:
DECISIÓN 4 — Onboarding wizard: ¿cuántos pasos? ⚠️
Cuando un cliente nuevo entra por primera vez, necesita ser guiado. El wizard de onboarding tiene estos pasos propuestos:
Paso 1: Datos de la empresa (nombre, RUC/cédula jurídica, contacto)
↓
Paso 2: Subir inventario (CSV desde Excel o Google Sheets)
↓
Paso 3: Configurar proveedores (nombre, contacto, lead time promedio)
↓
Paso 4: Parámetros del motor (¿cuánto tiempo hacia adelante? ¿nivel de servicio?)
↓
Paso 5: Primer análisis (el motor corre y muestra los resultados)
Alternativa reducida (menos fricción):
Paso 1: Datos básicos de empresa
↓
Paso 2: Subir CSV de inventario
↓
Paso 3: Correr el motor → ver resultados
(Proveedores y parámetros avanzados se configuran después)
Pregunta para Serlyn: ¿Cuánto tiempo tiene disponible un dueño de ferretería para el onboarding inicial? ¿Preferiría ver resultados rápido (3 pasos) o preferiría configurarlo bien desde el principio (5 pasos)?
Tu respuesta:
DECISIÓN 5 — Detalle de SKU: qué información mostrar ⚠️
Cuando el cliente hace clic en un SKU específico, entra al detalle. ¿Qué información debe estar visible?
Información técnica disponible (marcar qué mostrar en la vista principal, qué en tab secundario, qué ocultar):
| Información | Vista principal | Tab "Técnico" | Ocultar |
|---|---|---|---|
| Stock actual | |||
| Punto de reorden (cuándo pedir) | |||
| Stock de seguridad (buffer mínimo) | |||
| Cantidad económica de pedido (EOQ) | |||
| Método de pronóstico asignado | |||
| Gráfico de demanda histórica | |||
| Pronóstico próximos 30 días | |||
| Clasificación ABC/XYZ | |||
| Patrón de demanda | |||
| Proveedor asignado | |||
| Lead time del proveedor | |||
| Historial de movimientos |
Pregunta para Serlyn: Para un dueño de ferretería mirando un SKU específico, ¿qué 3-4 datos son los más importantes en una primera mirada? ¿Alguno que crees que confundiría al cliente y mejor ocultarlo?
Tu respuesta:
No-gos propuestos (para confirmar) ⚠️
| No-go propuesto | ¿Confirmar? |
|---|---|
| No incluye ONVO Pay / billing en SM-3 — el cliente usa el producto gratis en piloto | [ ] Confirmar [ ] Vetar — razón: |
| No incluye integración Alegra — el cliente usa solo CSV por ahora | [ ] Confirmar [ ] Vetar — razón: |
| No incluye RBAC (roles múltiples) — solo el dueño accede en MVP | [ ] Confirmar [ ] Vetar — razón: |
| No incluye sitio web público — la app existe pero sin landing pública | [ ] Confirmar [ ] Vetar — razón: |
| No incluye app móvil — solo web responsive | [ ] Confirmar [ ] Vetar — razón: |
| No incluye exportación PDF de las órdenes — solo CSV | [ ] 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: Cualquier formato que te sea cómodo
Checklist — Shape listo para construcción
- [ ] Decisión 1 respondida (navegación principal)
- [ ] Decisión 2 respondida (métricas del dashboard)
- [ ] Decisión 3 respondida (flujo de aprobación de OCs)
- [ ] Decisión 4 respondida (steps del onboarding)
- [ ] Decisión 5 respondida (detalle de SKU)
- [ ] No-gos confirmados o vetados
Cuando todos los checkboxes estén marcados → Douglas empieza TASK-032 (SM-3).
Shape Request SM-3 · Dashboard Completo · Mayo 2026 · Cheryx Group