geo/docs/geo-platform-ops-admin-prd-v1.md

# GEO 平台管理员端 PRD V1

## 1. 文档信息

| 项目 | 内容 |
| --- | --- |
| 文档名称 | GEO 平台管理员端 PRD V1 |
| 文档版本 | V1.0 |
| 文档状态 | 待评审 |
| 创建日期 | 2026-03-25 |
| 适用阶段 | V1 立项 / 设计 / 开发评审 |
| 关联文档 | `docs/geo-platform-prd-v1.md` |
| 关联文档 | `docs/geo-platform-tech-architecture-v1-50k.md` |
| 关联文档 | `docs/media-binding-and-publish-v1.md` |

### 1.1 文档目标

本文档用于明确 GEO 平台管理员端 V1 的产品定位、权限边界、信息架构、核心流程、页面需求与验收标准，作为产品、设计、前后端、测试共同评审和执行的依据。

### 1.2 版本说明

- V1 聚焦搭建平台级运营控制台，支撑租户管理、套餐额度管理、模型配置、任务运维、监控告警和审计追踪。
- V1 不追求完整财务结算、复杂工单审批流、自动化修复编排和企业级 CMDB 能力。

## 2. 项目背景

### 2.1 背景说明

当前 `docs/geo-platform-prd-v1.md` 主要描述的是租户端业务后台，服务对象是品牌运营、内容编辑和只读成员。随着平台能力扩大，仅有租户端后台无法满足平台内部运营与管理需要，主要会出现以下问题：

- 无法统一查看全租户状态、套餐、额度和到期情况。
- 模型配置、Prompt 规则、系统模板等平台能力缺少集中管理入口。
- 异步任务失败、队列积压、平台发布异常时缺少统一运维面板。
- 高风险操作缺少集中审计，后续无法追踪谁修改了什么。
- 平台客服、运营、财务、审核等内部角色与租户端角色边界混乱。

因此需要建设独立的“平台管理员端”，作为平台内部运营、客服、超管和审核团队的统一控制台。

### 2.2 目标用户

- 超级管理员
- 平台运营
- 客服支持
- 财务运营
- 审核 / 风控人员
- 技术运维人员

### 2.3 核心价值

- 统一管理租户生命周期、套餐和额度策略。
- 统一管理平台级模型能力、模板能力和内容规则。
- 统一查看任务状态、系统健康和异常告警。
- 统一记录高风险操作、配置变更和额度变更。
- 明确平台内部角色权限边界，避免与租户端混用。

## 3. 产品定位与边界

### 3.1 产品定位

平台管理员端是 GEO 平台的内部运营控制台，不面向租户开放。其核心目标不是“使用内容生产能力”，而是“管理平台、治理风险、保障稳定、支撑运营”。

### 3.2 与租户端的关系

| 维度 | 租户端后台 | 平台管理员端 |
| --- | --- | --- |
| 服务对象 | 品牌方、编辑、只读成员 | 平台内部团队 |
| 数据范围 | 当前租户 | 全平台或指定租户 |
| 核心目标 | 生成内容、发布内容、查看效果 | 管租户、管配置、管任务、管风险 |
| 权限模型 | `tenant_role` | `platform_role` |
| 风险等级 | 中 | 高 |
| 推荐前端应用 | `admin-web` | `ops-admin-web` |

### 3.3 成功指标

- 新租户开通与初始化平均耗时 <= 10 分钟
- 平台人员查询租户状态与额度信息平均耗时 <= 1 分钟
- 异步任务失败定位时间 <= 5 分钟
- 平台关键配置变更具备 100% 审计记录
- 高风险操作具备二次确认和操作留痕

### 3.4 V1 范围

V1 包含：

- 平台工作台
- 租户中心
- 平台用户与角色管理
- 套餐与额度管理
- 模型中心
- 内容配置中心
- 平台接入管理
- 任务运维中心
- 监控告警
- 审计中心

V1 不包含：

- 完整支付结算系统
- 多级审批流引擎
- 自动化故障修复编排
- 外部合作方管理门户
- 自助报表搭建平台

## 4. 用户角色与权限

### 4.1 平台角色定义

#### 4.1.1 超级管理员

- 管理全部平台配置和权限
- 查看全量租户、任务、监控和审计数据
- 执行高风险操作，如冻结租户、修改模型默认策略、恢复关键任务

#### 4.1.2 平台运营

- 管理租户、套餐、额度和平台模板
- 查看任务状态和平台基础监控
- 不负责财务口径变更与底层密钥管理

#### 4.1.3 客服支持

- 查询租户信息、任务状态、发布失败原因
- 协助排查问题并查看操作日志
- 不允许修改关键配置和发放额度

#### 4.1.4 财务运营

