# 运营台概览

「运营台」是平台运营人员在隔离网段上经营租户、市场、套餐与运行时的控制台。工作台首页先列出今天要处理的待办，再展示平台指标、最近运营动作和平台状态。

## 谁能用

运营台面向平台运营与技术支持人员，访问需要分配 `platform.ops` 或 `platform.support` 角色：

| 角色 | 权限属性 | 可操作内容 | 说明 |
|---|---|---|---|
| `platform.ops` | 读写 | 可开通租户、停用租户、审核条目、修改套餐、发布公告、修改模型供应商等 | 具备完整的运营写操作权限 |
| `platform.support` | 只读 | 仅可浏览与查看各项数据、待办及平台状态 | 写操作按钮不出现或呈置灰状态，写请求会被拒绝 |

权限控制与访问限制表现如下：
- **网络环境隔离**：运营台只挂在专用的隔离管理网（端口 `:8443` / `ops-net`）中，不向公网暴露。
- **独立登录认证**：运营台不挂在租户工作台，也不通过租户登录页登录。用户会话由独立登录服务配合身份中心的运营项目签发。在身份中心登录时校验角色，未获授权的账号无法通过登录。
- **无权限整页拦截**：若已登录账号缺少相应角色（例如仅拥有租户管理员角色 `tenant.admin`），页面整页显示「没有运营台权限」，说明区显示当前账号的邮箱或姓名后接「 缺少 platform.ops 或 platform.support 角色，请联系平台管理员。」，并提供「退出登录」按钮。
- **侧栏用户标识**：侧栏底部用户菜单显示当前登录账号的姓名或邮箱，以及对应的角色字符串（如 `platform.ops`），没有单独的徽章。

## 怎么打开

1. 在管理网环境下，打开浏览器访问 `https://ops.{base}:8443/`（本机环境常见 `https://ops.kwork.local:8443/`）。
2. 若尚未登录，网关自动重定向至身份中心登录页。输入分配了平台角色的账号密码完成登录，验证通过后自动返回运营台。
3. 登录成功后进入运营台界面，顶部显示壳标题「运营台」，默认打开「工作台」页面。

进入运营台后，左侧导航包含以下分组与功能入口：

| 分组 | 菜单项 | 说明 |
|---|---|---|
| （未分组） | 「工作台」 | 运营台首页，集中展示待办工作队列、平台指标、最近运营动作与平台状态 |
| 「平台」 | [租户](/ops/tenants) | 查看与管理租户列表及全貌，开通租户在列表中通过对话框发起 |
| 「平台」 | 「开发者组织」 | 查看与管理开发者组织列表及全貌 |
| 「平台」 | 「支持访问」 | 查看客户授权的支持访问列表并跟进支持会话 |
| 「市场」 | [市场](/ops/market) | 查看已上架条目列表及全貌，评价在列表行内通过对话框发起 |
| 「市场」 | 「审核队列」 | 查看待审核条目版本队列并执行审核 |
| 「市场」 | 「应用登记」 | 查看与登记应用（页内标题为「应用注册」） |
| 「运营」 | [套餐](/ops/plans) | 查看与配置租户套餐及规格版本 |
| 「运营」 | 「公告」 | 查看、起草与发布平台公告 |
| 「运营」 | 「全局通知」 | 向租户消息中心推送全局通知 |
| 「运营」 | [模型供应商](/ops/runtime) | 配置大模型供应商接入与模型计量，维护网关一致性 |
| 「运维」 | [托管运行](/ops/runtime) | 查看与管理托管运行服务及实例 |
| 「运维」 | [平台审计](/ops/audit) | 查看平台全局操作审计日志与数据归档 |
| 「运维」 | 「许可」 | 查看与管理平台商业许可授权 |
| 「运维」 | 「服务导航」 | 探测与查看底层依赖组件及服务健康状态 |

