Configuracion Local

Esta guia te ayudara a configurar el entorno de desarrollo local para TalentBricksAI.

Requisitos Previos

• Node.js v20+ (recomendado: usar nvm)
• npm v10+
• Docker (para PostgreSQL local)
• Wasp CLI v0.20+

Instalacion de Wasp

# Instalar Wasp CLI
curl -sSL https://get.wasp-lang.dev/installer.sh | sh

# Verificar instalacion
wasp version

Clonar el Repositorio

git clone <repo-url>
cd TalentBricksAI

Configurar la Aplicacion

1. Instalar Dependencias

cd app
npm install

2. Configurar Variables de Entorno

Crear archivos de variables de entorno en el directorio app/:

.env.server

# Base de datos (Wasp la configura automaticamente en dev)
# DATABASE_URL=postgresql://...

# JWT Secret (generar uno unico)
JWT_SECRET=tu-jwt-secret-muy-seguro

# Stripe
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# AWS S3 (para videos)
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_S3_BUCKET=...
AWS_S3_REGION=us-east-1

# Email (SendGrid para produccion)
SENDGRID_API_KEY=...

# OpenAI (opcional, para features de AI)
OPENAI_API_KEY=sk-...

.env.client

REACT_APP_STRIPE_PUBLISHABLE_KEY=pk_test_...

3. Iniciar la Base de Datos

En una terminal separada (dejar corriendo):

cd app
wasp db start

Esto inicia un contenedor Docker con PostgreSQL.

4. Ejecutar Migraciones

wasp db migrate-dev

Si es la primera vez, te pedira un nombre para la migracion (ej: “init”).

5. (Opcional) Seed de Datos

wasp db seed

Esto ejecuta el script de seed definido en main.wasp.

6. Iniciar el Servidor de Desarrollo

En otra terminal:

cd app
wasp start

La aplicacion estara disponible en:

• Frontend: http://localhost:3000
• Backend: http://localhost:3001

Configuracion de Stripe (Desarrollo)

1. Instalar Stripe CLI

# macOS
brew install stripe/stripe-cli/stripe

# Verificar
stripe --version

2. Login en Stripe

stripe login

3. Escuchar Webhooks Locales

En una terminal separada:

stripe listen --forward-to localhost:3001/stripe-webhook

Esto te dara un webhook secret que debes poner en .env.server:

STRIPE_WEBHOOK_SECRET=whsec_...

Configuracion de AWS S3 (Videos)

1. Crear Bucket S3

aws s3 mb s3://talentbricksai-videos --region us-east-1

2. Configurar CORS en el Bucket

Ir a S3 > Bucket > Permissions > CORS configuration:

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST"],
    "AllowedOrigins": ["http://localhost:3000"],
    "ExposeHeaders": []
  }
]

3. (Opcional) Configurar CloudFront

Para produccion, configurar una distribucion CloudFront apuntando al bucket S3.

Comandos Utiles

Comando	Descripcion
wasp start	Iniciar servidor de desarrollo
wasp db start	Iniciar PostgreSQL
wasp db migrate-dev	Crear/aplicar migraciones
wasp db studio	Abrir Prisma Studio (GUI de BD)
wasp db seed	Ejecutar seed script
wasp clean	Limpiar cache de Wasp
wasp build	Build para produccion

Verificar Instalacion

1. Abrir http://localhost:3000
2. Crear una cuenta de prueba
3. Verificar que el email de verificacion aparece en la consola (dev mode)
4. Navegar por la aplicacion

Troubleshooting

Error: “wasp db start” falla

• Verificar que Docker este corriendo
• Intentar docker system prune para limpiar contenedores viejos

Error: “Cannot find module…”

cd app
rm -rf node_modules .wasp
npm install
wasp start

Cambios en schema.prisma no se reflejan

wasp db migrate-dev
# Reiniciar wasp start

Puerto 3000 en uso

# Encontrar el proceso
lsof -i :3000

# Matar el proceso
kill -9 <PID>

Siguiente Paso

Una vez configurado el entorno, puedes:

• Crear un Curso
• Subir Videos