[CONSEJO — Doc 12] Contrarian: El mayor riesgo del roadmap de MindStack no es construir muy poco — es construir demasiado antes de tener clientes reales. Un portal con checkout funcional y onboarding de 5 pasos es suficiente para los primeros 10 clientes. El resto (referidos, partners, metering, expansion triggers) se construye cuando hay datos reales de qué palancas mueven la conversión. Executor: El criterio de "done" para el MVP del portal es exactamente uno: un cliente puede descubrir StockMind, registrarse, completar el onboarding, pagar vía ONVO Pay, y acceder al módulo — sin intervención manual del equipo de Cheryx. Si eso funciona, el portal MVP está listo.

1. Fases del portal

FASE 1 — MVP PORTAL (Semanas 1-8)
  Objetivo: Un cliente puede registrarse y pagar sin intervención manual.

FASE 2 — PLG ENGINE (Semanas 9-20)
  Objetivo: Activation rate D7 ≥35%. Referidos funcionando.

FASE 3 — EXPANSION ENGINE (Semanas 21-36)
  Objetivo: Cross-sell automatizado. Partners/CPA activos.

FASE 4 — ANALYTICS & RETENTION (Semanas 37+)
  Objetivo: Churn <3%. NPS >40. Expansion MRR >10% del MRR total.

2. Fase 1 — MVP Portal (Semanas 1-8)

Criterio de éxito: Cliente paga sin ayuda manual.

Semana 1-2: Auth + tenant

• [ ] /registro — formulario email + empresa + país + módulo elegido
• [ ] Verificación de email (Resend)
• [ ] Login con email/password (bcrypt + JWT)
• [ ] Modelo ms_tenants + ms_usuarios en Postgres
• [ ] Middleware de autenticación FastAPI

Semana 3-4: Subscriptions + trial

• [ ] GET /subscriptions/plans — planes disponibles con precios
• [ ] POST /subscriptions/trial — iniciar trial sin tarjeta
• [ ] Guardrail: un solo trial por módulo por tenant
• [ ] Activación del módulo StockMind en trial vía Redis event
• [ ] Email de bienvenida (D0 de la secuencia de onboarding)

Semana 5-6: Checkout + ONVO Pay

• [ ] POST /subscriptions/checkout — crear sesión ONVO Pay
• [ ] /checkout/[plan] — página de resumen antes de redirigir a ONVO
• [ ] Webhook handler POST /webhooks/onvo/payment_success
• [ ] Verificación de firma HMAC en webhook
• [ ] ms_billing_events con REVOKE UPDATE/DELETE
• [ ] Email de confirmación de pago

Semana 7-8: Dashboard básico + billing

• [ ] /dashboard — módulos activos del tenant
• [ ] /dashboard/billing — plan actual + próxima factura + historial
• [ ] POST /subscriptions/cancel — cancelación con confirmación
• [ ] Cron diario: verificar_trials_vencidos()
• [ ] Cron diario: procesar_renovaciones_proximas()
• [ ] Email de trial vencido (D14)

Deliverable: Portal desplegado en Coolify. URL de registro enviable a primeros prospectos.

3. Fase 2 — PLG Engine (Semanas 9-20)

Criterio de éxito: Activation rate D7 ≥35% (trial → momento aha completado).

Semana 9-11: Onboarding wizard

• [ ] /onboarding/[modulo] — wizard de 5 pasos por módulo
• [ ] StockMind Step 1-5: datos básicos → importar CSV → clasificación ABC → primera OC → activar plan
• [ ] Guardar onboarding_step en ms_tenants
• [ ] Progress bar visual en el wizard
• [ ] Email D3 si el usuario no completó el onboarding

Semana 12-14: Drip de onboarding

• [ ] Worker email_drip_worker — ejecutar secuencias diarias
• [ ] Secuencia D0-D14 completa (14 emails, ver Doc 04)
• [ ] Segmentación de secuencia por módulo (StockMind tiene su propio drip)
• [ ] WhatsApp D7 y D12 vía API básica
• [ ] A/B test subject lines D3 y D7 con PostHog