全局操作与壳特性：
- **快捷命令面板**：当侧栏导航项超过 6 条时自动启用命令面板。在键盘上按下快捷键 `Cmd + K`（macOS）或 `Ctrl + K`（Windows/Linux）呼出。除检索导航页面外，额外支持检索租户名称（归入「租户」分组）与开发者组织名称（归入「开发者组织」分组）。
- **顶栏通知铃铛**：位于顶栏右侧，用于接收本门户通知，每 60 秒自动刷新一次。若部署环境未启用通知服务，铃铛图标不出现。
- **防泄密水印**：运营台整页覆盖当前操作人员的身份水印。
- **无独立子路由**：开通租户在[租户管理](/ops/tenants)列表中通过对话框发起；市场评分在[市场](/ops/market)列表中通过行内对话框打开；网关一致性维护位于[模型供应商](/ops/runtime)页面内；数据归档位于[平台审计](/ops/audit)页面内。

## 界面一览

工作台首页由顶部指标、超时警告、待办工作队列、最近运营动作及侧栏平台状态构成：

| 页面区域 | 组成项 | 界面内容与说明 |
|---|---|---|
| 页眉 | 页面标题 | 显示标题「工作台」，无副标题 |
| 指标四卡 | 「租户」 | 展示租户总数；说明包含「 正常 · 」与「 停用」的租户分布 |
| 指标四卡 | 「开发者组织」 | 展示开发者组织总数；说明包含「 正常 · 另有平台自身」 |
| 指标四卡 | 「上架条目」 | 展示已上架条目总数；说明包含「应用 」「 · 模板 」「 次安装」等统计 |
| 指标四卡 | 「审核积压」 | 展示待审核积压总数；有积压时说明包含「最久等了 」，队列为空时显示「队列是空的」 |
| 审核超时警告 | 警告横幅 | 当存在审核积压且等待最久的一项超过 2 天时触发展示。标题为「审核等待偏久」，正文为「最早的一项已经等了 」后接相对时间再接「。开发者在等你们，建议先处理最久的。」，提供跳转链接「去审核队列」 |
| 主栏「需要你处理」 | 工作队列待办卡片 | 系统根据平台数据实时生成，仅在存在对应数据时显示条目：<br>• **平台未就绪**：标题「平台未就绪」，说明依赖不可用或 OpenBao 处于封印状态，操作按钮「查看服务」<br>• **待审核版本**：最多展示 5 条，标题形如 应用「某某」v1.0.0 等待审核（类型包含「应用」「模板」「知识包」「素材」），说明包含条目 ID、开发者名称、「审核中」或「尚未开始」，操作按钮「去审核」；超出 5 条时在末尾增加说明「其余在审核队列里。」及操作「打开审核队列」<br>• **开发者组织无登录身份**：标题包含「 还没有登录身份」，说明提示「它的开发者现在无法登录开放平台。」，操作按钮「查看」<br>• **支持访问已批准**：标题包含「客户已批准支持访问：」，操作按钮「打开管理台」<br>• **支持访问超过 1 天未批**：标题包含「支持访问申请还没有被批准：」，说明包含「已等 」时长与「，可以提醒客户管理员。」<br>• **清理中租户**：标题包含「 个租户正在清理」，说明提示「宽限期结束后可清除；清除前可恢复。」<br>• **已停用租户**：标题包含「 个租户已停用」，说明提示「确认是否仍需保持停用。」 |
| 主栏待办状态 | 空态与错误提示 | 无任何待办时显示「现在没有待办」；待办数据读取失败时显示「有数据没有读到，上面的错误提示里可以重试。」 |
| 主栏「最近的运营动作」 | 时间线动态 | 倒序展示近期运营操作动态：<br>• 操作者显示为「系统」或「运营 …」后接账号 ID 后 4 位<br>• 无动态时显示「还没有运营动作」<br>• 加载中显示「加载中…」<br>• 读取失败显示「动态暂时读不到」<br>• 底部提供链接「查看平台审计 →」 |
| 侧栏「平台状态」 | 健康与环境信息 | 呈现平台运行指标与探测结果：<br>• 「就绪」：状态徽章显示「正常」或「异常」<br>• 「版本」：当前平台部署版本号<br>• 「环境」：显示环境标识与基础域名，格式为 `{env} · {baseDomain}`<br>• 「有效公告」：显示有效公告数字，点击跳转至「公告」页面<br>• 页脚信息：显示「检查于 」后接探测时间，正在探测时显示「检查中…」；底部提供「全部服务 →」链接 |
| 无权限页面 | 阻断提示整页 | 未获授权账号登录后显示：标题「没有运营台权限」，说明为账号邮箱或姓名后接「 缺少 platform.ops 或 platform.support 角色，请联系平台管理员。」，提供按钮「退出登录」 |

