> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 组织与邀请

交付演示级组织闭环：创建、切换、邀请、角色、退出与危险区删除。

## 安装与配置

在执行任何步骤之前，请阅读[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md) 和[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)。这些说明假设您在 VS Code 中打开了完整的 supastack monorepo；它的根 package.json 标记存储库根。在 pnpm 命令中，工作区包是应用程序或共享代码文件夹；在产品中，工作空间是团队的数据容器和安全边界。 corepack pnpm --filter ... 从 monorepo 选择一个包，同时从其根运行命令。如果您仅打开同步的移动或桌面文件夹，则它不包含 Web 后端、Docker 设置或根脚本：从此 monorepo 或可访问的托管服务器运行后端，并使用平台文件夹自己的脚本。环境变量是存储在本地 .env 文件或托管仪表板中的命名设置；更改后重新启动相关应用程序，并将服务器机密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1. 使用 corepack pnpm --filter @supastack/web dev 从存储库根启动 Web 应用程序并创建一个测试帐户。

2. 打开组织设置屏幕，创建一个测试工作区，然后从“设置”→“成员”邀请第二封测试电子邮件。工作区是拥有成员和记录的团队边界。

3. 使用同一电子邮件登录时接受邀请。预期：第二个帐户可以以其分配的角色进入受邀工作区，但无法管理仅限所有者的操作。

packages/db 中，组织工作区与个人工作区是区分开的。注册后，入门门槛（/onboarding、/new-organization、/select-organization、/choose-plan）会先把用户带入一个激活的组织，再进入产品计费与设置。

邀请会创建一条待处理的 workspace_invitation 记录，并发送带 /invite/[token] 接受链接的事务性邮件。接受要求登录邮箱匹配。成员列表、角色变更与退出在 /settings/members；重命名/删除与退出也出现在 /organization/settings。

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

Server actions
  createOrganizationAction
  createWorkspaceInviteAction
  acceptWorkspaceInviteAction
  updateMemberRoleAction
  leaveOrganizationAction
  renameOrganizationAction
  deleteOrganizationAction
```


## 要复制的命令

按照注释查看命令在哪个文件夹中运行。如果标记了两个终端，请打开两个终端窗口，并在使用第二个命令时保持第一个命令运行。

```
corepack pnpm --filter @supastack/web dev
```


## 实现流程

按 cookie → 用户偏好 → 成员关系解析当前工作区，然后每次写入都校验成员资格。所有者与管理员管理邀请/角色；唯一所有者不能退出或降级自己。

变更成员关系前，优先使用 @supastack/db 的 evaluateLeaveOrganization 与 evaluateMemberRoleUpdate。inAppProduct 开启时，成功变更后发出 member.left / member.role_changed 应用内通知。

平台管理是一个单独的边界：只有平台管理员可以管理用户、禁令和模拟。工作区所有者/管理员角色不授予平台访问权限。记录的组织角色是所有者、管理员和成员。


## 验证与排障

如果邀请链接显示电子邮件不匹配，请使用收到电子邮件的确切地址登录。如果邀请邮件丢失，请检查本地邮件结果后再重新发送。如果成员看不到组织，请切换到正确的工作区并验证成员身份；切勿通过从浏览器传递另一个 workspaceId 来解决此问题。

聚焦 Vitest：工作区退出/角色助手、邀请接受、组织入门门槛。手动：创建组织 → 邀请 → 第二账户接受 → 改角色 → 非所有者退出 → 所有者带输入确认删除。


## 下一篇

[入门引导流程](https://supastack.dev/zh/docs/web/onboarding.md)