工作流自动化

示例 1：实验被签名时通知 PI

最常见的自动化规则。当任意研究员完成实验签名后，立即通知 PI 审阅并进行 PI 签名，确保签名链完整。

示例 2：库存低于最低水位时创建补货任务

实验室最常见的库存管理自动化：当关键试剂数量下降到最低水位以下时，自动创建补货任务，分配给实验室管理员，设置 3 天截止日期。

示例 3：偏差报告后自动创建 CAPA

合规自动化的核心规则：当高影响协议偏差被记录时，自动创建 CAPA 并通知 PI，确保合规响应时间在 24 小时以内。

示例 4：任务逾期时发送 Webhook 到 Slack

将 PonyLab 的任务逾期通知推送到实验室的 Slack 频道，让团队在熟悉的工具中收到提醒。

{
  "text": "⚠️ 任务逾期提醒",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*⚠️ 高优先级任务已逾期 {{task.overdueDays}} 天*\n任务：<{{task.url}}|{{task.title}}>\n项目：{{task.project.name}}\n负责人：{{task.assigneeNames}}"
      }
    }
  ]
}

示例 5：项目所有任务完成时更新实验状态

当项目中所有关联任务都完成时，自动将关联的实验状态更新为「COMPLETED」，并通知 PI 进行最终签名，实现实验-任务的自动联动。

场景 1：小型课题组（5–10 人）基础自动化套装

推荐从以下 3 条规则开始，覆盖日常最高频需求：

1. 实验完成 → 通知 PI 签名（示例 1 变体）
2. 任务逾期 → 通知负责人和 PI
3. 关键库存低于阈值 → 创建补货任务（示例 2）

场景 2：受监管实验室合规自动化套装

在基础套装基础上，增加以下合规相关规则：

1. 高影响偏差 → 自动创建 CAPA（示例 3）
2. CAPA 逾期 3 天 → 升级通知给 SUPER_ADMIN
3. 仪器鉴定 30 天内到期 → 通知设备管理员
4. 协议有效期 30 天内到期 → 通知协议作者安排审核

场景 3：与外部系统集成（ERP / Slack / 自研 LIMS）

利用 Webhook 动作构建 PonyLab 与外部系统的实时数据流：

1. 实验签名完成 → Webhook 到 ERP 系统（同步实验数据用于成本核算）
2. 库存调整 → Webhook 到 Slack #lab-inventory 频道
3. 样品创建 → Webhook 到自研 LIMS（同步样品元数据）
4. 每日 07:00 定时 → Webhook 到看板工具（获取今日任务摘要）

Q: 一个团队可以创建多少条自动化规则？

A: 免费版最多 5 条规则；标准版最多 50 条；企业版无限制。当前规则数量和限制可在「系统 → 自动化」页面顶部查看。

Q: 如果规则的 Webhook 目标 URL 长期不可用，规则会怎样？

A: 连续 10 次执行失败后，规则会被自动暂停（状态变为「已暂停-错误」），并发送告警通知给 SUPER_ADMIN。修复目标 URL 后，在规则详情页点击「恢复规则」即可重新启用。

Q: 定时触发器的时区是以哪个为准？

A: 定时触发器使用团队时区（在「系统 → 团队设置 → 时区」中配置，默认 UTC+8）。修改团队时区后，所有定时规则立即按新时区计算下次触发时间。

Q: 自动化规则创建的 CAPA 和手动创建的有什么区别？

A: 功能完全一样，唯一的区别是：自动创建的 CAPA 在「创建方式」字段显示「自动化规则：[规则名称]」，在审计追踪中显示由系统自动创建。此外，自动创建的 CAPA 问题描述中会包含触发规则时自动填入的上下文信息（如偏差描述），节省手动填写时间。

Q: 可以在规则中引用当前登录用户吗？

A: 不可以。自动化规则在后台执行，没有「当前登录用户」的概念。触发规则的用户可以通过 {{user.name}} 引用，但如果是定时触发，user 相关变量为空。如需根据触发者动态路由通知，使用「接收人 = 触发人」选项。

Q: Webhook 请求体支持嵌套 JSON 吗？

A: 支持。Payload 模板可以是任意合法的 JSON 结构，包括嵌套对象和数组。系统会先解析模板变量，然后将结果作为 JSON 请求体发送。注意：变量值中若含有引号或特殊字符，系统会自动 JSON 转义。

Q: 同一个事件可以匹配多条规则吗？

A: 是的。当一个事件发生时，所有匹配该事件类型且条件满足的规则都会执行（并行执行，互不影响）。执行顺序不保证，但通常按规则创建时间排序。建议避免依赖多条规则的执行顺序。

Q: 规则能访问历史数据吗？（如「最近 30 天内已经创建了 3 次 CAPA」）