## 常用操作

### 登录运营台

1. 在管理网环境下，在浏览器地址栏输入 `https://ops.{base}:8443/`。
2. 页面重定向至身份中心登录页，输入具备 `platform.ops` 或 `platform.support` 角色的账号与密码完成登录。
3. 登录验证通过后，浏览器自动返回运营台，默认进入「工作台」页面。

> **提示**
>
> 若登录后看到整页「没有运营台权限」，说明当前账号缺少运营或支持角色。点击页面中的「退出登录」按钮，换用具备对应角色的账号重新登录。

### 处理待审核条目

1. 在工作台主栏「需要你处理」区域，定位到待审核版本条目（如 应用「某某」v1.0.0 等待审核）。
2. 点击条目右侧「去审核」。
3. 系统打开该版本的审核页面进行审批处理。
4. 若待审核条目超过 5 条，在卡片末尾「其余在审核队列里。」说明旁，点击「打开审核队列」。
5. 系统跳转至完整的[审核队列](/ops/market)页面。
6. 若页面顶部出现「审核等待偏久」警告横幅，点击横幅中的「去审核队列」，优先处理队列中等待时间最久的条目。

### 处理平台未就绪故障

1. 在「需要你处理」待办列表中，定位到严重级别为 critical 的「平台未就绪」条目。
2. 点击条目右侧「查看服务」。
3. 系统跳转至「服务导航」页面，排查未就绪的依赖组件或解除 OpenBao 封印。

### 处理开发者与支持访问待办

- **补齐开发者组织登录身份**：
  1. 在「需要你处理」区域，定位到标题包含「 还没有登录身份」的待办项。
  2. 点击条目右侧「查看」。
  3. 系统跳转至对应的开发者组织详情页配置登录身份。
- **进入已批准的支持访问**：
  1. 在「需要你处理」区域，定位到标题包含「客户已批准支持访问：」的待办项。
  2. 点击条目右侧「打开管理台」。
  3. 浏览器新标签页打开客户组织管理台应用，进入支持会话开展排查。
- **跟进未批准的支持访问申请**：
  1. 在「需要你处理」区域，定位到标题包含「支持访问申请还没有被批准：」的待办项。
  2. 查看卡片说明中的「已等 」时长。
  3. 根据提示「，可以提醒客户管理员。」，通过沟通渠道联系客户管理员完成审批。

### 检查清理中与已停用租户

1. 在「需要你处理」区域，定位到租户状态待办：
   - 看到「 个租户正在清理」时，点击该条目跳转至带有清理中状态筛选的[租户管理](/ops/tenants)列表。宽限期结束前可恢复租户，宽限期结束后可清除数据。
   - 看到「 个租户已停用」时，点击该条目跳转至带有已停用状态筛选的[租户管理](/ops/tenants)列表，核查是否仍需保持停用状态。

### 使用命令面板快速导航与搜索

1. 在键盘上按下 `Cmd + K`（macOS）或 `Ctrl + K`（Windows/Linux），打开命令面板。
2. 在输入框中输入关键字：
   - 输入页面名称，选中后按回车键跳转到指定功能页。
   - 输入租户名称，在「租户」分组中选中目标租户，按回车键打开租户全貌。
   - 输入开发者组织名称，在「开发者组织」分组中选中目标开发者组织，按回车键打开开发者组织全貌。
3. 按 `Esc` 键或点击面板外部区域关闭命令面板。

### 查看最近运营动态与平台审计

1. 在工作台主栏「最近的运营动作」区域，查看近期操作记录（操作者标为「系统」或「运营 …」后接账号 ID 后 4 位）。
2. 点击区域底部的「查看平台审计 →」。
3. 系统跳转至[平台审计](/ops/audit)页面，查看完整审计日志。

### 监控平台状态与服务探测

