❯ cat /work/be-all.case
Be All
Plataforma híbrida de aprendizaje + comercio — cursos, webinars, productos físicos y digitales, un solo checkout
stack: Next.js 14 · MySQL · Prisma · Stripe · Clerk · Claude API
situación
Un negocio educativo en español necesitaba vender lo que la mayoría de las plataformas te obligan a repartir en tres herramientas: cursos en video, webinars en vivo, y productos físicos y digitales — además de manejar pagos, reembolsos y envíos para el mercado mexicano. La respuesta típica es un LMS pegado a una tienda pegada a una herramienta de eventos, con tres checkouts y tres paneles de admin. El encargo: una plataforma, un checkout, un back office.
evidencia
- Exhibit 1
- 31 modelos de Prisma
cursos con capítulos y progreso, webinars con cupo y precio early-bird, productos con inventario, órdenes unificadas
- Exhibit 2
- 84 rutas de API
cubriendo 16+ dominios: checkout, reembolsos, cupones, analítica, envíos, notificaciones, admin
- Exhibit 3
- tres ciclos de compra
un curso, un asiento de webinar y una playera se venden, reembolsan y contabilizan distinto — pero el negocio necesita un solo registro de órdenes
diagnóstico
El comercio híbrido fracasa cuando cada vertical desarrolla su propio pipeline de compra: los reembolsos y los reportes se fragmentan hasta que nadie puede responder '¿cuánto vendimos este mes?'. La arquitectura tenía que compartir un núcleo de órdenes, reembolsos y cupones entre verticales, dejando que cada una conserve su lógica de dominio — progreso para cursos, cupo para webinars, inventario para productos físicos.
intervención
- 01
Sistema de órdenes unificado sobre Stripe Checkout con fulfillment manejado por webhooks: los cursos se desbloquean, los productos digitales se entregan y las órdenes físicas entran a envío — todo desde un solo evento de pago.
- 02
Motor de reembolsos con máquina de estados real (pendiente → revisión → aprobado → procesando → completado), servicio de auto-aprobación por políticas configurables, audit log por estado, y liberación de asientos de webinar al reembolsar.
- 03
Sistema de cupones con descuentos por porcentaje, monto fijo y envío gratis, límites por usuario, targeting por categoría y rastro de auditoría completo (precio original, precio final, IP).
- 04
Núcleo de LMS: cursos en video por capítulos con progreso por usuario; webinars con ventanas early-bird, cupos y notificaciones de reagendado; reseñas de productos con workflow de aprobación.
- 05
Consultor de analítica con IA: un dashboard impulsado por Claude que lee métricas de ingresos, reembolsos y categorías a 30 días y responde preguntas sobre ellas, con exportación a Excel y PDF.
- 06
Flujos de email transaccional para cada tipo de compra, más dashboards de admin para órdenes, reembolsos y equipo.
resultado · verificado
- Exhibit 1
- 1 checkout
para tres verticales de producto con reglas distintas de fulfillment y reembolso
- Exhibit 2
- reembolsos auto-resueltos
el motor de políticas aprueba los casos rutinarios; los humanos solo ven las excepciones
- Exhibit 3
- en producción
vivo en beallfam.com sirviendo a un mercado hispanohablante