Organisations et invitations

Configuration et paramètres

Avant toute étape, lisez Avant de commencer et Principes de base du terminal. Ces instructions supposent que vous avez ouvert le monorepo supastack complet dans VS Code ; sa racine package.json marque la racine du référentiel. Dans les commandes pnpm, un package d'espace de travail est une application ou un dossier de code partagé ; dans le produit, un espace de travail est le conteneur de données et la limite de sécurité d'une équipe. corepack pnpm --filter ... sélectionne un package dans le monorepo tandis que les commandes sont exécutées à partir de sa racine. Si vous avez ouvert uniquement un dossier mobile ou de bureau synchronisé, il ne contient pas le backend Web, la configuration Docker ou les scripts racine : exécutez le backend à partir de ce monorepo ou d'un serveur hébergé accessible et utilisez les propres scripts du dossier de plateforme. Une variable d'environnement est un paramètre nommé stocké dans un fichier .env local ou dans votre tableau de bord d'hébergement ; redémarrez l'application concernée après l'avoir modifiée et conservez les secrets du serveur en dehors des valeurs NEXT_PUBLIC_ et EXPO_PUBLIC_.

1. Démarrez l'application Web à partir de la racine du référentiel avec corepack pnpm --filter @supastack/web dev et créez un compte de test.

2. Ouvrez l'écran de configuration de l'organisation, créez un espace de travail de test, puis invitez un deuxième e-mail de test depuis Paramètres → Membres. Un espace de travail constitue la limite d'une équipe qui possède les membres et les enregistrements.

3. Acceptez l'invitation en étant connecté avec ce même e-mail. Attendu : le deuxième compte peut accéder à l'espace de travail invité avec le rôle qui lui est attribué, mais ne peut pas gérer les actions réservées au propriétaire.

Les espaces de travail d’organisation sont distincts des espaces personnels dans packages/db. Après l’inscription, les étapes de configuration (/onboarding, /new-organization, /select-organization, /choose-plan) conduisent l’utilisateur vers une organisation active avant l’accès à la facturation et aux paramètres du produit.

Les invitations créent une ligne workspace_invitation en attente et envoient un e-mail transactionnel avec une URL d’acceptation /invite/[token]. L’acceptation exige une adresse e-mail de session correspondante. La liste des membres, les changements de rôle et le départ se trouvent sous /settings/members ; le renommage, la suppression et le départ sont également proposés dans /organization/settings.

Routes
  /new-organization
  /select-organization
  /invite/[token]
  /settings/members
  /organization/settings

Server actions
  createOrganizationAction
  createWorkspaceInviteAction
  acceptWorkspaceInviteAction
  updateMemberRoleAction
  leaveOrganizationAction
  renameOrganizationAction
  deleteOrganizationAction

Commandes à copier

Suivez les commentaires pour voir dans quel dossier une commande s'exécute. Si deux terminaux sont étiquetés, ouvrez deux fenêtres de terminal et laissez la première commande s'exécuter pendant que vous utilisez la seconde.

corepack pnpm --filter @supastack/web dev

Processus d’implémentation

Résolvez l’espace de travail actif à partir du cookie, puis de la préférence utilisateur, puis de l’appartenance ; vérifiez ensuite l’appartenance lors de chaque écriture. Les propriétaires et administrateurs gèrent les invitations et les rôles ; l’unique propriétaire ne peut ni partir ni rétrograder son propre rôle.

Avant de modifier les appartenances, privilégiez evaluateLeaveOrganization et evaluateMemberRoleUpdate de @supastack/db. Après une opération réussie, émettez les notifications in-app member.left et member.role_changed si inAppProduct est activé.

L’administration de la plateforme est une frontière distincte déjà fournie : seuls les administrateurs de plateforme peuvent gérer les utilisateurs, les bannissements et l’usurpation d’identité. Un rôle de propriétaire ou d’administrateur d’espace de travail n’accorde aucun accès à la plateforme. Les rôles documentés dans l’organisation sont owner, admin et member.

Vérification et dépannage

Si un lien d'invitation indique que l'e-mail ne correspond pas, connectez-vous en utilisant l'adresse exacte qui l'a reçu. Si l'e-mail d'invitation est manquant, vérifiez le résultat de l'e-mail local avant de le renvoyer. Si un membre ne peut pas voir une organisation, passez au bon espace de travail et vérifiez son adhésion ; ne résolvez jamais ce problème en transmettant un autre workspaceId depuis le navigateur.

Vitest ciblé : helpers de départ et de rôle, acceptation d’invitation et barrières de configuration d’organisation. Parcours manuel : créer une organisation → inviter → accepter sur un second compte → modifier le rôle → partir comme membre non propriétaire → supprimer comme propriétaire avec confirmation par saisie.