1. 在工作台右侧「平台状态」区域，查看「就绪」状态徽章、「版本」与「环境」信息。
2. 点击「有效公告」旁的数字，系统跳转至[公告](/ops/plans)页面查看或发布公告。
3. 查看底部「检查于 」时间确认探测时效；若需查看各服务的探测明细，点击「全部服务 →」跳转至「服务导航」页面。

### 查看门户通知

1. 点击顶栏右侧的通知铃铛图标。
2. 在展开的通知面板中查看本门户通知。通知数据每 60 秒自动刷新一次。

### 列表排序与进入全貌

1. 在运营台各数据列表（如租户列表、市场列表等）中，直接点击任意数据行，打开该条目的全貌页面。
2. 点击表格列标题，对该列数据进行正序或倒序排列（如创建时间列按 datetime 排序）。

### 错误状态重试

1. 当接口调用失败或网络异常时，页面展示错误状态提示。
2. 若工作台待办加载失败，主栏提示「有数据没有读到，上面的错误提示里可以重试。」。
3. 点击错误提示区域内的重试按钮重新加载数据。

## 状态说明

### 审核等待时效分级

系统根据审核条目在队列中的等待时长进行分级预警：

- **正常状态**：条目等待时间不足 2 天。待办卡片正常列出。
- **偏久预警（warning）**：条目等待时间达到或超过 2 天（≥ 2 天）。工作台顶部出现「审核等待偏久」黄色警告横幅，正文提示「最早的一项已经等了 」时长；待办卡片标记为 warning 级别。
- **严重超时（critical）**：条目等待时间达到或超过 5 天（≥ 5 天）。待办卡片升级为 critical 级别。

### 待办告警严重级别

工作台「需要你处理」工作队列支持 3 个告警级别：

| 告警级别 | 涉及待办事项 | 触发条件与说明 |
|---|---|---|
| critical（严重） | 「平台未就绪」 | 依赖组件不可用或 OpenBao 处于封印状态，需点击「查看服务」排查 |
| critical（严重） | 待审核版本 | 版本提交等待时间 ≥ 5 天 |
| warning（警告） | 待审核版本 | 版本提交等待时间 ≥ 2 天 |
| warning（警告） | 开发者组织无登录身份 | 组织未配置登录身份，开发者无法登录开放平台，需点击「查看」处理 |
| warning（警告） | 支持访问申请超时未批 | 支持访问申请发出超过 1 天未获客户批准 |
| warning（警告） | 清理中租户 | 存在处于清理中的租户，提示「宽限期结束后可清除；清除前可恢复。」 |
| info（普通） | 客户已批准支持访问 | 客户管理员已批准支持申请，可点击「打开管理台」开展支持 |
| info（普通） | 已停用租户 | 存在处于停用状态的租户，提示「确认是否仍需保持停用。」 |

### 平台就绪状态

- **「正常」**：底层各项基础依赖服务探测通过。
- **「异常」**：存在底层依赖不可用或 OpenBao 处于封印状态，工作队列同步生成 critical 级别「平台未就绪」待办。

### 租户状态分布

- **「 正常 · 」**：处于正常运行状态的租户。
- **「 停用」**：已被停用的租户，列入「 个租户已停用」待办关注。
- **「正在清理」**：已被标记清理的租户，列入「 个租户正在清理」待办关注。

### 待审核版本类型与状态

- **条目类型**：涵盖「应用」「模板」「知识包」「素材」4 种类型。
- **审核状态**：包含「审核中」或「尚未开始」。

## 让助手帮你做

运营台不接入助手（Agent）对话，没有 `@` 提及运营台对象的功能，工作台中也没有运营台卡片。运营台接口拒绝一切 Agent 委托令牌访问。所有运营操作均必须由运营人员在浏览器界面中手动操作完成。

## 设置

运营台工作台没有提供供用户手动配置的设置项。页面数据与状态采用系统定时自动刷新机制：

| 项目 | 刷新机制 | 说明 |
|---|---|---|
| 工作台待办队列 | 数据变动自动刷新 | 随接口数据变动自动更新，发生错误时支持重试 |
| 门户通知铃铛 | 定时刷新（每 60 秒） | 部署环境未配置通知服务时图标自动隐藏 |
| 服务健康探测 | 定时探测（每 30 秒） | 探测结果在「服务导航」与「平台状态」中同步呈现 |

