inicio rápido

está guía te ayudara a tener TalentBricksAI corriendo en tu maquina local en menos de 10 minutos.

Requisitos Previos

Antes de comenzar, asegurate de tener instalado:

Node.js v20 o superior (Descargar)
Docker Desktop (Descargar)
Git (Descargar)

Paso 1: Instalar Wasp

Wasp es el framework que impulsa TalentBricksAI. Instalalo con un sólo comando:

# Linux / macOS / WSL
curl -sSL https://get.wasp-lang.dev/installer.sh | sh

# Verificar instalación
wasp versión

Deberias ver algo como 0.20.0 o superior.

Paso 2: Clonar el Repositorio

# Clonar el proyecto
# Pedir acceso al repositorio en talento
git clone <github-url>
cd TalentBricksAI/app

Paso 3: Configurar Variables de Entorno

Crea los archivos de configuración necesarios:

.env.server en el directorio app/:

# JWT Secret (genera uno seguro para produccion)
JWT_SECRET=my-super-secret-jwt-key-change-this

# Stripe (modo test)
STRIPE_SECRET_KEY=sk_test_tu_clave_aqui

# Email (en desarrollo, los emails se muestran en consola)
# No necesitas configurar nada para desarrollo

# AWS S3 (opcional para desarrollo)
# Los seeds usan videos MP4 públicos de W3C como placeholders

.env.client en el directorio app/:

# Stripe (clave pública de test)
REACT_APP_STRIPE_PUBLISHABLE_KEY=pk_test_tu_clave_publica_aqui

Paso 4: Iniciar la Base de Datos

Abre una nueva terminal y deja este comando corriendo:

cd app
wasp db start

Esto inicia un contenedor Docker con PostgreSQL. Deberias ver:

✅ PostgreSQL is running on port 5432

Paso 5: Aplicar Migraciones de Base de Datos

En otra terminal:

cd app
wasp db migrate-dev

Si es la primera vez, te pedira un nombre para la migración. Escribe algo como init y presiona Enter.

Paso 6: Sembrar Datos de Prueba (Opcional)

Para tener cursos y usuarios de ejemplo:

wasp db seed seedAllDummyData

Esto crea:

4 cursos de muestra (Data Engineering e IA)
50 usuarios de prueba
Un usuario de prueba con certificado: test@talentbricks.ai

Paso 7: Iniciar el Servidor de Desarrollo

En otra terminal:

cd app
wasp start

Wasp compilara tu aplicación. Este proceso puede tomar 1-2 minutos la primera vez.

Cuándo veas:

🐝 --- CLIENT STARTED --- 🐝
📦 Client bundle at http://localhost:3000

🐝 --- SERVER STARTED --- 🐝
🚀 Server is running on http://localhost:3001

¡estás listo! 🎉

Paso 8: Explorar la aplicación

Abre tu navegador en http://localhost:3000

Cosas para Probar:

Registrar una Cuenta
- Haz clic en “Registrarse”
- Crea una cuenta con tu email
- En desarrollo, el link de verificación se muestra en la consola (no se envia email real)
Explorar Cursos
- Ve a “Cursos” en el menu
- Explora los cursos de ejemplo
- Inscribete en uno (si configuraste Stripe, o usa el modo desarrollo)
Panel de Administrador
- Crea una cuenta y luego edita el usuario en la base de datos para hacerlo admin
- O usa wasp db studio para abrir Prisma Studio y editar el campo isAdmin a true

Proximos Pasos

Ahora que tienes TalentBricksAI corriendo localmente:

📚 Lee el Tour Guiado para entender la arquitectura
🎓 Aprende como Crear un Curso
🎥 Descubre como Subir Videos
💳 Configura Pagos con Stripe

Comandos Utiles

Comando	descripción
`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 <seedName>`	Ejecutar seed script específico
`wasp clean`	Limpiar cache de Wasp

solución de Problemas

Puerto 3000 ya en uso

# Encontrar el proceso
lsof -i :3000

# Matar el proceso
kill -9 <PID>

Error: “No such file or directory”

Asegurate de estar en el directorio app/:

cd TalentBricksAI/app

Error de migración de base de datos

Si ves errores con migraciones:

# Resetear la base de datos (ADVERTENCIA: borra todos los datos)
wasp db reset

# Volver a ejecutar las migraciones
wasp db migrate-dev

Cambios no se reflejan

Después de cambios en schema.prisma o main.wasp:

# Detener wasp start (Ctrl+C)
# Ejecutar migraciones si cambiaste schema.prisma
wasp db migrate-dev

# Reiniciar
wasp start

¿Necesitas Ayuda?

📖 Consulta la configuración Local Completa para configuración avanzada
Apoyate con el equipo