Initial AI manga platform

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

@@ -0,0 +1,533 @@
+# 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 审核项
+
+审核页新增：
+
+- 是否像本人。
+- 是否变脸。
+- 是否男女混脸。
+- 是否年龄变化过大。
+- 动作是否自然。
+- 表情是否怪异。
+- 是否有不合适姿势。
+- 是否适合公开案例。