Semana 15-17: Referidos cliente-a-cliente

• [ ] Generar referral_code único por tenant al registrarse
• [ ] /dashboard/referidos — link único + créditos ganados
• [ ] Tabla ms_creditos con vencimiento 12 meses
• [ ] POST /subscriptions/apply-credit — aplicar crédito en checkout
• [ ] Email cuando el referido convierte ("Ganaste $349 en créditos")

Semana 18-20: MFA + seguridad

• [ ] POST /auth/mfa/setup — TOTP setup con QR
• [ ] POST /auth/mfa/verify — verificación en login
• [ ] OAuth Google
• [ ] Rate limiting en endpoints de auth
• [ ] Dashboard de seguridad: sesiones activas, historial de login

Deliverable: Activation rate medible. Primeros referidos orgánicos.

4. Fase 3 — Expansion Engine (Semanas 21-36)

Criterio de éxito: ≥20% de tenants con 2+ módulos activos.

Semana 21-24: Cross-sell automatizado

• [ ] ExpansionTriggerService — evaluar triggers por tenant diariamente
• [ ] Worker expansion_worker diario
• [ ] /dashboard — mostrar oferta del siguiente módulo si trigger activo
• [ ] ms_expansion_offers — una oferta activa por módulo por tenant
• [ ] A/B test: mostrar oferta en dashboard vs email dedicado

Semana 25-28: Programa de partners (CPA)

• [ ] POST /partners/register — registro de contador como partner
• [ ] Generar referral_code único de partner
• [ ] /partners/generate-link — link de referido con atribución
• [ ] ms_comisiones — cálculo automático al convertir referido
• [ ] Worker commission_worker mensual — liquidación de comisiones
• [ ] Dashboard de partner: referidos activos, comisiones pendientes, pagadas

Semana 29-32: Upgrade/downgrade de plan

• [ ] POST /subscriptions/upgrade — upgrade efectivo inmediatamente
• [ ] Downgrade al final del período (no retroactivo)
• [ ] Página /precios con toggle mensual/anual
• [ ] Badge "2 meses gratis" visible en toggle anual
• [ ] Migración de datos del módulo al cambiar tier

Semana 33-36: Metering + uso

• [ ] Worker usage_aggregate_worker cada 6 horas
• [ ] ms_uso_modulo — métricas por módulo reportadas desde cada app
• [ ] /tenant/usage — endpoint de uso actual del tenant
• [ ] Trigger de expansion basado en datos reales de uso
• [ ] Alerta automática si tenant se acerca al límite del plan

Deliverable: SalesMind disponible para cross-sell. Partners CPA activos (≥5 contadores).

5. Fase 4 — Analytics & Retention (Semanas 37+)

Criterio de éxito: Churn <3%/mes. NPS >40.

Churn prediction

• [ ] Worker churn_risk_worker — tenants sin login >7 días con suscripción activa
• [ ] Alerta interna (Slack/email) a equipo Cheryx con lista de riesgo
• [ ] Email de re-engagement automático D7 sin login
• [ ] Encuesta NPS a los 30, 90, 180 días de suscripción activa

Admin panel (interno Cheryx)

• [ ] /admin/tenants — lista de todos los tenants con estado y MRR
• [ ] /admin/mrr — MRR total, expansión, churn en tiempo real
• [ ] /admin/trials — trials activos y en qué paso del onboarding están
• [ ] /admin/billing — eventos de billing de las últimas 24h
• [ ] Acceso solo con 2FA y desde IP de Cheryx (Cloudflare Access)

BookMind y PayMind cross-sell

• [ ] Triggers para BookMind (empleados_en_fe ≥15 → PayMind offer)
• [ ] Landing pages /bookmind y /paymind live
• [ ] Onboarding wizard para BookMind y PayMind
• [ ] Drip de onboarding específico por módulo

6. Dependencias críticas del roadmap

7. Criterios de release por fase

Ver también: Doc 05 (Proyecciones Financieras — gates de MRR) · Doc 07 (SRD Backend — endpoints por fase) · Doc 13 (KPIs — métricas de éxito por fase)