Guía Rápida - Sistema B2B

Tiempo de lectura: 10 minutos

Esta guía te permite empezar a usar y probar el sistema B2B en menos de 10 minutos. Para una guía exhaustiva, consulta la Guía de Pruebas Completa.

Resumen Ejecutivo

El sistema B2B permite a empresas comprar suscripciones de equipo y gestionar el acceso de sus empleados a los cursos de TalentBricksAI.

Jerarquía de Roles

Platform Admin (isAdmin = true en User)
  └─ Acceso completo a todas las organizaciones

Organization OWNER
  └─ Control total: facturación, miembros, cursos

Organization ADMIN
  └─ Gestión de equipo: invitar, remover, asignar cursos

Organization MEMBER
  └─ Acceso usuario final: solo ver cursos asignados

Setup Rápido (5 minutos)

1. Crear Datos de Prueba

cd app

# Opción A: Seed completo (incluye todo)
wasp db seed seedAllDummyData

# Opción B: Solo organizaciones (si ya tienes cursos)
wasp db seed seedOrganizationTestData

¿Qué crea el seed?

• 3 organizaciones de prueba (TalentBricks Corp, Acme Inc, StartupXYZ)
• 7 usuarios con diferentes roles
• Cursos pre-asignados a las organizaciones
• 2 invitaciones pendientes para pruebas

2. Iniciar la Aplicación

# Terminal 1: Base de datos
wasp db start

# Terminal 2: Aplicación
wasp start

3. Iniciar Sesión

Abre http://localhost:3000 y usa estas credenciales:

Credenciales Completas

Todos los usuarios de organizaciones tienen password: Test123!

Platform Admin

Email	Password	Dashboard
admin@talentbricks.ai	Admin123!	/admin/organizations

Usuarios de Organizaciones (Password: Test123!)

Email	Rol	Organización	Seats
owner@talentbricks.test	OWNER	TalentBricks Corp	10
admin@talentbricks.test	ADMIN	TalentBricks Corp	10
member1@talentbricks.test	MEMBER	TalentBricks Corp	10
member2@talentbricks.test	MEMBER	TalentBricks Corp	10
owner@acme.test	OWNER	Acme Inc	25
admin@acme.test	ADMIN	Acme Inc	25
owner@startup.test	OWNER	StartupXYZ	5

Para obtener el organizationId de cada organización:

psql $DATABASE_URL -c "SELECT id, name, \"maxSeats\" FROM \"Organization\";"

Flujos de Prueba Esenciales

Flujo 1: Como Platform Admin

1. Login como admin@talentbricks.ai
2. Ir a /admin/organizations
3. Ver lista de todas las organizaciones
4. Hacer clic en “TalentBricks Corp”
5. Ver detalles: miembros, cursos, analíticas
6. Editar: cambiar nombre o maxSeats

Verificar en BD:

psql $DATABASE_URL -c "SELECT id, name, \"maxSeats\", \"usedSeats\", \"subscriptionStatus\" FROM \"Organization\";"

Flujo 2: Como OWNER - Invitar Miembro

1. Login como owner@talentbricks.test
2. Obtener organizationId:

psql $DATABASE_URL -c "SELECT id, name FROM \"Organization\" WHERE name = 'TalentBricks Corp';"

3. Ir a /team/{organizationId}/members
4. Click en “Invitar Miembro”
5. Email: newuser@test.com, Rol: MEMBER
6. Click “Enviar Invitación”

Obtener token de invitación:

psql $DATABASE_URL -c "SELECT token, email, role, \"expiresAt\" FROM \"OrganizationInvitation\" WHERE email = 'newuser@test.com';"

Flujo 3: Aceptar Invitación

1. Crear cuenta en /signup con newuser@test.com
2. Login
3. Ir a /invitation/{token} (usa el token del paso anterior)
4. Click “Aceptar Invitación”
5. Verificar que ahora eres miembro

Verificar:

psql $DATABASE_URL -c "SELECT u.email, om.role, om.\"joinedAt\" FROM \"OrganizationMember\" om JOIN \"User\" u ON om.\"userId\" = u.id WHERE u.email = 'newuser@test.com';"

Flujo 4: Como ADMIN - Asignar Curso

1. Login como admin@talentbricks.test
2. Ir a /team/{organizationId}/courses
3. Click “Asignar Curso”
4. Seleccionar un curso
5. Click “Asignar”

Verificar:

psql $DATABASE_URL -c "SELECT c.title, u.email as \"assignedBy\", oe.\"assignedAt\" FROM \"OrganizationEnrollment\" oe JOIN \"Course\" c ON oe.\"courseId\" = c.id JOIN \"User\" u ON oe.\"assignedById\" = u.id WHERE oe.\"organizationId\" = '{organizationId}';"

Flujo 5: Como MEMBER - Acceder a Curso

1. Login como member1@talentbricks.test
2. Ir a /courses
3. Buscar un curso asignado a tu organización
4. Verificar que muestra “Acceso con Equipo”
5. Click “Ir al Curso”
6. Ir a /courses/{slug}/learn
7. Reproducir una lección
8. Verificar que el progreso se guarda

Flujo 6: Límite de Asientos

Setup:

# Establecer maxSeats = 3 para prueba
psql $DATABASE_URL -c "UPDATE \"Organization\" SET \"maxSeats\" = 3 WHERE name = 'TalentBricks Corp';"

# Ver seats actuales
psql $DATABASE_URL -c "SELECT \"usedSeats\", \"maxSeats\", \"maxSeats\" - \"usedSeats\" as available FROM \"Organization\" WHERE name = 'TalentBricks Corp';"

