Para qué es este documento: SM-7 es el ciclo más grande y de mayor impacto comercial: abre la plataforma a integradores (API pública), entra a Colombia, soporta perecederos (FEFO), lanza la app móvil, y habilita SSO para cuentas Enterprise. Las decisiones de este documento tienen implicaciones estratégicas de mercado que Serlyn debe validar antes de que Douglas empiece a construir.
Qué ya está construido antes de SM-7
Para cuando empiece SM-7: - Producto maduro en mercado CR con clientes pagos - Motor con 14 métodos (incluyendo Prophet y LightGBM) - Multi-empresa operativo - Sistema de billing y dunning funcionando
Lo que SM-7 construye: - API REST pública: integradores y clientes Enterprise pueden conectar sus propios sistemas a StockMind - Webhooks salientes: StockMind notifica a sistemas externos cuando se aprueba una OC - Shopify integration: ventas en Shopify llegan automáticamente al motor - Expansión Colombia: NIT, IVA CO, integración Siigo, precios en COP - FEFO (First Expired First Out): soporte para SKUs con fecha de vencimiento (farmacias, alimentos) - App React Native (iOS + Android): la app del dueño para aprobar OCs desde el celular - SSO Enterprise SAML 2.0: empresas con Active Directory/Okta pueden usar sus credenciales corporativas
Qué decidir antes de construir
DECISIÓN 1 — Colombia: ¿en SM-7 o lo aplazamos? ⚠️
Colombia es el segundo mercado más grande de LATAM para nuestro ICP. Pero agregar un mercado tiene costo real: - Regulaciones fiscales distintas (NIT, IVA CO, formato de reportes DIAN) - Integración Siigo (ERP dominante en CO, diferente a Alegra) - PayU como pasarela (ONVO Pay no opera en Colombia) - Soporte al cliente en horario CO (+1h CR)
Gates de expansión (según stockmind/wiki/08-roadmap.md): 1. ≥10 clientes CR pagos y estables 2. ≥1 referencia CR que tenga contacto en Colombia 3. Validación de al menos 5 prospectos CO con intent de compra 4. Douglas disponible para sprints adicionales
Pregunta para Serlyn: ¿Tienes contactos en Colombia que hayan expresado interés real? ¿Estás segura de que cumpliremos los 4 gates antes de SM-7, o Colombia debería ser SM-8?
Tu respuesta (estado de Colombia y si incluirla en SM-7):
DECISIÓN 2 — App móvil: ¿cuál es el caso de uso principal? ⚠️
La app móvil propuesta no es una réplica de la web app — es el "teléfono de guardia" del dueño. El foco está en las acciones urgentes que no pueden esperar hasta el escritorio.
Pantallas propuestas para V1 móvil: 1. Dashboard de alertas (SKUs en stockout, OCs urgentes) 2. Aprobar o rechazar OCs con un tap 3. Notificaciones push de alertas críticas del motor
Fuera del alcance móvil V1: - Subir CSV (es operación de escritorio) - Ver el detalle técnico del pronóstico - Configurar la empresa o usuarios
Pregunta para Serlyn: ¿En las conversaciones con prospectos, el tema "quiero ver esto desde el celular" salió? ¿O fue "quiero recibir la alerta en el celular"? (Son dos cosas distintas.) ¿Priorizar iOS o Android primero para el ICP ferretería CR/CO?
Tu respuesta:
DECISIÓN 3 — API pública: ¿quién la usaría realmente? ⚠️
La API pública permite que otros sistemas se conecten a StockMind. Casos de uso posibles:
| Tipo de integrador | Qué haría con la API |
|---|---|
| Contadores / asesores de PyMEs | Conectar StockMind a sus propios dashboards de clientes |
| Desarrolladores del cliente Enterprise | Integrar las OCs de StockMind en su ERP propio |
| ISVs (software houses CR/CO) | Construir integraciones para sus clientes sobre StockMind |
| El propio equipo Cheryx | Conectar StockMind a SalesMind o BookMind (suite interna) |
Pregunta para Serlyn: ¿Tienes conversaciones abiertas con contadores o asesores que podrían ser distribuidores indirectos? ¿Algún cliente Enterprise que ya pidió API access explícitamente?
Tu respuesta:
DECISIÓN 4 — FEFO (perecederos): ¿es una prioridad en SM-7? ⚠️
FEFO (First Expired First Out) permite que el motor considere fechas de vencimiento al hacer pronósticos. Aplica a: - Farmacias independientes - Distribuidoras de alimentos / snacks - Empresas con insumos perecederos
El ICP principal de CR son ferreterías y distribuidoras. Farmacias son el 4° vertical — y el segmento está en contracción.
Pregunta para Serlyn: ¿Tienes prospectos activos en farmacia o alimentos que están esperando FEFO específicamente para comprar? Si no hay demanda concreta, FEFO puede salir de SM-7 para liberar capacidad para Colombia o la app móvil. ¿Cuál pesa más?
Tu respuesta (FEFO sí/no en SM-7 y por qué):
DECISIÓN 5 — Shopify: ¿cuántos prospectos tienen tienda en línea? ⚠️
La integración Shopify permite que las ventas en línea lleguen automáticamente al motor sin que el cliente tenga que exportar CSV cada semana. Es relevante para ferreterías que venden también en línea.
Costo de construcción: ~15-20 horas de Douglas (en SM-2 ya se planificó en el scope).
Pregunta para Serlyn: ¿Qué porcentaje de los prospectos con los que has hablado tienen tienda Shopify activa? Si la respuesta es <20%, puede ser más valioso usar ese tiempo en otra integración (MercadoLibre, WooCommerce, etc.). ¿Tienes datos de esto?
Tu respuesta (% con Shopify, y si hay otro canal de e-commerce más frecuente):
No-gos propuestos (para confirmar) ⚠️
| No-go propuesto | ¿Confirmar? |
|---|---|
| No incluye México/Perú/Chile en SM-7 — Colombia es suficiente como expansión piloto | [ ] Confirmar [ ] Vetar — razón: |
| No incluye marketplace de integraciones — la API es directa, sin catálogo público | [ ] Confirmar [ ] Vetar — razón: |
| No incluye WooCommerce — Shopify primero, WooCommerce si hay demanda post-SM-7 | [ ] Confirmar [ ] Vetar — razón: |
| La app móvil en SM-7 es solo aprobación de OCs + alertas — no es la web app completa | [ ] Confirmar [ ] Vetar — razón: |
| SSO Enterprise solo para clientes con plan Enterprise activo | [ ] Confirmar [ ] Vetar — razón: |
¿Hay algún no-go que agregarías?:
Nota sobre el alcance de SM-7
SM-7 tiene 6 semanas y es el ciclo más ambicioso del roadmap. Hay un riesgo real de que sea demasiado grande. Si al llegar al Betting Table de SM-7 Serlyn o Douglas tienen dudas sobre el scope, la regla de Shape Up aplica: se corta el scope, no se extiende el tiempo. Las features candidatas a salir si hay presión son, en este orden: FEFO → Shopify → SSO Enterprise.
Cómo entregar tus respuestas
Opción 1: Responder directamente en este doc
Opción 2: Conversación de 45 minutos con Douglas (este ciclo necesita más alineación)
Opción 3: Voice note / video
Checklist — Shape listo para construcción
- [ ] Decisión 1 respondida (Colombia: incluir o aplazar)
- [ ] Decisión 2 respondida (caso de uso principal de la app móvil)
- [ ] Decisión 3 respondida (perfil del integrador de la API)
- [ ] Decisión 4 respondida (FEFO: prioridad sí/no)
- [ ] Decisión 5 respondida (Shopify: demanda real confirmada)
- [ ] No-gos confirmados o vetados
Cuando todos los checkboxes estén marcados → Douglas empieza TASK-063 (SM-7).
Shape Request SM-7 · API Pública + Expansión Geográfica · Mayo 2026 · Cheryx Group