Guía de Pruebas - Sistema B2B

Guía Completa

Esta guía contiene 11 flujos de prueba detallados para validar todo el sistema B2B. Para empezar rápido, usa la Guía Rápida.

Credenciales de Acceso Rápido

Platform Admin: admin@talentbricks.ai / Admin123! Org Users: Todos usan password Test123! Ver tabla completa de credenciales abajo.

Resumen del Sistema

El sistema de organizaciones permite a empresas comprar suscripciones de equipo con múltiples asientos (seats) y gestionar el acceso de sus miembros a los cursos de TalentBricksAI.

Roles y Permisos

Rol	Descripción	Permisos
Platform Admin	Administrador de la plataforma	• Ver todas las organizaciones • Gestionar cualquier organización • Acceso completo al admin dashboard
OWNER	Dueño de la organización	• Gestionar suscripción y facturación • Invitar/remover miembros • Asignar cursos • Cambiar roles de miembros • Eliminar organización • Ver analíticas
ADMIN	Administrador de equipo	• Invitar/remover miembros • Asignar cursos • Ver analíticas • NO puede gestionar facturación ni eliminar la organización
MEMBER	Miembro del equipo	• Acceder a cursos asignados a la organización • Ver progreso personal • NO puede invitar usuarios ni gestionar el equipo

Preparación del Entorno de Prueba

Crear Datos de Prueba

cd app
wasp db seed seedOrganizationTestData

🔑 Credenciales de Prueba

Credenciales Completas

Guarda estas credenciales - las necesitarás para todos los flujos de prueba.

Platform Admin

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

Usuarios de Organizaciones (Password: Test123!)

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

Datos Creados por el Seed

• 3 organizaciones de prueba:

  • TalentBricks Corp (10 seats)
  • Acme Inc (25 seats)
  • StartupXYZ (5 seats)

• 7 usuarios de prueba (ver tabla arriba)

• Cursos asignados:

  • TalentBricks Corp tiene acceso a los primeros 2 cursos
  • Acme Inc tiene acceso al primer curso

Flujos de Prueba

Flujo 1: Compra de Plan de Equipo (E2E)

Objetivo: Verificar el flujo completo de compra de una suscripción de equipo.

Pasos:

1. Inicia sesión con un usuario regular
2. Navega a /teams/purchase
3. Selecciona un plan de equipo (ej: 10 seats)
4. Completa el formulario (nombre de org, email de facturación)
5. Haz clic en “Continuar al checkout”
6. Completa el checkout de Stripe (tarjeta de prueba: 4242 4242 4242 4242)
7. Verifica redirección a /team/{organizationId}

Verificaciones:

# Verificar nueva organización
psql $DATABASE_URL -c "SELECT id, name, maxSeats, subscriptionStatus FROM \"Organization\" ORDER BY \"createdAt\" DESC LIMIT 1;"

# Verificar membresía
psql $DATABASE_URL -c "SELECT om.role, u.email FROM \"OrganizationMember\" om JOIN \"User\" u ON om.\"userId\" = u.id WHERE om.\"organizationId\" = '{organization_id}';"

Resultados esperados:

• ✅ Nueva organización creada
• ✅ subscriptionStatus = 'active'
• ✅ maxSeats coincide con plan
• ✅ Usuario es OWNER
• ✅ usedSeats = 1

---

Flujo 2: Invitar Miembros al Equipo

Objetivo: Verificar que OWNER y ADMIN pueden invitar miembros.

Como OWNER:

1. Inicia sesión como owner@talentbricks.test
2. Navega a /team/{organizationId}/members
3. Haz clic en “Invitar Miembro”
4. Ingresa email: newmember@test.com, Rol: MEMBER
5. Envía la invitación
6. Verifica que aparezca en “Invitaciones Pendientes”

Como MEMBER:

1. Inicia sesión como member1@talentbricks.test
2. Verifica que NO aparezca el botón “Invitar Miembro”

Verificaciones:

psql $DATABASE_URL -c "SELECT email, role, \"invitedBy\", \"expiresAt\" FROM \"OrganizationInvitation\" WHERE \"organizationId\" = '{organization_id}';"

Resultados esperados:

• ✅ OWNER puede invitar miembros
• ✅ ADMIN puede invitar miembros
• ✅ MEMBER NO puede invitar miembros
• ✅ Token único generado
• ✅ Expiración = 7 días

---

Flujo 3: Aceptar Invitación

Objetivo: Verificar que usuarios invitados puedan unirse.

Pasos:

1. Obtén el token de invitación:

psql $DATABASE_URL -c "SELECT token FROM \"OrganizationInvitation\" WHERE email = 'newmember@test.com' LIMIT 1;"

2. Si el usuario no existe, créalo en /signup
3. Navega a /invitation/{token}
4. Acepta la invitación
5. Verifica redirección a /team/{organizationId}