## 注意事项

- **网络隔离访问**：运营台部署在专用的隔离管理网中（端口 `:8443` / `ops-net`），不向公网暴露。必须在受信任管理网环境下访问。
- **登录认证隔离**：运营台使用独立的登录认证项目（身份中心 `ops` 项目），与租户工作台完全隔离。租户管理员无法直接访问运营台。
- **只读角色限制**：`platform.support` 角色为只读权限，页面中的写按钮会自动隐藏或置灰，写请求会被拒绝。
- **工作台定位**：工作台首页属于只读仪表与待办分发中心，不在首页直接执行租户开通、版本审核或套餐变更。
- **租户业务数据边界**：运营台严格遵循数据隔离边界，看不到任何租户内部的业务数据。
- **聚合指标脱敏**：上架条目数、安装次数等平台聚合数据不包含任何具体的租户身份信息。
- **操作安全水印**：整页默认覆盖当前操作人员身份水印，防止运营数据截图外泄。
- **特定功能入口说明**：
  - 开通租户不在独立页面，而在[租户管理](/ops/tenants)列表顶部的对话框中发起；
  - 市场条目评价在[市场](/ops/market)列表行内打开对话框发起；
  - 模型网关一致性维护集成在[模型供应商](/ops/runtime)页面中；
  - 数据归档功能集成在[平台审计](/ops/audit)页面中。
- **外部应用跳转机制**：
  - 点击已批准支持访问的「打开管理台」，系统在浏览器新标签页中打开客户的「我的组织」管理台（只读支持会话），不是运营台内嵌页面；
  - 开发者门户部署在独立站点（`https://dev.{base}/`），运营台不内嵌开发者自助页面。

## 目前不支持

- **移动端运营台**：暂未提供移动端操作界面。
- **独立收入看板**：暂无独立的收入看板页面，模型计量与账单收纳在[模型供应商](/ops/runtime)页面中。
- **审核指派与 SLA 统计图**：暂不支持审核任务指派到具体人员，暂无 SLA 统计图表，仅提供基于等待时长的分级预警（2 天与 5 天）。
- **待办对象进入命令面板**：工作台待办对象暂未挂入命令面板，命令面板当前仅支持检索页面、租户名称与开发者组织名称。

## 常见问题

#### 登录后为什么显示「没有运营台权限」？
访问运营台需要账号具备 `platform.ops` 或 `platform.support` 角色。如果你使用的是仅具备租户管理员权限（如 `tenant.admin`）的账号或未授权账号，系统会阻止访问并整页显示「没有运营台权限」，说明当前账号邮箱或姓名并接「 缺少 platform.ops 或 platform.support 角色，请联系平台管理员。」。请联系平台管理员为账号添加角色，或点击「退出登录」换用具备权限的账号重新登录。

#### 为什么页面上的某些操作按钮没有出现或呈置灰状态？
如果你的账号分配的是 `platform.support` 角色，系统将采用只读策略。页面上的写操作按钮会自动隐藏或呈置灰不可点击状态，发起写请求也会被拒绝。若需要进行开通、停用、审核、修改套餐等写操作，需要由平台管理员为账号分配 `platform.ops` 角色。

#### 为什么在公网环境下无法打开运营台网址？
运营台部署在专用的内部隔离管理网中（端口 `:8443` / `ops-net`），未向公网暴露访问入口。请确保你的设备已接入管理网或受信任网络环境后再访问。

#### 能否让助手帮忙处理工作台的待办审核或租户开通？
不能。运营台与助手体系完全隔离，运营台内未接入助手对话，不支持在对话中 `@` 提及运营台对象，工作台中也没有运营台卡片。同时运营台接口拒绝一切 Agent 委托令牌访问。所有运营操作必须由运营人员在界面中亲自核对并点击处理。

#### 为什么顶栏看不到通知铃铛图标？
顶栏通知铃铛每 60 秒刷新一次，用于接收本门户通知。若当前部署环境未部署或未启用平台通知服务，系统会自动隐藏顶栏通知铃铛图标。