A: 当前规则引擎不支持聚合查询（如计数、求和）。规则只能访问触发事件本身的数据。如果需要基于历史数据的复杂条件，建议通过 Webhook 将事件推送到外部系统，在外部系统中实现复杂逻辑后再调用 PonyLab API。

Q: 如何暂时禁用某条规则（如节假日期间）？

A: 在自动化规则列表页，找到目标规则，点击最右侧的开关图标（绿色=启用，灰色=禁用）即可切换。禁用状态下规则不会执行，但配置保留，随时可以重新启用。也可以设置「规则有效期」（在规则详情页），在指定时间范围外自动禁用。

Q: 动作执行的顺序有保证吗？如果动作 1 失败，动作 2 还会执行吗？

A: 动作按列表顺序串行执行，顺序有保证。默认情况下，动作 1 失败不影响动作 2 执行（每个动作独立重试）。如果业务逻辑要求动作 1 成功才执行动作 2，可以勾选「失败时停止」选项，此时动作 1 失败后后续动作不再执行。

问题：规则已启用，事件发生后但没有执行

原因：① 触发器类型与实际事件不匹配；② 条件评估不满足（最常见原因）；③ 规则被自动暂停（连续失败 10 次）。

解决方法：① 在执行日志中查找该事件发生时间附近的记录（有日志代表规则被触发，哪怕条件不满足也会记录）；② 若日志中没有记录，检查触发器类型是否正确；③ 若日志中有「条件不满足」记录，展开详情查看哪个条件的实际值与预期不符；④ 检查规则状态是否为「已暂停-错误」。

问题：Webhook 请求成功发送但目标服务没有收到

原因：① 目标服务的防火墙/白名单未放行 PonyLab 的 IP；② 目标 URL 使用 HTTP 而非 HTTPS（PonyLab 只支持 HTTPS）；③ 目标服务响应超时（超过 10 秒）被误认为失败。

解决方法：① 将 PonyLab Webhook 出口 IP 段加入白名单（IP 范围在「系统 → 自动化 → Webhook 设置」中查看）；② 确认目标 URL 以 https:// 开头；③ 在执行日志中查看 HTTP 响应状态码，超时的会显示「Timeout」。

问题：模板变量在通知中显示为 {{experiment.title}} 而不是实际值

原因：变量名拼写错误（区分大小写），或该触发器不支持该变量。

解决方法：参照「模板变量」章节检查变量名拼写（全小写，点号分隔）。使用 Dry-run 测试查看变量渲染后的实际内容，确认哪些变量有值、哪些为空。

问题：定时规则没有在预期时间触发

原因：① 团队时区设置与预期不符（如设置了 UTC+8 但实际使用 UTC）；② 规则配置的是每周二，但当天是周一；③ 规则在目标时间前被暂停了。

解决方法：① 在「系统 → 团队设置 → 时区」确认当前时区；② 在规则详情页确认定时配置；③ 检查执行日志，查看上次成功触发的时间；④ 注意定时触发器有 ±5 分钟的执行窗口（不精确到秒），可能稍早或稍晚触发。

问题：CREATE_CAPA 动作创建了大量重复的 CAPA

原因：触发器 inventory.low_stock 在库存量一直低于阈值时，每次有库存变动（如消耗）都会触发，导致反复创建 CAPA。

解决方法：在条件中添加「最近 N 天内未创建同类 CAPA」的防重条件（如果系统支持），或改用定时触发器（每周检查一次库存水位）代替事件触发。也可以在创建 CAPA 的动作后，添加「为库存条目添加标签『已处理』」的动作，并在条件中增加「inventory.tags not_contains 已处理」。

问题：通知发送了，但接收人只收到应用内通知，没有收到邮件

原因：① 该用户在「个人设置 → 通知」中关闭了自动化规则的邮件通知；② 邮件被邮件服务商标记为垃圾邮件。

解决方法：① 通知该用户检查个人通知设置；② 提示用户将 [email protected] 加入邮件白名单/受信发件人；③ 检查该团队的邮件发送配置是否使用了自定义 SMTP 且配置正确。

问题：规则触发后动作执行很慢（超过 1 分钟）

原因：① Webhook 目标响应慢；② 系统在高负载状态下队列积压。

解决方法：① 检查 Webhook 目标服务的响应时间（在执行日志中查看动作执行耗时）；② 若 Webhook 目标不需要等待完整处理，配置目标服务立即返回 200（异步处理），而非等处理完再响应；③ 系统队列积压情况可在「系统 → 状态」中查看。

问题：无法选择某个团队成员作为通知接收人

原因：该成员可能已被移出团队，或其账号处于禁用状态。

解决方法：在「设置 → 团队成员」中确认该成员的账号状态。若成员已离职，应更新规则的接收人为当前在职成员，避免通知发送到无效账号。