Verificaciones:

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

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

Resultados esperados:

• ✅ Usuario es miembro
• ✅ usedSeats incrementado
• ✅ acceptedAt establecido
• ✅ Rol correcto

---

Flujo 4: Asignar Cursos a la Organización

Objetivo: Verificar que admins pueden asignar cursos.

Como OWNER:

1. Inicia sesión como owner@talentbricks.test
2. Navega a /team/{organizationId}/courses
3. Asigna un curso

Como MEMBER:

1. Verifica que NO aparezca el botón “Asignar Curso”
2. Solo ve los cursos ya asignados

Verificaciones:

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

Resultados esperados:

• ✅ OWNER y ADMIN pueden asignar
• ✅ MEMBER NO puede asignar
• ✅ assignedById registra quién asignó

---

Flujo 5: Acceso a Cursos por Miembros

Objetivo: Verificar que miembros pueden acceder a cursos asignados.

Pasos:

1. Asigna un curso a la organización
2. Inicia sesión como member1@talentbricks.test
3. Navega a /courses/{slug}/learn
4. Reproduce una lección
5. Verifica que el progreso se guarde

Como usuario sin membresía:

1. Inicia sesión con un usuario NO miembro
2. Intenta acceder al curso
3. Verifica denegación de acceso (403)

Resultados esperados:

• ✅ Miembros pueden acceder
• ✅ No-miembros NO pueden
• ✅ Progreso se guarda
• ✅ Videos se cargan

---

Flujo 6: Gestión de Roles

Objetivo: Verificar que solo OWNER puede cambiar roles.

Como OWNER:

1. Promover MEMBER a ADMIN
2. Degradar ADMIN a MEMBER
3. Verificar cambios en BD

Como ADMIN:

1. Verificar que NO aparezca “Cambiar Rol”

Verificaciones:

psql $DATABASE_URL -c "SELECT u.email, om.role FROM \"OrganizationMember\" om JOIN \"User\" u ON om.\"userId\" = u.id WHERE om.\"organizationId\" = '{organization_id}' ORDER BY om.role;"

Resultados esperados:

• ✅ Solo OWNER puede cambiar roles
• ✅ Cambios se reflejan en BD y UI

---

Flujo 7: Remover Miembros

Objetivo: Verificar que OWNER y ADMIN pueden remover.

Pasos:

1. Como OWNER, remueve un miembro
2. Verifica que usedSeats decrementa
3. Inicia sesión como usuario removido
4. Verifica pérdida de acceso a /team/{organizationId} (403)
5. Verifica pérdida de acceso a cursos

Verificaciones:

# Verificar usuario removido
psql $DATABASE_URL -c "SELECT * FROM \"OrganizationMember\" WHERE \"organizationId\" = '{organization_id}' AND \"userId\" = '{removed_user_id}';"

# Verificar usedSeats
psql $DATABASE_URL -c "SELECT \"usedSeats\" FROM \"Organization\" WHERE id = '{organization_id}';"

Resultados esperados:

• ✅ OWNER y ADMIN pueden remover
• ✅ usedSeats decrementa
• ✅ Usuario pierde acceso
• ✅ Registro eliminado

---

Flujo 8: Admin Dashboard

Objetivo: Verificar que platform admins pueden gestionar organizaciones.

Pasos:

1. Inicia sesión como admin@talentbricks.ai
2. Navega a /admin/organizations
3. Usa filtros (nombre, subscription status)
4. Haz clic en una organización
5. Edita: cambia nombre o maxSeats
6. Verifica actualización en BD

Resultados esperados:

• ✅ Admin ve todas las organizaciones
• ✅ Filtros funcionan
• ✅ Admin puede editar
• ✅ Analíticas correctas

---

Flujo 9: Límite de Asientos

Objetivo: Verificar que no se pueden exceder los seats.

Setup:

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

Pasos:

1. Con 2 miembros actuales (owner + 1)
2. Invita a 1 usuario → Debe funcionar (3/3)
3. Intenta invitar otro → Debe fallar
4. Verifica error: “No hay asientos disponibles”

Resultados esperados:

• ✅ Invitación falla cuando usedSeats >= maxSeats
• ✅ Mensaje de error claro
• ✅ UI muestra contador de seats

---

Flujo 10: Facturación y Gestión

Objetivo: Verificar que OWNER puede gestionar facturación.

Pasos:

1. Como OWNER, navega a /team/{organizationId}/billing
2. Verifica información mostrada (plan, seats, próxima facturación)
3. Haz clic en “Gestionar en Stripe”
4. Verifica apertura del portal

Como ADMIN:

1. Intenta acceder a /team/{organizationId}/billing
2. Verifica denegación (403) u ocultamiento

Resultados esperados:

• ✅ Solo OWNER puede acceder
• ✅ Información correcta
• ✅ Portal de Stripe funciona

---