1. Login como OWNER
2. Intentar invitar un miembro cuando usedSeats >= maxSeats
3. Verificar que se muestre error: “No hay asientos disponibles”
4. Remover un miembro
5. Verificar que ahora sí puedas invitar

Estructura de Permisos

Matriz de Permisos Detallada

Acción	Platform Admin	OWNER	ADMIN	MEMBER
Gestión de Miembros
Ver lista de miembros	✅	✅	✅	❌
Invitar miembros	✅	✅	✅	❌
Remover miembros	✅	✅	✅	❌
Cambiar roles	✅	✅	❌	❌
Gestión de Cursos
Ver cursos asignados	✅	✅	✅	✅
Asignar cursos	✅	✅	✅	❌
Desasignar cursos	✅	✅	✅	❌
Acceder a cursos	✅	✅	✅	✅
Facturación
Ver facturación	✅	✅	❌	❌
Gestionar suscripción	✅	✅	❌	❌
Ver portal de Stripe	✅	✅	❌	❌
Administración
Ver analíticas	✅	✅	✅	❌
Editar organización	✅	✅	❌	❌
Eliminar organización	✅	✅	❌	❌

Comandos SQL Útiles

Ver Estado de una Organización

psql $DATABASE_URL -c "
SELECT
  o.name,
  o.\"maxSeats\",
  o.\"usedSeats\",
  o.\"subscriptionStatus\",
  o.\"subscriptionPlan\",
  o.\"datePaid\",
  COUNT(DISTINCT om.id) as member_count,
  COUNT(DISTINCT oe.id) as course_count
FROM \"Organization\" o
LEFT JOIN \"OrganizationMember\" om ON o.id = om.\"organizationId\"
LEFT JOIN \"OrganizationEnrollment\" oe ON o.id = oe.\"organizationId\"
WHERE o.name = 'TalentBricks Corp'
GROUP BY o.id;
"

Ver Miembros con Roles

psql $DATABASE_URL -c "
SELECT
  u.email,
  u.username,
  om.role,
  om.\"joinedAt\",
  o.name as organization
FROM \"OrganizationMember\" om
JOIN \"User\" u ON om.\"userId\" = u.id
JOIN \"Organization\" o ON om.\"organizationId\" = o.id
WHERE o.name = 'TalentBricks Corp'
ORDER BY om.role, om.\"joinedAt\";
"

Ver Cursos Asignados

psql $DATABASE_URL -c "
SELECT
  c.title,
  c.slug,
  u.email as assigned_by,
  oe.\"assignedAt\"
FROM \"OrganizationEnrollment\" oe
JOIN \"Course\" c ON oe.\"courseId\" = c.id
JOIN \"User\" u ON oe.\"assignedById\" = u.id
JOIN \"Organization\" o ON oe.\"organizationId\" = o.id
WHERE o.name = 'TalentBricks Corp';
"

Ver Invitaciones Pendientes

psql $DATABASE_URL -c "
SELECT
  oi.email,
  oi.role,
  oi.token,
  u.email as invited_by,
  oi.\"invitedAt\",
  oi.\"expiresAt\",
  oi.\"acceptedAt\"
FROM \"OrganizationInvitation\" oi
JOIN \"User\" u ON oi.\"invitedBy\" = u.id
JOIN \"Organization\" o ON oi.\"organizationId\" = o.id
WHERE o.name = 'TalentBricks Corp'
ORDER BY oi.\"invitedAt\" DESC;
"

Recalcular usedSeats (Fix)

# Si usedSeats está desincronizado
psql $DATABASE_URL -c "
UPDATE \"Organization\" o
SET \"usedSeats\" = (
  SELECT COUNT(*)
  FROM \"OrganizationMember\" om
  WHERE om.\"organizationId\" = o.id
);
"

Troubleshooting

Problema: “403 Forbidden” al acceder a /team/{organizationId}

Causa: Usuario no es miembro de la organización.

Verificar:

psql $DATABASE_URL -c "SELECT * FROM \"OrganizationMember\" WHERE \"userId\" = '{user_id}' AND \"organizationId\" = '{org_id}';"

Solución: Invitar al usuario o verificar que aceptó la invitación.

Problema: No se puede invitar más miembros

Causa: usedSeats >= maxSeats

Verificar:

psql $DATABASE_URL -c "SELECT \"usedSeats\", \"maxSeats\" FROM \"Organization\" WHERE id = '{org_id}';"

Solución temporal (solo dev):

psql $DATABASE_URL -c "UPDATE \"Organization\" SET \"maxSeats\" = 20 WHERE id = '{org_id}';"

Problema: Miembro no puede acceder a curso asignado

Causa: subscriptionStatus != 'active' o curso no asignado.

Verificar subscription:

psql $DATABASE_URL -c "SELECT \"subscriptionStatus\" FROM \"Organization\" WHERE id = '{org_id}';"

Verificar enrollment:

psql $DATABASE_URL -c "SELECT * FROM \"OrganizationEnrollment\" WHERE \"organizationId\" = '{org_id}' AND \"courseId\" = {course_id};"

Problema: usedSeats incorrecto

Solución:

psql $DATABASE_URL -c "
UPDATE \"Organization\"
SET \"usedSeats\" = (
  SELECT COUNT(*)
  FROM \"OrganizationMember\"
  WHERE \"organizationId\" = \"Organization\".id
);
"

Próximos Pasos

1. ✅ Prueba los flujos básicos con los usuarios de prueba
2. ✅ Verifica los permisos con cada rol
3. 📖 Lee la guía completa en Guía de Pruebas para casos edge
4. 🏗️ Revisa la arquitectura en Arquitectura
5. 🚀 Integra con Stripe para pruebas de checkout (usa test keys)
6. 📧 Configura emails para invitaciones (opcional en dev)