- 管理套餐档位、额度策略和补量记录
- 查看租户套餐使用情况和到期信息
- 不允许修改模型参数和发布规则

#### 4.1.5 审核 / 风控

- 管理敏感词、拦截策略和审核规则
- 查看异常发布记录和风险操作日志
- 不允许修改租户套餐和模型渠道密钥

#### 4.1.6 技术运维

- 查看服务健康、队列积压、Worker 状态和告警记录
- 支持任务重试、恢复和故障排查
- 不直接参与租户商务配置

### 4.2 权限原则

- 平台管理员端与租户端账号体系逻辑隔离，但可复用统一认证服务。
- 后端权限控制必须基于 `platform_role + action + resource_scope` 校验，不能仅依赖前端隐藏菜单。
- 所有高风险操作必须具备二次确认、操作原因和审计日志。
- 涉及租户数据的查看与修改，需要明确记录目标 `tenant_id`。
- 密钥、令牌、模型渠道凭证等敏感数据默认脱敏显示。

### 4.3 权限矩阵

| 模块 | 超级管理员 | 平台运营 | 客服支持 | 财务运营 | 审核 / 风控 | 技术运维 |
| --- | --- | --- | --- | --- | --- | --- |
| 租户查看 | 是 | 是 | 是 | 是 | 否 | 是 |
| 租户冻结 / 解冻 | 是 | 是 | 否 | 否 | 否 | 否 |
| 套餐与额度调整 | 是 | 是 | 否 | 是 | 否 | 否 |
| 模型参数配置 | 是 | 否 | 否 | 否 | 否 | 是 |
| 模板 / Prompt 配置 | 是 | 是 | 否 | 否 | 是 | 否 |
| 敏感词 / 审核规则 | 是 | 否 | 否 | 否 | 是 | 否 |
| 任务重试 / 恢复 | 是 | 是 | 否 | 否 | 否 | 是 |
| 监控告警查看 | 是 | 是 | 是 | 否 | 是 | 是 |
| 审计日志查看 | 是 | 是 | 是 | 是 | 是 | 是 |

## 5. 信息架构

### 5.1 一级导航

- 工作台
- 租户中心
- 平台用户
- 模型中心
- 内容配置
- 平台接入
- 任务运维
- 监控告警
- 审计中心

### 5.2 二级导航

#### 5.2.1 工作台

- 平台概览

#### 5.2.2 租户中心

- 租户列表
- 租户详情
- 套餐与额度
- 冻结与启用记录

#### 5.2.3 平台用户

- 用户列表
- 角色权限
- 登录审计

#### 5.2.4 模型中心

- LLM 配置
- Embedding 配置
- 渠道密钥
- 限流策略

#### 5.2.5 内容配置

- 系统模板
- Prompt 规则
- 分类标签
- 敏感词规则

#### 5.2.6 平台接入

- 媒体平台
- Adapter 配置
- 发布策略
- 平台状态

#### 5.2.7 任务运维

- 生成任务
- 知识学习任务
- 发布回调任务
- 重试任务
- 死信任务

#### 5.2.8 监控告警

- 服务健康
- 队列监控
- Worker 监控
- 存储监控
- 告警记录

#### 5.2.9 审计中心

- 操作日志
- 配置变更
- 额度变更
- 风险操作记录

### 5.3 路由建议

```text
/platform/dashboard
/platform/tenants
/platform/tenants/:id
/platform/plans
/platform/platform-users
/platform/platform-roles
/platform/login-audits
/platform/models/llm
/platform/models/embedding
/platform/models/channels
/platform/models/limits
/platform/content/templates
/platform/content/prompts
/platform/content/tags
/platform/content/sensitive-rules
/platform/integrations/media-platforms
/platform/integrations/adapters
/platform/integrations/publish-policies
/platform/tasks/generation
/platform/tasks/knowledge
/platform/tasks/publish
/platform/tasks/retry
/platform/tasks/dead-letter
/platform/monitoring/services
/platform/monitoring/queues
/platform/monitoring/workers
/platform/monitoring/storage
/platform/monitoring/alerts
/platform/audit/operations
/platform/audit/config-changes
/platform/audit/quota-changes
/platform/audit/risk-actions
```

## 6. 核心流程

### 6.1 租户开通流程

1. 平台人员创建租户。
2. 系统初始化租户基础信息、默认套餐与额度。
3. 平台人员可选配置默认模型策略与模板能力。
4. 系统生成初始租户管理员账号或邀请入口。
5. 审计中心记录租户创建与初始化操作。

### 6.2 套餐与额度调整流程

1. 平台人员进入租户详情或套餐与额度页面。
2. 选择调整配额、重置时间或补量类型。
3. 系统要求填写变更原因并二次确认。
4. 变更结果立即生效或按设定时间生效。
5. 系统写入额度变更日志并通知相关租户。

