Decisiones Tecnicas

Este documento explica las decisiones tecnicas clave del proyecto y sus justificaciones.

1. Video Hosting: AWS S3 + CloudFront

Decision

Usar AWS S3 para almacenamiento y CloudFront para distribucion de videos.

Alternativas Consideradas

Opcion	Pros	Contras
AWS S3 + CloudFront	Pago por uso, escalable, ya configurado	Mas complejo de configurar
YouTube (unlisted)	Gratis, facil	Sin control, ads posibles, no profesional
Vimeo Pro	Player profesional	$20/mes minimo, limites de almacenamiento
Bunny.net	Mas barato	Menos integracion AWS

Justificacion

1. Ya configurado: El proyecto usa S3 para file uploads
2. Pago por uso: ~$0.023/GB almacenamiento + ~$0.085/GB transferencia
3. Escalable: Crece automaticamente con el uso
4. Control total: URLs firmadas para contenido privado
5. Global: CloudFront tiene edge locations en Latinoamerica

Costo Estimado

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

---

2. Pricing Model: Individual + Suscripcion

Decision

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

Alternativas Consideradas

Opcion	Pros	Contras
Solo suscripcion	Ingresos recurrentes	Barrera alta para nuevos usuarios
Solo individual	Baja barrera de entrada	Sin ingresos recurrentes
Ambos	Maxima flexibilidad	Mas 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	Descripcion
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

Decision

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

Alternativas Consideradas

Opcion	Pros	Contras
i18n (react-intl, etc)	Multi-idioma futuro	Complejidad adicional
Hardcode Spanish	Simple, rapido	Solo español
Parametrizable	Flexible	Over-engineering

Justificacion

1. Mercado objetivo: Hispanohablantes en Latinoamerica
2. Simplicidad: Menos codigo, menos bugs
3. Performance: Sin overhead de i18n
4. Evolucion: Se puede agregar i18n despues si es necesario

Implementacion

app/src/shared/content/es.ts

export const content = {
  auth: {
    login: "Iniciar Sesion",
    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

Opcion	Pros	Contras
Incluir en MVP	Feature completa	Retrasa lanzamiento
Post-launch	Lanzamiento rapido	Sin comunidad inicial
Terceros (Discord)	Facil, gratis	Fuera de la plataforma

Justificacion

1. Enfoque: Primero el core (cursos + pagos)
2. Validacion: 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

Decision

Generar certificados como PDFs en el servidor.

Alternativas Consideradas

Opcion	Pros	Contras
PDF server-side	Control total, profesional	Mas codigo
Imagen estatica	Simple	No descargable
Servicio tercero	Menos codigo	Costo adicional, dependencia
LinkedIn certificates	Integracion social	Requiere partnership

Justificacion

1. Control: Diseno personalizado con branding
2. Sin dependencias: No requiere servicios externos
3. Descargable: Los usuarios valoran PDFs
4. Verificable: Se puede agregar URL de verificacion

Implementacion

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
• Documentacion menos extensa que Next.js/Express
• Comunidad mas pequena

Recursos

• Documentacion oficial
• LLM-optimized docs

---

7. UI Components: ShadCN

Decision

Usar ShadCN UI (ya incluido en el template).

Ventajas

1. Copy-paste: Codigo tuyo, no dependencia
2. Customizable: Facil 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: Facil 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

Area	Decision	Razon Principal
Video	AWS S3 + CloudFront	Ya configurado, pago por uso
Pricing	Individual + Suscripcion	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