[CONSEJO — Doc 12] Contrarian: El roadmap más peligroso es el que tiene demasiadas features en V1.0. Cada feature adicional en MVP es semanas de build más, y cada semana sin clientes es señal que no se ha validado. El MVP correcto es el producto más pequeño con el que puedes cerrar el primer cliente pago. First Principles: La pregunta que define el roadmap no es "¿qué features queremos?" sino "¿qué tiene que funcionar perfectamente para que el primer ferretero saque la tarjeta?" Si la respuesta es "el motor + las OCs sugeridas + el upload de inventario", eso es el MVP. Todo lo demás es V1. Expansionist: El roadmap tiene que reservar capacidad para Colombia en mes 14–18. Si el equipo llega al mes 14 con deuda técnica que hace imposible agregar un país nuevo sin refactorizar todo, el roadmap falló. La expansión multi-país se diseña desde el día 1. Outsider: El 80% de los SaaS no lanzan a tiempo. El 90% de los que se atrasan, se atrasan por cambiar el scope en el medio del sprint. La disciplina de no agregar features al MVP es más importante que la velocidad de build. Executor: Las estimaciones de este roadmap asumen 19 story points por sprint (Douglas 50% + Serlyn 30%). Si Douglas sube a 70%, el roadmap se acorta 30%. Si hay una semana mala o un bug grave, el sprint se retrasa. Este es el plan base — ajustar trimestralmente. Security Auditor: El MVP no puede salir sin los controles básicos de seguridad: magic link de un solo uso, HTTPS obligatorio, tenant isolation en PostgreSQL. La seguridad no es un feature de V1.1. Chairman: El roadmap es una hipótesis, no un contrato. Lo que no cambia: el orden (motor primero, UI segundo, integraciones tercero). Lo que sí puede cambiar: el timing, las features específicas de cada versión, el orden de países.
1. Capacidad del equipo
| Persona | Dedicación a StockMind | Story Points/Sprint estimados |
|---|---|---|
| Douglas Mora | 50% (20h/semana) | ~15 SP (backend heavy) |
| Serlyn Caruzo | 30% (12h/semana) | ~4 SP (PM + frontend support + ventas) |
| Total equipo | — | ~19 SP/sprint |
Supuestos de velocidad: - Sprint: 1 semana - 1 SP = ~4-6 horas de trabajo enfocado - Velocidad inicial (mes 1–2): 15 SP/sprint (curva de arranque) - Velocidad régimen (mes 3+): 19 SP/sprint
Eventos que afectan velocidad (planear buffer de 15%): - Bug crítico de producción: -3 SP en la semana - Onboarding de cliente piloto: -2 SP (Douglas) en la semana - Semana de validación de mercado (Serlyn): -2 SP
2. MVP — Motor + OCs básicas (Semanas 1–12)
Objetivo: tener el sistema funcionando con datos reales de al menos 1 cliente piloto, con las 3 pantallas críticas y el motor corriendo.
Criterios de salida MVP (7 de 8 deben cumplirse): - [ ] Motor corre el pipeline de 11 pasos sin errores en dataset de 500+ SKUs reales - [ ] Clasificación ABC×XYZ×SB produce resultados correctos (validados con cálculo manual) - [ ] Al menos 8 de 12 métodos de pronóstico implementados y con backtest funcionando - [ ] Guardrails G1–G15 implementados y con tests unitarios - [ ] Upload CSV funciona con template estándar y validación de errores - [ ] Dashboard muestra resumen de estado del inventario (sin requerir actualización manual) - [ ] Pantalla de detalle de SKU con forecast + explicación en español - [ ] Pantalla de OCs sugeridas con aprobación/rechazo
Lo que NO está en MVP (explícitamente excluido): - ❌ Integración Alegra (V1.0) - ❌ Facturación / subscripción ONVO Pay (V1.0) - ❌ Sitio web público (V1.0) - ❌ Prophet y LightGBM (V1.1) - ❌ Multi-empresa / multi-país (V1.5) - ❌ App nativa móvil (V2.0)
2.1 Sprints MVP
| Sprint | Semana | Foco | Entregables clave |
|---|---|---|---|
| S1 | 1 | Setup infraestructura + schema inicial | Coolify configurado, PostgreSQL corriendo, FastAPI base con auth magic link |
| S2 | 2 | Motor — ingestion + cleaning | sm_stock_movements cargando desde CSV, step 1-2 del pipeline |
| S3 | 3 | Motor — clasificación ABC×XYZ×SB | Steps 3-4, unit tests de clasificación con fixtures |
| S4 | 4 | Motor — métodos SES + Naïve + CrostonTSB | Steps 5-6, backtest expanding window funcionando |
| S5 | 5 | Motor — métodos HW-Add + THETA + AutoETS + Croston Opt | Completar 8 métodos MVP |
| S6 | 6 | Motor — policy + guardrails + persist | Steps 8-11, guardrails G1-G15, escribir en sm_forecast_results |
| S7 | 7 | API — endpoints de inventario + forecast | GET /inventory/skus, GET /forecast/skus/{id}, GET /inventory/summary |
| S8 | 8 | API — endpoints de OCs | GET/POST /orders, POST /orders/approve, POST /orders/reject |
| S9 | 9 | Frontend — Dashboard + Inventario list | Pantalla dashboard con resumen, lista de SKUs con filtros |
| S10 | 10 | Frontend — SKU detail + OCs screen | Pantalla detalle SKU con forecast chart, pantalla OCs pendientes |
| S11 | 11 | Frontend — Onboarding wizard + CSV upload | Setup wizard 3 pasos, upload y validación de CSV |
| S12 | 12 | QA + primer piloto + hardening | Bug fixing, primer cliente piloto onboarded, tests de integración |
3. V1.0 — Producto comercial (Semanas 13–24)
Objetivo: lanzar el producto comercialmente con facturación, sitio web y primer canal de integración (Alegra).
Criterios de salida V1.0 (12 de 14): - [ ] Subscripción y facturación funcionando (ONVO Pay) - [ ] Sitio web público en stockmind.io (landing + pricing + blog) - [ ] Starter plan funcional con self-service signup - [ ] Integración Alegra (pull de productos y movimientos) - [ ] 3 de 5 pilotos convertidos a pago - [ ] Churn mes 4-6 < 8% - [ ] NPS pilotos ≥ 7 - [ ] Motor estable (0 bugs críticos en 30 días consecutivos) - [ ] Uptime ≥ 99% en últimas 4 semanas - [ ] Email transaccional (alertas de OC urgente, bienvenida, weekly summary) - [ ] Documentación de usuario (FAQ + guía de onboarding) - [ ] 10 clientes activos al final del período - [ ] RBAC completo (Owner/Manager/Viewer) ✓ - [ ] Audit trail operativo ✓
3.1 Features V1.0
| Feature | Prioridad | SP estimados |
|---|---|---|
| ONVO Pay checkout + webhooks | Must | 12 |
| sm_subscriptions + billing logic | Must | 8 |
| Sitio web Next.js (landing + pricing) | Must | 16 |
| Integración Alegra (pull) | Must | 12 |
| Email transaccional (Resend templates) | Must | 8 |
| RBAC completo | Must | 6 |
| Audit trail sm_audit_log | Must | 6 |
| Stripe→ONVO Pay webhook hardening | Must | 4 |
| Documentación usuario (Notion o Gitbook) | Should | 8 |
| Reportes básicos (resumen mensual) | Should | 10 |
| Exportación de datos CSV | Should | 6 |
| Total estimado V1.0 | ~96 SP (~5 sprints) |
4. V1.1 — Canales + Motor completo (Semanas 25–36)
Objetivo: activar canal de partners CPAs, completar el motor con Prophet + LightGBM, y empezar el programa de partners.
Features V1.1:
| Feature | Prioridad | Impacto |
|---|---|---|
| Prophet (método 13) | Must | Motor más preciso en series con estacionalidad compleja |
| LightGBM (método 14) | Must | Motor más preciso en demanda errática con features |
| Programa partners CPAs (portal) | Must | CAC $0 del canal CPA, 20% revshare |
| Integración Alegra (push OCs aprobadas) | Should | Sincronización bidireccional |
| Integración Mercado Libre CR | Should | Canal e-commerce growing |
| Integración Siigo (Colombia — preparar expansión) | Could | Pre-work para V1.5 |
| Multi-empresa (una cuenta, múltiples bodegas) | Should | Distribuidoras con múltiples puntos de venta |
| Weekly summary email automático | Must | Reducir churn por falta de engagement |
| Dashboard de proveedores con historial de precios | Could | Análisis de variación de costos |
5. V1.2 — Escala + API pública (Semanas 37–48)
Objetivo: preparar StockMind para escalar a Colombia sin refactorización mayor.
Features V1.2:
| Feature | Prioridad |
|---|---|
| OAuth 2.0 (además de magic link) | Should |
| API REST pública documentada (OpenAPI/Swagger) | Must |
| Webhooks salientes (notificar sistemas externos de OCs aprobadas) | Should |
| Integración Shopify (e-commerce) | Should |
| Performance optimization (forecast batch <30 min para 10k SKUs) | Must |
| Direct DB connector (importación desde PostgreSQL/MySQL del cliente) | Could |
i18n completo español Colombia (es-CO) |
Must (pre-V1.5) |
6. V1.5 — Colombia + FEFO (Semanas 49–64)
Objetivo: primer mercado de expansión. Colombia requiere adaptaciones específicas.
Adaptaciones para Colombia:
- Integración Siigo (ERP dominante en CO)
- Integración PayU / ePayco (pagos CO)
- i18n es-CO (léxico local)
- Entidades fiscales CO (NIT, RUT)
- FEFO (First Expired First Out) para farmacias y alimentos — habilita vertical farmacias
Gates de expansión Colombia: - ✅ ≥150 clientes activos en CR - ✅ ARR ≥$1.5M en CR - ✅ Churn mensual <3% en CR - ✅ Motor estable con 0 bugs críticos en 60 días - ✅ Al menos 1 cliente colombiano piloto en lista de espera
7. V2.0 — México + App nativa (Semanas 65–80)
Objetivo: segundo mercado de expansión (México) + aplicación nativa iOS/Android.
Adaptaciones para México:
- CFDI (facturación electrónica MX — obligatoria para emitir OCs electrónicas)
- Integración Conekta / Stripe MX (pagos MX — Stripe sí soporta MX)
- Integración Aspel NOI o CONTPAQi (ERPs dominantes en MX)
- Integración Mercado Libre MX
- i18n es-MX
App nativa (React Native): - Alcance inicial: dashboard + alertas + aprobación de OCs - No es una app completa — es el "teléfono de guardia" del dueño de ferretería - Notificaciones push para alertas de stockout crítico
8. V2.1 — Enterprise + SOC 2 prep (Semanas 81–96)
Objetivo: habilitar ventas Enterprise con requisitos de seguridad avanzados.
Features V2.1: - SSO Enterprise (SAML 2.0 / Okta) - SOC 2 Type I audit preparación - Supplier intelligence portal (portal de proveedor con visibilidad de OCs entrantes) - Advanced analytics (cohort analysis, demand sensing, intelligence report) - SLA contractual ≥99.9% uptime - Dedicated onboarding manager para cuentas Enterprise >100 SKUs
9. Gates de portfolio Cheryx
El avance de StockMind desbloquea los módulos hermanos. Las decisiones de inicio de cada módulo son independientes y se toman en el momento del gate, no antes.
| Gate | Condición (ambas deben cumplirse) | Módulo que desbloquea | Mes estimado |
|---|---|---|---|
| Gate#1 | ≥250 clientes activos + ARR ≥$3M | SalesMind (build) | Mes 30 |
| Gate#2 | SalesMind ≥200 clientes + ARR conjunto ≥$10M | BookMind (M&A preferido) | Mes 54 |
| Gate#3 | BookMind operativo + ARR conjunto ≥$15M | PayMind (M&A preferido) | Mes 84 |
Nota: los gates son criterios, no promesas. Si StockMind llega al mes 30 con 180 clientes y $2.5M ARR, Gate#1 no se abre hasta alcanzar ambas condiciones.
10. Tabla resumen del roadmap
| Versión | Período | MRR objetivo al cierre | Clientes objetivo | Feature estrella |
|---|---|---|---|---|
| MVP | Mes 1–3 | $0 (pilotos) | 5 pilotos | Motor completo + OCs |
| V1.0 | Mes 4–6 | $4,500 | 10 pagos | Facturación + Alegra |
| V1.1 | Mes 7–9 | $10,000 | 22 | Prophet + LightGBM + CPAs |
| V1.2 | Mes 10–12 | $22,000 | 40 | API pública + Shopify |
| V1.5 | Mes 13–16 | $36,000 | 65 | Colombia + FEFO |
| V2.0 | Mes 17–20 | $60,000 | 110 | México + App nativa |
| V2.1 | Mes 21–24 | $80,000 | 145 | Enterprise + SOC 2 |
11. Deuda técnica permitida vs. prohibida
11.1 Deuda técnica permitida en MVP (pagar en V1.0)
- UI sin tests automatizados (Playwright en V1.0)
- Sin CI/CD completo (GitHub Actions básico en V1.0)
- Sin multi-región (un solo VPS hasta 200 clientes)
- Sin sistema de permisos granular por feature flag (flags simples por plan en MVP)
11.2 Deuda técnica NUNCA aceptada
- Motor sin tests unitarios (coverage <95% es un bloqueante de deploy)
- Tenant isolation roto (cualquier bug de cross-tenant data es P0)
- Secrets en el repositorio
- API endpoints sin validación de autenticación
- Logs con datos personales de clientes
Ver también: Doc 05 (Proyecciones Financieras — MRR objetivos por versión) · Doc 07 (SRD Backend — detalles técnicos de implementación) · Doc 09 (Motor Core — features del motor por versión) · wiki/08-roadmap.md (roadmap técnico detallado con sprints semana a semana)