Parte de MindStack Suite — ERP modular premium para PyME LATAM.

1. Resumen ejecutivo (60 segundos)

StockMind es el motor estadístico de inventarios para PyMEs latinoamericanas que operan entre Excel y un ERP corporativo. Para cada SKU, cada noche, el sistema clasifica el patrón de demanda, elige automáticamente entre ~14 algoritmos de pronóstico, calcula la política de reorden y genera órdenes de compra explicadas en español. El humano aprueba, edita o rechaza. El motor no es una caja negra: cada decisión tiene su justificación estadística auditable.

Para quién: PyMEs formales en Costa Rica (primero) con ventas anuales ≥$200,000 USD, inventario físico activo y factura electrónica vigente. Verticales prioritarios: ferreterías independientes (~1,400 en CR), distribuidoras de alimentos/bebidas (CACIA), importadoras (~3,000 registradas Hacienda), farmacias independientes (~860, desde V1.5).

Por qué importa: la PyME latinoamericana pierde 3-8% de sus ventas anuales por quiebres de stock e inventario mal gestionado (Gruen-Corsten-Bharadwaj 2002; IHL Group 2023-2025). El software contable existente (Alegra, Siigo, Bsale: $20-$152/mes) no tiene pronóstico estadístico real. Los especilistas globales (Lokad $150-$1,350/mes, Cin7 $349-$999/mes) no hablan español PyME ni integran la factura electrónica LATAM. StockMind ocupa el cuadrante vacío: alta sofisticación matemática × accesibilidad para PyME mediana.

Pricing: Starter $199 / Growth $349 / Pro $1,099 / Enterprise desde $1,800 USD/mes. ARPU ponderado año 1: $551. Target mes 12 (caso base): 40 clientes / $22k MRR.

Estructura: StockMind es módulo #1 del portfolio MindStack Suite (ERP modular: StockMind + SalesMind + BookMind + PayMind). No es un startup standalone: Cheryx Group absorbe infraestructura y salario del desarrollador. Dos cofundadores: Douglas Mora (full técnico, único developer) + Serlyn Caruzo (product/GTM). Fase actual: pre-MVP, comenzando Sprint 1.

2. Mapa de los 15 Documentos

3. Decisiones Clave Tomadas

Claims explícitamente falsos — nunca usarlos: - ❌ Inversionista ángel $50k — no existe - ❌ Stripe como pasarela primaria — no opera en CR - ❌ Cap table 47%/47% + ESOP 6% — no aplica pre-constitución - ❌ 18 entrevistas + 64 encuestas + 2 pilotos — alucinación del modelo anterior

4. Stack Tecnológico

┌──────────────────────────────────────────────────────────────────┐
│                   Cloudflare (DNS + WAF + Email Routing)         │
└──────────────────────────────┬───────────────────────────────────┘
                               │ HTTPS 443
                               ▼
┌──────────────────────────────────────────────────────────────────┐
│             Hostinger KVM2 (2 vCPU · 8 GB RAM · 100 GB NVMe)    │
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐    │
│  │              Coolify v4 (PaaS self-hosted)               │    │
│  │           Traefik Proxy + TLS automático                 │    │
│  └────────────────────────────┬─────────────────────────────┘    │
│                               │                                  │
│   ┌───────────┐   ┌───────────┴──┐   ┌──────────────┐          │
│   │  Next.js  │   │  FastAPI     │   │ Celery Worker │          │
│   │   15 +    │   │  Python 3.12 │   │ (motor noche) │          │
│   │ React 19  │   │  Pydantic v2 │   │               │          │
│   │ Tailwind  │   │  SQLAlchemy  │   └──────┬────────┘          │
│   │ shadcn/ui │   └──────┬───────┘          │                   │
│   └───────────┘          │                  │                   │
│                    ┌─────┴──────┐    ┌──────┴──────┐           │
│                    │ Postgres 17│    │   Redis 7   │           │
│                    │  (multi-   │    │  (broker +  │           │
│                    │  tenant)   │    │   cache)    │           │
│                    └─────┬──────┘    └─────────────┘           │
└──────────────────────────┼──────────────────────────────────────┘
                           │ pg_dump diario
                           ▼
                   Backblaze B2 (backups cifrados)

Motor estadístico: statsforecast (Nixtla) + Prophet + LightGBM
Pagos: ONVO Pay (primaria) + Tilopay (backup)
Email: Resend (transaccional) · Cloudflare Email Routing (corporativo MVP)
Observabilidad: Sentry · Plausible · Uptime Kuma
CI/CD: GitHub Actions + Coolify webhooks

5. Checklist Pre-Lanzamiento

Bloque Legal / Fiscal

