ai/docs/system_b/08_GeekerAdmin后台管理设计.md

# 08_GeekerAdmin后台管理设计

## 1. 文档目标

本文档定义基于 Geeker-Admin 二开的后台管理系统菜单、页面字段、操作按钮、权限和审核流程。

## 2. 后台角色

| 角色 | 权限 |
|---|---|
| 超级管理员 | 全部权限，包括系统配置和 Provider 密钥 |
| 管理员 | 用户、订单、项目、任务、模板管理 |
| 运营 | 案例、模板、项目审核、修改申请 |
| 审核员 | 照片审核、成品审核、内容审核 |
| 财务 | 订单、支付、退款、成本报表 |

## 3. 菜单结构

```text
仪表盘
用户管理
项目管理
订单管理
生成任务
素材管理
模板中心
  人生主题
  套餐管理
  视觉风格
  世界观模板
  场景模板
  镜头模板
  文案模板
  音乐素材
案例管理
修改申请
授权与隐私
AI Provider
日志中心
系统配置
```

## 4. 仪表盘

### 指标卡片

- 今日订单数
- 今日收入
- 今日生成项目数
- 今日完成项目数
- 待审核项目数
- 失败任务数
- AI 成本
- 毛利估算

### 图表

- 订单趋势
- 成本趋势
- 热门主题排行
- 热门世界排行
- 失败任务类型排行

## 5. 用户管理

### 表格字段

- 用户 ID
- 昵称
- 手机号
- 微信 openid
- 注册时间
- 项目数
- 订单数
- 消费金额
- 状态

### 操作

- 查看详情
- 禁用用户
- 恢复用户
- 查看项目
- 查看订单
- 查看授权记录

## 6. 项目管理

### 筛选

- 项目状态
- 人生主题
- 套餐
- 风格
- 用户手机号
- 创建时间
- 是否公开授权

### 表格字段

- 项目 ID
- 用户
- 标题
- 主题
- 套餐
- 风格
- 世界数量
- 当前状态
- 支付状态
- 创建时间
- 完成时间

### 操作

- 查看详情
- 查看素材
- 查看任务
- 手动重试
- 转人工
- 标记异常
- 强制完成
- 取消项目

### 项目详情页

Tab：

- 基本信息
- 用户照片
- 人物档案
- 世界/场景
- 镜头计划
- 生成素材
- 任务记录
- 订单信息
- 修改记录
- 授权记录

## 7. 订单管理

### 字段

- 订单 ID
- 用户
- 项目 ID
- 套餐
- 金额
- 支付方式
- 支付状态
- 退款状态
- 创建时间
- 支付时间

### 操作

- 查看订单
- 手动标记支付
- 创建退款记录
- 查看项目
- 导出订单

## 8. 生成任务管理

### 筛选

- 任务类型
- 状态
- Provider
- 项目 ID
- 创建时间

### 字段

- 任务 ID
- 项目 ID
- 类型
- Provider
- 状态
- 重试次数
- 成本
- 耗时
- 错误码
- 创建时间

### 操作

- 查看输入
- 查看输出
- 重试
- 终止
- 跳过
- 转人工
- 查看 Provider 日志

## 9. 素材管理

### 字段

- 素材 ID
- 项目 ID
- 用户
- 类型
- 缩略图
- 尺寸
- 文件大小
- 可见性
- 创建时间

### 操作

- 预览
- 下载
- 生成签名链接
- 删除
- 标记公开案例资源

## 10. 模板中心

### 10.1 人生主题管理

字段：

- 编码
- 名称
- 封面
- 人物结构规则
- 是否启用
- 排序

操作：新增、编辑、启用、禁用、排序。

### 10.2 套餐管理

字段：

- 套餐编码
- 套餐名称
- 价格
- 世界数量
- 场景数量
- 图片数量
- 视频时长
- 修改次数
- 是否人工审核
- 是否支持高级动态

### 10.3 视觉风格管理

字段：

- 风格编码
- 名称
- 预览图
- 风格 Prompt
- 禁止项
- 支持主题
- 是否启用

### 10.4 世界观模板管理

字段：

- 世界编码
- 名称
- 分类
- 封面
- Prompt Base
- 服装规则
- 场景规则
- 禁止项
- 支持主题
- 支持风格
- 是否高级