Flujo 11: Expiración de Suscripción

Objetivo: Verificar que el acceso se revoca al expirar.

Setup:

psql $DATABASE_URL -c "UPDATE \"Organization\" SET \"subscriptionStatus\" = 'past_due' WHERE name = 'TalentBricks Corp';"

Pasos:

1. Como MEMBER, intenta acceder a curso
2. Verifica denegación
3. Verifica mensaje: “Problemas de pago”

Como OWNER:

1. Verifica banner de advertencia
2. Haz clic en “Actualizar método de pago”

Restaurar:

psql $DATABASE_URL -c "UPDATE \"Organization\" SET \"subscriptionStatus\" = 'active' WHERE name = 'TalentBricks Corp';"

Resultados esperados:

• ✅ Acceso se revoca cuando != 'active'
• ✅ Banner para OWNER
• ✅ Acceso se restaura al reactivar

---

Casos Edge

1. Invitación Expirada

psql $DATABASE_URL -c "UPDATE \"OrganizationInvitation\" SET \"expiresAt\" = NOW() - INTERVAL '1 day' WHERE email = 'test@example.com';"

• Verifica mensaje “Invitación expirada”
• OWNER puede reenviar

2. Usuario Ya Miembro

• Invita a usuario existente
• Verifica error

3. Email Ya Invitado

• Envía dos invitaciones al mismo email
• Verifica comportamiento

4. Remover Único OWNER

• Intenta remover o cambiar rol del único OWNER
• Verifica error: “Debe haber al menos un OWNER”

5. Stripe Webhooks

Cambio de Seats:

• Modifica quantity en Stripe
• Verifica actualización de maxSeats

Cancelación:

• Cancela suscripción
• Verifica subscriptionStatus = 'cancel_at_period_end'
• Acceso persiste hasta fecha de fin

Pago Fallido:

• Fuerza pago fallido
• Verifica subscriptionStatus = 'past_due'
• Email al OWNER

---

Comandos de Debugging

Ver Estructura Completa

psql $DATABASE_URL -c "
SELECT
  o.id, o.name, o.\"maxSeats\", o.\"usedSeats\", o.\"subscriptionStatus\",
  json_agg(json_build_object('email', u.email, 'role', om.role)) as members
FROM \"Organization\" o
LEFT JOIN \"OrganizationMember\" om ON o.id = om.\"organizationId\"
LEFT JOIN \"User\" u ON om.\"userId\" = u.id
WHERE o.name = 'TalentBricks Corp'
GROUP BY o.id;
"

Ver Todos los Cursos Asignados

psql $DATABASE_URL -c "
SELECT
  o.name as organization,
  c.title as course,
  u.email as assigned_by
FROM \"OrganizationEnrollment\" oe
JOIN \"Organization\" o ON oe.\"organizationId\" = o.id
JOIN \"Course\" c ON oe.\"courseId\" = c.id
JOIN \"User\" u ON oe.\"assignedById\" = u.id
ORDER BY oe.\"assignedAt\" DESC;
"

Limpiar Datos de Prueba

psql $DATABASE_URL -c "DELETE FROM \"OrganizationInvitation\" WHERE \"organizationId\" IN (SELECT id FROM \"Organization\" WHERE name LIKE '%Test%');"
psql $DATABASE_URL -c "DELETE FROM \"OrganizationEnrollment\" WHERE \"organizationId\" IN (SELECT id FROM \"Organization\" WHERE name LIKE '%Test%');"
psql $DATABASE_URL -c "DELETE FROM \"OrganizationMember\" WHERE \"organizationId\" IN (SELECT id FROM \"Organization\" WHERE name LIKE '%Test%');"
psql $DATABASE_URL -c "DELETE FROM \"Organization\" WHERE name LIKE '%Test%';"

---

Checklist de Funcionalidad

Autenticación y Permisos

• Platform admin puede ver todas las organizaciones
• OWNER tiene acceso completo
• ADMIN puede gestionar miembros y cursos
• MEMBER solo ve cursos asignados

Gestión de Miembros

• OWNER puede invitar
• ADMIN puede invitar
• MEMBER no puede invitar
• Tokens únicos generados
• Invitaciones expiran (7 días)
• usedSeats incrementa/decrementa
• No se puede exceder maxSeats

Gestión de Cursos

• OWNER y ADMIN pueden asignar
• Miembros acceden a cursos asignados
• No-miembros no pueden acceder
• Progreso se guarda correctamente

Facturación

• Solo OWNER ve facturación
• Portal de Stripe funciona
• Webhooks actualizan subscriptionStatus
• Webhooks actualizan maxSeats
• Acceso se revoca al expirar

Admin Dashboard

• Lista de organizaciones
• Filtros funcionan
• Edición funciona
• Analíticas correctas

---

Problemas Conocidos

Ver la Guía Rápida - Troubleshooting para soluciones comunes.