• [ ] Verificar EUIPO STOCKMIND/CaixaBank (5-10 min, euipo.europa.eu/eSearch)
• [ ] Registrar dominio stockmind.app + defensivos (usestockmind.com, stockmind.co.cr)
• [ ] Inscribir actividad lucrativa Douglas en DGT (D-140 vía ATV) si aún no hecho
• [ ] Activar facturación electrónica v4.4 con llave criptográfica
• [ ] Firmar carta de intención interna Douglas/Serlyn/Cheryx (40/40/20) antes del primer cliente pagando
• [ ] Registrar bases de datos en PRODHAB antes del primer cliente
• [ ] Firmar contrato de servicios profesionales Douglas ↔ Serlyn
• [ ] Contratar asesoría contable mínima ($100/mes)
• [ ] Registrar marca STOCKMIND en CR (clases 9+35+42, ~$800-$1,050)
• [ ] Revisar ToS y Política de Privacidad con abogado CR ($1,500)

Bloque Técnico / Infraestructura

• [ ] Provisionar repo GitHub Team para StockMind
• [ ] Configurar Coolify en VPS Hostinger KVM2 (ya operativo en Cheryx — asignar proyecto)
• [ ] Crear base de datos Postgres 17 con schema inv_* y multi-tenancy
• [ ] Configurar Redis y Celery Beat
• [ ] CI/CD GitHub Actions → Coolify webhook funcionando
• [ ] Backups Backblaze B2 configurados y probados (restore de prueba)
• [ ] Dominio app.stockmind.app apuntando a Coolify con TLS
• [ ] Sentry integrado (free tier, primeros 5k events)
• [ ] Uptime Kuma funcionando para status page
• [ ] Secrets en Coolify UI (nunca en .env commiteado)

Bloque Producto / GTM

• [ ] Plantilla CSV de importación definida con Serlyn
• [ ] 3-5 pilotos comprometidos por escrito (Founder Pilot Program)
• [ ] Demo environment con datos sintéticos de ferretería funcionando
• [ ] ONVO Pay sandbox integrado y testeado
• [ ] Onboarding flow documentado (paso a paso)
• [ ] Landing page www.stockmind.app con lista de espera activa
• [ ] WhatsApp Business Account en proceso de verificación Meta

Bloque Métricas / Operaciones

• [ ] Dashboard MRR/clientes/churn en Postgres + query semanal
• [ ] Plausible Analytics en sitio web activo
• [ ] Runbook de deploy y rollback documentado
• [ ] Runbook de restore de DB probado trimestralmente
• [ ] Checklist de health check nocturno del motor estadístico

6. Rutas de Lectura por Rol

Founder (Douglas Mora)

1. Este índice → entender la estructura completa
2. Doc 12 (Roadmap) → siguiente acción inmediata: Sprint 1
3. Doc 07 (SRD Backend) → arquitectura técnica de referencia
4. Doc 08 (Modelo de Datos) → schema SQL antes de escribir código
5. Doc 09 (Motor Core) → pipeline estadístico completo
6. Doc 10 (Seguridad) → seguridad desde el día 1
7. Doc 05 (Finanzas) → cuando el primer cliente firme
8. Doc 14 (Marco Legal) → antes del primer cliente pagando

Cofounder GTM (Serlyn Caruzo)

1. Este índice → contexto completo del producto
2. Doc 01 (Modelo de Negocio) → propuesta de valor y pricing
3. Doc 02 (Análisis de Mercado) → verticales y competidores
4. Doc 04 (GTM) → plan de adquisición y outreach
5. Doc 11 (Branding) → voz de marca para materiales de ventas
6. Doc 13 (KPIs) → qué métricas trackear y cómo reportar
7. Doc 12 (Roadmap) → qué llega cuándo para alinear expectativas de pilotos

Asesor / Inversionista

1. Este índice → resumen ejecutivo y decisiones clave (Sección 3)
2. Doc 01 (Modelo de Negocio) → unit economics y moats
3. Doc 02 (Análisis de Mercado) → TAM/SAM/SOM y competidores
4. Doc 05 (Finanzas) → proyecciones 3 años, escenarios
5. Doc 03 (Riesgos) → matriz de riesgos y mitigaciones
6. Doc 14 (Marco Legal) → estructura societaria

Developer / Contratista técnico

1. Doc 07 (SRD Backend) → arquitectura y API completa
2. Doc 08 (Modelo de Datos) → schema SQL
3. Doc 09 (Motor Core) → pipeline estadístico
4. Doc 06 (SRD Frontend) → especificación UI/UX
5. Doc 10 (Seguridad) → auth, RBAC, cumplimiento
6. Doc 12 (Roadmap) → sprints y priorización

Cliente potencial

1. Doc 01 §1-§3 → propuesta de valor y ROI por vertical
2. Doc 11 §1-§3 → identidad y confianza de marca
3. Doc 02 §4.8 → tabla comparativa vs competidores

7. Estado del Proyecto a Mayo 2026

Siguiente acción inmediata: Sprint 1 — fundamentos de infraestructura + schema base + auth magic link. Ver Doc 12 §4.1 para detalle completo de tareas y criterios de Done.