Decisiones Técnicas

Este documento explica las decisiones técnicas clave del proyecto y sus justificaciones.

1. Video Hosting: AWS S3 + CloudFront o Azure Blob Storage

Decisión

Soportar dos proveedores de almacenamiento seleccionables mediante STORAGE_PROVIDER:

• aws — AWS S3 + CloudFront (predeterminado)
• azure — Azure Blob Storage

Alternativas Consideradas

opción	Pros	Contras
AWS S3 + CloudFront	Pago por uso, escalable, CDN global	Más complejo de configurar (2 servicios)
Azure Blob Storage	Configuración más simple, SAS URLs integradas	Sin CDN dedicado (latencia variable)
YouTube (unlisted)	Gratis, fácil	Sin control, ads posibles, no profesional
Vimeo Pro	Player profesional	$20/mes mínimo, límites de almacenamiento
Bunny.net	Más barato	Menos integración con el ecosistema

Justificación

1. Flexibilidad operativa: Cada deployment puede elegir el proveedor que mejor encaja (precio, región, acuerdos existentes)
2. Pago por uso: ambos son ~$0.02/GB almacenamiento
3. URLs privadas: CloudFront Signed URLs (AWS) y SAS URLs temporales (Azure) — mismo nivel de seguridad
4. Escalable: ambos crecen automáticamente con el uso
5. Un solo env var: cambiar de proveedor solo requiere actualizar STORAGE_PROVIDER

Costo Estimado

AWS S3 + CloudFront:

100GB videos almacenados = $2.30/mes
50GB transferencia CloudFront/mes = $4.25/mes
Total: ~$6.55/mes

Azure Blob Storage:

100GB videos almacenados = $1.80/mes (LRS)
50GB transferencia de salida/mes = ~$4.50/mes
Total: ~$6.30/mes

---

2. Pricing Model: Individual + Suscripción

Decision

Ofrecer tanto compra individual de cursos como suscripciones mensuales/anuales.

Alternativas Consideradas

opción	Pros	Contras
Solo suscripción	Ingresos recurrentes	Barrera alta para nuevos usuarios
Solo individual	Baja barrera de entrada	Sin ingresos recurrentes
Ambos	Maxima flexibilidad	Más complejo de implementar

Justificacion

1. Conversion: Cursos individuales para usuarios casuales
2. Retencion: Suscripciones para usuarios comprometidos
3. Descuento anual: Incentiva compromiso a largo plazo
4. Stripe: Ya soporta ambos modelos sin costo adicional

Precios Sugeridos

Plan	Precio	descripción
Curso Individual	$29-99	Acceso de por vida al curso
Mensual	$19/mes	Acceso a todos los cursos
Anual	$149/ano	~35% descuento vs mensual

---

3. Localizacion: Hardcode Spanish

Decisión

Hardcodear todo el contenido en español en lugar de usar i18n.

Alternativas Consideradas

opción	Pros	Contras
i18n (react-intl, etc)	Multi-idioma futuro	Complejidad adicional
Hardcode Spanish	Simple, rápido	Solo español
Parametrizable	Flexible	Over-engineering

Justificación

1. Mercado objetivo: Hispanohablantes en Latinoamérica
2. Simplicidad: Menos código, menos bugs
3. Performance: Sin overhead de i18n
4. Evolucion: Se puede agregar i18n después si es necesario

implementación

app/src/shared/content/es.ts

export const content = {
  auth: {
    login: "Iniciar sesión",
    signup: "Crear Cuenta",
    // ...
  },
  courses: {
    catalog: "Catalogo de Cursos",
    enroll: "Inscribirme",
    // ...
  },
};

---

4. Comunidad: Post-Launch (Fase 2)

Decision

No incluir features de comunidad (foros, Q&A) en el MVP.

Alternativas Consideradas

opción	Pros	Contras
Incluir en MVP	Feature completa	Retrasa lanzamiento
Post-launch	Lanzamiento rápido	Sin comunidad inicial
Terceros (Discord)	fácil, gratis	Fuera de la plataforma

Justificacion

1. Enfoque: Primero el core (cursos + pagos)
2. validación: Verificar que hay usuarios antes de construir comunidad
3. Complejidad: Foros requieren moderacion, notificaciones, etc.
4. Alternativa temporal: Discord/Slack para early adopters

Plan Post-Launch

1. Lanzar MVP (Fases 1-7)
2. Conseguir primeros 100 usuarios
3. Validar necesidad de comunidad
4. Implementar Fase 8 si hay demanda

---

5. Certificados: PDF Server-Side

Decisión

Generar certificados como PDFs en el servidor.

Alternativas Consideradas

opción	Pros	Contras
PDF server-side	Control total, profesional	Más código
Imagen estática	Simple	No descargable
Servicio tercero	Menos código	Costo adicional, dependencia
LinkedIn certificates	integración social	Requiere partnership

Justificación

1. Control: Diseño personalizado con branding
2. Sin dependencias: No requiere servicios externos
3. Descargable: Los usuarios valoran PDFs
4. Verificable: Se puede agregar URL de verificación

implementación

server/certificates.ts

import PDFDocument from "pdfkit";

export async function generateCertificatePDF({
  userName,
  courseName,
  completionDate,
}: CertificateData): Promise<string> {
  const doc = new PDFDocument();
  // ... generar PDF
  // Subir a S3
  // Retornar URL
}

---

6. Framework: Wasp

Decision

Mantener Wasp como framework (heredado del template Open SaaS).

Ventajas de Wasp

1. Full-stack: Frontend + Backend + DB en un solo lugar
2. Type-safe: Tipos generados automaticamente
3. Auth built-in: Email/password, OAuth, etc.
4. Operations: Queries/Actions con cache automatico
5. Jobs: Cron jobs integrados (PgBoss)

Consideraciones

• Curva de aprendizaje para nuevo framework
• documentación menos extensa que Next.js/Express
• Comunidad más pequeña

Recursos

• documentación oficial
• LLM-optimized docs

---

7. UI Components: ShadCN

Decisión

Usar ShadCN UI (ya incluido en el, template).

Ventajas

1. Copy-paste: código tuyo, no dependencia
2. Customizable: fácil de modificar
3. Tailwind-based: Consistente con el resto del proyecto
4. Accessible: Basado en Radix UI primitives
5. 22+ componentes: Button, Card, Dialog, Table, etc.

Componentes Clave para Cursos

• Card (CourseCard)
• Progress (ProgressRing)
• Dialog (modals)
• Table (admin tables)
• Form (formularios)

---

8. Base de Datos: PostgreSQL

Decision

Mantener PostgreSQL (heredado del template).

Ventajas

1. Robusta: Soporte para relaciones complejas
2. Prisma: ORM excelente con tipos
3. PgBoss: Jobs usando la misma DB
4. Fly.io: fácil de desplegar
5. Escalable: Maneja el crecimiento

Indices Recomendados

model Course {
  @@index([isPublished])
  @@index([category])
}

model Lesson {
  @@index([courseId, order])
}

model Enrollment {
  @@index([userId])
  @@index([courseId])
}

---

Resumen de Decisiones

Área	Decisión	Razón Principal
Video	AWS S3 + CloudFront	Ya configurado, pago por uso
Pricing	Individual + Suscripción	Maxima flexibilidad
Idioma	Hardcode Spanish	Simplicidad
Comunidad	Post-launch	Enfoque en core primero
Certificados	PDF server-side	Control total
Framework	Wasp	Heredado, full-stack
UI	ShadCN	Copy-paste, customizable
Database	PostgreSQL	Robusta, Prisma