For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/web/organizations.md (or send Accept: text/markdown).
Organizaciones e invitaciones
Implementa el ciclo de organización de la demo: crear, cambiar, invitar, asignar roles, salir y eliminar desde la zona de peligro.
Configuración y ajustes
Antes de cualquier paso, lea Antes de comenzar y Conceptos básicos del terminal. Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.
1. Inicie la aplicación web desde la raíz del repositorio con corepack pnpm --filter @supastack/web dev y cree una cuenta de prueba.
2. Abra la pantalla de configuración de la organización, cree un espacio de trabajo de prueba y luego invite a un segundo correo electrónico de prueba desde Configuración → Miembros. Un espacio de trabajo es el límite del equipo al que pertenecen los miembros y los registros.
3. Acepte la invitación iniciando sesión con ese mismo correo electrónico. Se esperaba: la segunda cuenta puede ingresar al espacio de trabajo invitado con su función asignada, pero no puede administrar acciones exclusivas del propietario.
Los espacios de trabajo de organización son distintos de los espacios personales en packages/db. Después del registro, las barreras de incorporación (/onboarding, /new-organization, /select-organization, /choose-plan) llevan al usuario a una organización activa antes de la facturación y configuración del producto.
Las invitaciones crean una fila workspace_invitation pendiente y envían un correo transaccional con una URL de aceptación /invite/[token]. Para aceptar, se necesita una sesión iniciada con un correo coincidente. La lista de miembros, los cambios de rol y la salida están en /settings/members; el cambio de nombre/eliminación y la salida también aparecen en /organization/settings.
Routes
/new-organization
/select-organization
/invite/[token]
/settings/members
/organization/settings
Server actions
createOrganizationAction
createWorkspaceInviteAction
acceptWorkspaceInviteAction
updateMemberRoleAction
leaveOrganizationAction
renameOrganizationAction
deleteOrganizationActionComandos para copiar
Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.
corepack pnpm --filter @supastack/web devFlujo de implementación
Resuelve el espacio de trabajo activo en este orden: cookie → preferencia del usuario → membresía; luego verifica la membresía en cada escritura. Los owners y admins gestionan invitaciones y roles; los únicos propietarios no pueden salir ni degradarse de rol.
Antes de modificar membresías, utiliza evaluateLeaveOrganization y evaluateMemberRoleUpdate de @supastack/db. Tras una mutación correcta, emite notificaciones dentro de la aplicación member.left / member.role_changed cuando inAppProduct esté habilitado.
La administración de la plataforma tiene un límite independiente ya implementado: solo los administradores de plataforma pueden gestionar usuarios, bloqueos y suplantación. Un rol owner/admin del espacio de trabajo no concede acceso a la plataforma. Los roles de organización documentados son owner, admin y member.
Verificación y solución de problemas
Si un enlace de invitación dice que el correo electrónico no coincide, inicie sesión con la dirección exacta que lo recibió. Si falta el correo electrónico de invitación, verifique el resultado del correo electrónico local antes de volver a enviarlo. Si un miembro no puede ver una organización, cambie al espacio de trabajo correcto y verifique la membresía; Nunca arregles esto pasando otro workspaceId desde el navegador.
Vitest enfocado: helpers de salida/cambio de rol del espacio de trabajo, aceptación de invitaciones y barreras de incorporación a la organización. Manual: crear organización → invitar → aceptar desde una segunda cuenta → actualizar rol → salir como alguien que no es propietario → eliminar como propietario con confirmación escrita.