Appearance

Workspaces ​

Workspace 是 Web3alert 的工作空间，团队在其中保存和配置自己的 projects、subscriptions、delivery resources、data sources 和 address book。

简单来说，account 负责用户的个人登录、个人资料和 billing，而 workspace 负责协作和服务中的工作数据。

一个 account 可以属于多个 workspaces。Active workspace 在左侧菜单中选择，它决定用户在服务主要章节中看到哪些实体：

  • Projects - 在 workspace 中创建的项目，以及可用的 marketplace projects；
  • Subscriptions - 当前 workspace 的 subscriptions；
  • Resources - 当前 workspace 的投递渠道和外部 endpoints；
  • Data sources - 当前 workspace 的 custom data sources 和可用的 system sources；
  • Addresses - 当前 workspace 的 address book。

Workspace 和 Account ​

不要把 workspace 和 account 混在一起。

Account ​

Account 是用户的个人实体。

Account 包含：

  • 授权方式；
  • 用户个人资料和 avatar；
  • billing profile；
  • balance；
  • 当前 tier；
  • tiers 和 project free-access add-ons 的购买记录；
  • 用户在不同 workspaces 中的个人成员关系。

Workspace ​

Workspace 是团队或用户的工作实体。

Workspace 包含：

  • workspace 的 title、avatar 和 name；
  • workspace 成员及其 roles；
  • 用于添加成员的 invite link；
  • 在该 workspace 中创建的 projects；
  • project transfer requests；
  • workspace subscriptions；
  • workspace resources；
  • workspace custom data sources；
  • workspace address book；
  • workspace subscription logs。

当用户切换 active workspace 时，account 仍然是同一个，但看到的是另一个工作上下文。

Workspace 左侧菜单 ​

左侧菜单中有一个独立的 Workspace 区块。

Current Workspace ​

区块顶部行显示当前 workspace：它的 avatar 或名称首字母、title 和展开箭头。

点击这一行会打开 workspace-menu。

Parameters ​

打开 Workspace parameters，也就是当前 workspace 的设置页面。

Workspace 参数、成员、transfer requests 和 subscription logs 都在这里管理。

Switch Workspaces ​

显示当前 account 所属的其他 workspaces。

点击另一个 workspace 会切换 active workspace。切换后，如果可能，界面会停留在同一个章节。例如，用户可以从一个 workspace 的 Projects 切换到另一个 workspace 的 Projects。如果当前详情页在新的 workspace 中不存在，界面会把用户带回项目列表。

Add Workspace ​

打开新 workspace 创建流程。

创建 Workspace ​

新 workspace 通过左侧菜单创建：Workspace -> Add workspace。

创建后，界面会将用户切换到新的 workspace，并打开 Projects。

Title ​

Workspace 的可见名称。

Title 显示在左侧菜单、workspace 设置，以及其他需要可读 workspace 名称的界面位置。

Title 是必填项。

Name ​

Workspace 的稳定 slug。

Name 用作 workspace 的技术名称，并会进入属于该 workspace 的实体 fullname。例如，一个项目可以获得类似 <workspace>.<project-name> 的 fullname。

Name 是必填项，必须是 kebab-case：拉丁字母、数字和连字符。

在用户手动修改 Name 之前，表单会尝试从 Title 生成它。如果 title 包含不支持的字符，就需要手动填写 name。

Reserved Names ​

一些名称由平台保留。

例如，与 common 或 web3alert 相关的 workspace names 和 titles 不能用于普通用户 workspaces。

Cancel ​

取消 workspace 创建，并把用户带回主界面。

Workspace Roles ​

Workspace 成员拥有其中一个 role。

Owner ​

Workspace 的主要 owner。

Owner 可以管理 workspace settings、成员和 project transfers。只有 owner 可以把项目从 workspace 中 transfer 出去。

Admin ​

Workspace 管理员。

Admin 可以管理 workspace settings 和成员，但不能代表 owner 发起 project transfer。

Developer ​

处理 workspace 技术实体的成员。

具体访问权限取决于 projects 和服务章节的权限。在 workspace settings 中，developer 不管理成员和 transfer requests。

User ​

Workspace 的基础成员。

通常使用已经准备好的 projects、subscriptions 和 resources，但不管理 workspace settings。

Workspace Parameters ​

Workspace parameters 是 active workspace 的设置菜单。

标签页集合取决于用户 role 和 workspace 本身。例如，Project transfers 只对 owner 可用。

Information ​

Information 标签页包含 workspace 的主要参数。

Workspace ​

Workspace 资料面板。

面板中显示：

  • workspace avatar；
  • workspace title；
  • title 编辑按钮。

Avatar ​

Workspace avatar 显示在左侧菜单中，以及需要在视觉上区分不同 workspace 的地方。

要替换 avatar，请点击当前图片。支持最大 1 MB 的 JPG 和 PNG 文件。

上传时会打开 crop tool。Workspace 使用 rounded-square crop，因为 workspace avatar 在界面中显示为圆角方形。

Title ​

Title 可以直接在 workspace 面板中编辑。

保存后，新名称会显示在左侧菜单和 workspace settings 中。

Title 不能为空。

Name ​

Workspace 的 read-only 名称。

Name 不能从 settings 中编辑，因为它参与实体 fullnames 和 links。

Members ​

Members 标签页管理 workspace 成员。