### 6.3 模型配置发布流程

1. 平台人员修改默认模型、限流策略或渠道参数。
2. 系统校验参数完整性、作用范围和冲突风险。
3. 高风险配置变更需要二次确认。
4. 配置生效后，后续新任务按最新策略执行。
5. 系统写入配置变更审计记录。

### 6.4 失败任务处理流程

1. 平台人员在任务运维页筛选失败任务。
2. 查看任务参数、错误日志、重试次数、租户信息。
3. 根据错误类型选择重试、终止或转人工排查。
4. 系统记录操作人、操作原因与执行结果。
5. 若任务恢复成功，相关页面状态同步更新。

### 6.5 风险操作审计流程

1. 任意高风险操作发起前展示确认弹窗。
2. 操作人必须填写原因或选择标准原因模板。
3. 系统写入审计日志，记录前后变更快照。
4. 审计中心支持按人员、租户、模块、时间范围回溯查询。

## 7. 功能清单与优先级

| 模块 | 功能点 | 优先级 |
| --- | --- | --- |
| 工作台 | 平台核心指标、异常概览、快捷入口 | P0 |
| 租户中心 | 租户列表、详情、冻结、启用、搜索筛选 | P0 |
| 套餐与额度 | 套餐档位、额度调整、补量记录、到期管理 | P0 |
| 平台用户 | 平台账号、角色分配、登录审计 | P0 |
| 模型中心 | LLM 配置、Embedding 配置、限流、渠道管理 | P0 |
| 内容配置 | 系统模板、Prompt 规则、敏感词规则 | P1 |
| 平台接入 | 平台清单、Adapter 状态、发布策略 | P1 |
| 任务运维 | 任务列表、失败重试、死信处理 | P0 |
| 监控告警 | 服务健康、队列积压、Worker 监控、告警记录 | P0 |
| 审计中心 | 操作日志、配置变更、额度变更、风险操作记录 | P0 |

## 8. 页面详细需求

## 8.1 工作台

### 8.1.1 页面目标

为平台内部人员提供全平台运行概况、异常风险提示和高频操作入口。

### 8.1.2 页面结构

- 核心指标卡
- 风险告警区
- 队列与任务概览
- 快捷操作区
- 最近关键操作时间线

### 8.1.3 功能说明

展示指标建议包括：

- 总租户数
- 活跃租户数
- 今日任务提交数
- 今日失败任务数
- 当前队列积压数
- 当前告警数

快捷入口建议包括：

- 新建租户
- 调整额度
- 查看失败任务
- 查看告警详情

### 8.1.4 验收标准

- 首屏可展示全平台概览指标。
- 异常信息支持直接跳转到对应详情页。
- 指标数据刷新机制明确，避免人工刷新才能看到最新状态。

## 8.2 租户中心

### 8.2.1 页面目标

统一管理租户生命周期、套餐状态、基础资料和使用情况。

### 8.2.2 页面结构

- 租户列表页
- 租户详情页
- 套餐与额度页
- 冻结与启用记录页

### 8.2.3 功能说明

租户列表字段建议包括：

- 租户名称
- 租户状态
- 套餐类型
- 已用 / 总额度
- 到期时间
- 创建时间
- 最近活跃时间

租户详情建议包括：

- 基本信息
- 账号与成员概览
- 品牌数 / 文章数 / 发布数
- 最近任务状态
- 最近错误与风险提示
- 操作日志时间线

### 8.2.4 状态规则

租户状态：

- trial
- active
- frozen
- expired

### 8.2.5 验收标准

- 可按租户名、状态、套餐、时间筛选。
- 冻结和解冻操作具备二次确认。
- 套餐与额度调整具备留痕。

## 8.3 平台用户

### 8.3.1 页面目标

统一管理平台内部账号、角色与登录行为。

### 8.3.2 功能说明

- 创建平台账号
- 分配平台角色
- 禁用 / 启用账号
- 查看最近登录记录
- 查看异常登录提醒

### 8.3.3 验收标准

- 角色变更后权限立即生效。
- 登录审计可按用户和时间范围查询。
- 禁用账号后不可继续访问平台管理员端。

## 8.4 模型中心

### 8.4.1 页面目标

统一管理模型供应商、渠道、默认策略和限流能力。

### 8.4.2 功能说明

- LLM 模型配置
- Embedding 模型配置
- 渠道密钥管理
- 默认模型策略
- 按租户或套餐设置限流

### 8.4.3 风险控制

- 密钥默认脱敏
- 高风险变更要求二次确认
- 支持记录配置前后差异

### 8.4.4 验收标准