操作：

- 新增世界
- 编辑世界
- 配置 Prompt
- 测试生成
- 启用/禁用

### 10.5 场景模板管理

字段：

- 场景编码
- 所属世界
- 名称
- 封面
- 场景 Prompt
- 构图规则
- 光影规则
- 特效类型
- 推荐镜头数

### 10.6 镜头模板管理

字段：

- 镜头编码
- 所属场景
- 镜头类型
- 视角
- 构图
- Prompt 规则
- 默认时长
- 特效类型

### 10.7 文案模板管理

字段：

- 主题
- 文案风格
- 文案类型
- 模板内容
- 变量
- 状态

文案类型：

- 片头
- 旁白
- 字幕
- 片尾
- 誓言
- 祝福语

### 10.8 音乐素材管理

字段：

- 音乐名称
- 情绪
- 文件
- 时长
- 授权类型
- 来源
- 使用范围

必须记录版权来源。

## 11. 案例管理

### 字段

- 案例 ID
- 来源项目
- 标题
- 封面
- 视频
- 主题
- 风格
- 世界
- 是否首页推荐
- 授权记录
- 状态

### 操作

- 从项目生成案例
- 编辑标题和封面
- 设置推荐
- 上架/下架
- 排序

规则：无公开授权记录，不允许上架。

## 12. 修改申请管理

### 字段

- 修改 ID
- 项目 ID
- 用户
- 修改类型
- 修改内容
- 剩余次数
- 状态
- 处理人
- 创建时间

### 操作

- 接受修改
- 拒绝修改
- 转人工
- 创建重做任务
- 标记完成

## 13. 授权与隐私管理

管理：

- 照片使用授权
- 公开案例授权
- 未成年人授权
- 隐私协议确认
- 用户删除申请

操作：

- 查看授权详情
- 导出授权记录
- 处理删除申请

## 14. AI Provider 管理

字段：

- Provider 类型
- 名称
- 模型名
- API Base
- 密钥引用
- 优先级
- 质量等级
- 限流配置
- 成本规则
- 备用 Provider
- 状态

操作：

- 新增 Provider
- 编辑 Provider
- 测试连接
- 启用/禁用
- 设置优先级

密钥不允许明文展示。

## 15. 日志中心

日志类型：

- 登录日志
- 操作日志
- AI 调用日志
- 支付日志
- 下载日志
- 错误日志

## 16. 系统配置

配置项：

- 上传文件大小限制
- 下载链接有效期
- 默认重试次数
- 每用户每日预览次数
- 项目保留天数
- 是否开启人工审核
- 是否开启案例授权
- 水印配置
- 成本告警阈值

## 17. V3 真人动态视频后台增量

### 17.1 身份锚点管理

项目详情新增：

- 人物参考照。
- 身份锚点图。
- 用户确认状态。
- 管理员确认状态。
- 本人相似度评分。
- 重生 / 标记通过 / 标记拒绝。

### 17.2 视频片段管理

项目详情新增视频片段列表：

- 镜头号。
- 动作模板。
- Provider。
- 输入关键帧。
- 输出视频。
- 片段时长。
- 预计成本 / 实际成本。
- 状态。
- 质检分。
- 重试次数。

操作：

- 预览片段。
- 重试片段。
- 替换片段。
- 执行质检。
- 转人工。

### 17.3 动作模板管理

后台新增动作模板菜单：

- 动作名称。
- motion_type。
- 支持主题。
- 支持世界。
- Prompt 规则。
- 默认时长。
- 难度等级。
- 成本等级。

### 17.4 视频 Provider 管理

AI Provider 管理需支持：

- MiniMax Hailuo。
- 阿里 Wan。
- Vidu。
- Seedance / 即梦。
- Kling。
- Runway。
- MockVideoProvider。

真实视频 Provider 默认禁用；后台测试真实视频 Provider 也应禁用或必须二次确认，避免误扣费。

### 17.5 V3 审核项

审核页新增：

- 是否像本人。
- 是否变脸。
- 是否男女混脸。
- 是否年龄变化过大。
- 动作是否自然。
- 表情是否怪异。
- 是否有不合适姿势。
- 是否适合公开案例。