它对可以管理 workspace 的用户可用。通常是 owner 和 admin。

Invite New Members ​

对于普通 workspaces，该标签页会显示 invite link。

可以复制这个 link 并发送给需要加入 workspace 的用户。用户通过 invite link 进入时，如果尚未登录 Web3alert，会先完成授权，然后点击 Join 并进入 workspace。

Workspace Members ​

Workspace 成员列表。

每个成员会显示：

  • avatar 或名称首字母；
  • display name；
  • 如果是当前用户，会显示 You 标记；
  • 当前 role；
  • 如果当前用户可以移除成员，会显示删除按钮。

Role Select ​

允许修改成员 role。

选择 role 后会立即应用修改。

可用 roles：

  • Owner；
  • Admin；
  • Developer；
  • User。

Remove Member ​

从 workspace 中移除成员。

移除前会显示确认。如果用户移除自己，这个操作等同于 Leave workspace。

Members Access ​

如果用户没有管理成员的权限，该标签页会显示 read-only 状态。

在这种模式下，用户会看到只有 owner 或 admin 可以邀请成员、修改 roles 和移除人员。

Project Transfers ​

Project transfers 标签页管理 projects 在 workspaces 之间的 transfer。

它只对当前 workspace 的 owner 可用。

Transfer 不会立刻移动项目。首先创建 request，然后目标 workspace 的 owner 接受或拒绝它。只有 request 被接受后，项目才会变更 owner。

Create Transfer Request ​

用于准备 transfer request 的表单。

Project ​

需要 transfer 的项目。

列表包含当前 workspace 中可 transfer 的 projects。

Target Workspace ​

应该接收项目的 workspace name。

仅知道 workspace name 不足以移动项目：request 仍然必须由目标 workspace 的 owner 接受。

Target Project Name ​

项目在目标 workspace 中的新名称。

如果字段为空或保持当前值，项目会保留自己的 name。如果需要在 transfer 时重命名项目，这里填写新的 project name。

Get Plan ​

在创建 request 前构建 transfer plan。

Plan 显示将被影响的内容：

  • triggers 数量；
  • templates 数量；
  • topics 数量；
  • subscriptions 数量；
  • 需要更新的 aliases 数量。

如果发现 conflicts，必须先修复它们，才能创建 request。

Conflicts ​

阻止 transfer 的问题列表。

例如：

  • target workspace 未找到或不能接受 transfer；
  • target workspace 中已经有同名项目；
  • target trigger fullnames 与现有 triggers 冲突；
  • aliases 已被其他实体占用。

Request Transfer ​

基于最近一次构建的 plan 创建 transfer request。

如果 plan 构建之后数据发生变化，backend 可能会拒绝 request，并要求重新构建 plan。

Outgoing Requests ​

从当前 workspace 发出的 requests。

每个 request 显示：

  • source project 和 target project；
  • 创建日期；
  • 过期时间；
  • status；
  • triggers/templates 的简短数量。

Pending request 可以用 Cancel 取消。

Incoming Requests ​

当前 workspace 收到的 requests。

Pending request 可以用 Accept 接受，或用 Reject 拒绝。

接受后，backend 会应用 transfer：修改项目的 workspace，更新相关 fullnames 和 aliases，然后 request 获得最终 status。

Subscription Logs ​

Subscription logs 标签页显示当前 workspace subscriptions 的 alerts 历史。

这是投递工作日志：它帮助理解哪些 subscription alerts 已发送、被阻止、被 rate limit 限制，或以错误结束。

Last Entries ​

限制日志中的记录数量。

可用值：

  • 50；
  • 100；
  • 250；
  • 500。

Auto-Refresh ​

启用日志自动刷新。

可用值：

  • Off；
  • 5s；
  • 10s；
  • 30s。

当 auto-refresh 启用时，日期过滤器会隐藏，因为日志会作为最近事件的 live-view 工作。

Before / After ​

时间过滤器。

Before 显示所选日期和时间之前的记录。After 显示所选日期和时间之后的记录。

Date and Time ​

为 Before 或 After 过滤器选择日期和时间。

在 popover 中可以选择 day、hour 和 minute。Now 按钮填入当前时间，Clear 清除过滤器。

Refresh ​

手动刷新日志。

Time ​

Log entry 创建时间列。

表头按钮按时间排序记录：从新到旧，或从旧到新。

Subscription ​

Alert 路由列。

它显示 project、trigger 或 template context，以及投递渠道。如果 subscription 有 inputs 或 filters，旁边可能会显示带有简短提示的 details badge。

Status ​

Status 过滤器和列。

可用 statuses：

  • Delivered；
  • Failed；
  • Rate limited；
  • Blocked。

Expanded Log Row ​

点击一行会展开详情：

  • Reason - 错误原因或补充信息；
  • Input - replay/test input，如果存在；
  • Test run - 基于 log entry 数据执行的 subscription test run，如果该记录有可用的关联 subscription。

Danger Zone ​

Danger zone 标签页包含离开 workspace。

Leave Workspace ​

将当前用户从 workspace 中移除。

离开前会显示确认。

如果用户是 workspace 中唯一的成员，离开后 workspace 会被删除。

Last Workspace ​

如果这是用户唯一的 workspace，用户不能离开。

在这种情况下，Leave 按钮会被禁用，标签页显示 You cannot leave your last workspace。