- 可配置默认模型与备用模型。
- 限流策略可按租户或套餐生效。
- 所有变更都能在审计中心回溯。

## 8.5 内容配置

### 8.5.1 页面目标

统一管理平台级模板、Prompt 规则和内容安全策略。

### 8.5.2 功能说明

- 系统模板管理
- Prompt 规则管理
- 分类标签管理
- 敏感词与拦截规则管理

### 8.5.3 验收标准

- 模板和规则可启用、停用、版本化管理。
- 敏感词规则对生成和发布链路可生效。
- 变更具备审计记录。

## 8.6 平台接入

### 8.6.1 页面目标

统一管理平台支持的媒体平台、适配器状态和发布策略。

### 8.6.2 功能说明

- 平台清单管理
- Adapter 状态与版本信息
- 发布限制规则
- 平台可用性状态展示

### 8.6.3 验收标准

- 可查看每个平台当前接入状态。
- 当平台异常时可快速标记并通知平台运营。
- 发布策略调整具备审计留痕。

## 8.7 任务运维

### 8.7.1 页面目标

统一查看各类异步任务的状态，并支持重试、终止和排查。

### 8.7.2 任务范围

- 文章生成任务
- 知识学习任务
- 发布回调任务
- 统计聚合任务
- 死信任务

### 8.7.3 功能说明

- 按任务类型、状态、租户、时间筛选
- 查看错误信息、耗时、重试次数
- 支持任务重试和终止
- 支持查看上下游关联记录

### 8.7.4 状态规则

任务状态：

- queued
- running
- success
- failed
- canceled
- dead_letter

### 8.7.5 验收标准

- 失败任务可快速定位到错误原因。
- 重试操作具备幂等保护。
- 死信任务具备单独入口与处理记录。

## 8.8 监控告警

### 8.8.1 页面目标

集中查看平台服务健康、基础设施状态和异常告警。

### 8.8.2 功能说明

- 服务健康检查
- RabbitMQ 队列积压与消费延迟
- Worker 在线数与处理耗时
- PostgreSQL / Redis / Qdrant / 对象存储状态
- 告警记录与恢复状态

### 8.8.3 告警状态

- active
- recovered
- ignored

### 8.8.4 验收标准

- 能定位队列积压、Worker 异常和依赖服务异常。
- 告警支持按级别、模块、状态筛选。
- 告警恢复后状态可追溯。

## 8.9 审计中心

### 8.9.1 页面目标

统一记录并查询平台关键操作、配置变更和额度变更。

### 8.9.2 功能说明

- 操作日志查询
- 配置变更对比
- 额度变更记录
- 风险操作记录
- 按人、模块、租户、时间检索

### 8.9.3 验收标准

- 关键模块操作具备完整日志。
- 日志包含操作人、目标对象、变更前后摘要、时间和结果。
- 风险操作日志不可被普通角色删除。

## 9. 数据对象与状态建议

### 9.1 核心对象

- 平台用户
- 平台角色
- 租户
- 套餐
- 额度记录
- 模型配置
- 模板规则
- 平台适配器
- 任务记录
- 告警记录
- 审计日志

### 9.2 关键设计要求

- 所有对象需保留 `created_by`、`updated_by`、`created_at`、`updated_at`。
- 所有高风险对象变更需支持审计快照。
- 涉及租户的数据对象必须带 `tenant_id`。

## 10. 安全与风控要求

- 平台管理员端建议使用独立入口与路由前缀。
- 平台级高风险操作需二次确认，必要时增加短信或二次口令验证。
- 敏感信息默认脱敏展示。
- 所有导出、批量修改、冻结、重试等动作均需审计。
- 登录、角色变更、配置发布等行为需进入审计中心。

## 11. V1 最小可用版本建议

如果以尽快支撑平台日常运营为目标，建议一期先上线以下模块：

- 工作台
- 租户中心
- 套餐与额度
- 平台用户
- 模型中心
- 任务运维
- 监控告警
- 审计中心

待一期稳定后，再逐步补齐：

- 内容配置
- 平台接入
- 更细粒度的风险控制与审批能力

## 12. 最终建议

平台管理员端应作为独立前端应用建设，建议命名为 `ops-admin-web`，与租户端 `admin-web` 并行存在，前端技术栈可统一采用 `Vue 3 + TypeScript + ant-design-vue + pnpm + Vite 8`。

后端在 V1 阶段可继续复用统一 Go 服务，通过 `platform_role`、`tenant_role`、路由前缀和资源范围控制实现权限隔离，推荐按以下方式组织接口：

- `/api/platform/*`：平台管理员端接口
- `/api/tenant/*`：租户端接口

这样既能保持系统结构清晰，也能控制 V1 的研发成本与复杂度。