团队管理完整指南

1. 进入创建入口：点击页面左上角你的头像或团队名称，在下拉菜单中选择「切换团队」，然后点击「+ 创建新团队」。
2. 填写团队名称（必填）：
   • 最多 50 个字符，支持中英文、数字和连字符
   • 团队名称会显示在所有数据记录和导出报告的头部
   • 创建后可在设置中修改
3. 填写团队描述（可选）：简要说明团队的研究方向或机构归属，最多 200 字符。该描述显示在团队详情页，帮助成员了解上下文。
4. 选择主要研究领域（可选）：从预设类别中选择（生物医药、化学、材料科学、临床研究等），用于模板推荐。
5. 设置团队可见性：
   • 私有（默认）：仅受邀请的用户可加入，团队不出现在公开搜索结果中
   • 公开：团队可被其他 PonyLab 用户搜索到并申请加入（需 SUPER_ADMIN 审批）
6. 选择订阅计划：初始选择 免费版 即可，随时可在设置中升级为专业版。关于计划对比，请参阅本页订阅与计费章节。
7. 点击「创建团队」：系统在 2 秒内创建团队，并自动将你设为 SUPER_ADMIN，跳转到团队主页。

如果你属于多个团队，可以随时切换当前工作的团队：

1. 点击顶部导航栏左侧的团队名称，展开团队选择器。
2. 下拉菜单列出你所有的团队，当前激活团队有蓝色勾标记。
3. 点击目标团队名称，页面立即刷新，所有数据视图切换为该团队的数据。
4. URL 中的团队上下文同步更新，可将特定团队的页面链接分享给同事。

图例：✅ 完全权限   👁 只读 / 查看   ❌ 无权限

1. 进入 设置 → 团队成员，点击右上角「邀请成员」按钮。
2. 邮箱地址（必填）：在输入框中输入受邀者的邮箱地址。支持批量输入，每行一个邮箱地址，或用逗号分隔，一次最多 20 个地址。
3. 分配角色（必填）：从下拉菜单选择 SUPER_ADMIN、PI、RESEARCHER 或 TECHNICIAN。批量邀请时所有被邀请者使用同一角色，若需不同角色请分批邀请。
4. 欢迎消息（可选）：添加个人化欢迎文字，最多 300 字符，会出现在邀请邮件的正文中。
5. 点击「发送邀请」，系统即时发送邀请邮件，邮件中包含加入链接，链接有效期 7 天。

受邀者点击邮件中的链接后，根据其账号状态有两种流程：

邀请码适用于批量招募成员，或在无法获取对方邮箱时的场景（如学术会议、课程招募）。

1. 进入 设置 → 团队成员 → 邀请码。
2. 点击「生成邀请码」，设置以下参数：
   • 有效期：1 天 / 7 天 / 30 天 / 永久（永久邀请码谨慎使用）
   • 使用次数上限：1 次（单次邀请） / 10 次 / 100 次 / 无限
   • 默认角色：加入者获得的角色，可在成员加入后单独修改
3. 系统生成一个带有邀请码的链接（格式：https://app.ponylab.io/join?code=XXXXXX）。
4. 将链接分享给目标人群。拥有链接的用户点击即可加入，无需 SUPER_ADMIN 单独审批。
5. 在邀请码列表中可随时停用或删除邀请码，使其立即失效。

在 设置 → 团队成员 页面，「待接受」标签页列出所有已发送但未被接受的邀请：

• 重新发送：邀请链接过期（7 天后）后可点击「重发」，系统发送新的邀请邮件。
• 撤回邀请：点击「撤回」，邀请链接立即失效，即使受邀者此后点击链接也无法加入。
• 修改角色：在邀请被接受之前，可以修改分配给受邀者的角色。

1. 进入 设置 → 团队成员，找到目标成员。
2. 点击该成员行末尾的「···」菜单，选择「更改角色」。
3. 从弹窗中选择新角色（SUPER_ADMIN / PI / RESEARCHER / TECHNICIAN）。
4. 点击「确认更改」。更改立即生效，成员下次请求时即应用新权限（无需重新登录）。

1. 进入 设置 → 团队成员，找到目标成员。
2. 点击「···」菜单，选择「从团队移除」。
3. 在确认弹窗中输入成员邮箱地址（防止误操作），点击「确认移除」。

当前 SUPER_ADMIN 可以将团队所有权转让给另一个团队成员：

1. 进入 设置 → 高级设置 → 转让所有权。
2. 从团队成员列表中选择接受所有权的目标成员。
3. 系统发送确认邮件到当前 SUPER_ADMIN 的邮箱，需在邮件中点击确认链接（防止误操作）。
4. 目标成员升级为 SUPER_ADMIN，原 SUPER_ADMIN 降级为 PI（如果原有两个角色，保持较高角色）。

成员可以主动离开团队（无需 SUPER_ADMIN 操作）：

1. 点击团队名称下拉菜单中的「团队设置」。
2. 滚动至页面底部，点击「离开团队」。
3. 在确认弹窗中点击「确认离开」。

团队级通知设置定义了所有成员的默认通知行为。成员可在个人设置中覆盖团队默认值。

AI 配置在「设置 → AI 配置」中进行，详细说明请参阅 AI 功能指南 → 配置 AI。

1. 用户登录后，JWT（登录令牌）中包含 team_id 字段。
2. 每个 API 请求到达时，NestJS 中间件从 JWT 中提取 team_id，通过 SET LOCAL 写入 PostgreSQL 会话变量。
3. 所有涉及团队数据的表（实验、样品、库存等）都启用了 RLS 策略，规则为：USING (team_id = current_setting('app.current_team_id')::uuid)
4. PostgreSQL 在执行每个查询时自动应用该过滤条件，无法通过 SQL 注入或代码 bug 绕过。

因为数据完全隔离，没有直接的「跨团队数据迁移」功能。以下是三种可行方案：

1. 进入 设置 → 订阅计划，点击「升级至专业版」按钮。
2. 系统跳转至 Stripe 安全支付页面（由 Stripe 托管，PonyLab 不存储你的信用卡号）。
3. 填写信用卡信息：卡号、到期日、CVV、持卡人姓名和账单地址。
4. 可选：输入优惠码（如来自邀请码的折扣码）。优惠码可以是固定折扣或按月百分比折扣。
5. 查看订单摘要（显示月费、税额、合计），确认无误后点击「订阅」。
6. Stripe 处理支付（通常在 2 秒内完成），成功后页面跳回 PonyLab。
7. 立即生效：AI 功能、无限工作流规则、扩大的成员和存储限制立即可用，无需重新登录。

在「设置 → 订阅计划」中点击「管理订阅」，跳转至 Stripe 客户自助门户。在门户中可以：

• 查看账单历史：过去所有账单的日期、金额和状态
• 下载发票：PDF 格式，可用于报销或财务凭证
• 更换支付方式：替换信用卡或添加备用付款方式
• 更新账单地址：影响发票上显示的地址信息
• 取消订阅：选择立即取消或当前计费周期结束后取消

学术机构、高校实验室和注册非营利组织可申请优惠定价：

1. 发送邮件至 [email protected]，主题为「教育/非营利优惠申请」。
2. 提供机构证明文件（大学邮箱、机构官网链接或非营利注册证明）。
3. 销售团队通常在 2 个工作日内回复，提供优惠码或自定义报价。