ai/docs/system_b/03_功能清单_页面清单_状态流转设计.md

# 03_功能清单_页面清单_状态流转设计

## 1. 文档目标

本文档定义系统 B 的功能边界、用户端页面、后台页面、状态流转、权限边界和每个页面的关键操作。

## 2. 角色定义

| 角色 | 说明 |
|---|---|
| 游客 | 未登录用户，可浏览首页、案例、套餐 |
| 普通用户 | 已登录用户，可创建项目、上传照片、生成作品 |
| 运营人员 | 管理案例、模板、审核作品、处理修改 |
| 管理员 | 管理用户、订单、Provider、系统配置 |
| 超级管理员 | 拥有全部权限，包括密钥配置、数据删除、系统设置 |

## 3. 用户端页面清单

### 3.1 首页

功能：展示产品价值、案例、套餐、开始制作入口。

模块：

- Banner
- 热门案例
- 热门主题
- 热门世界观
- 制作流程
- 套餐对比
- 用户评价
- FAQ

按钮：

- 查看案例
- 用同款制作
- 选择主题
- 查看套餐
- 开始制作
- 联系客服

登录要求：不需要。

### 3.2 案例列表页

筛选条件：

- 人生主题
- 世界观
- 视觉风格
- 图集 / 视频
- 最新 / 热门

注意：只展示已授权公开案例。

### 3.3 案例详情页

展示：

- 案例视频
- 案例图集
- 使用主题
- 使用世界观
- 使用风格
- 套餐推荐

按钮：

- 播放视频
- 查看图集
- 用同款制作
- 收藏案例

### 3.4 登录/注册页

第一阶段支持：

- 手机号验证码
- 微信授权

后续可加：

- 邮箱注册
- 账号密码

### 3.5 创建项目页

字段：

- 项目名称
- 人生主题
- 作品用途
- 输出类型

作品用途：

- 自己留念
- 送礼物
- 婚礼现场播放
- 社交平台发布
- 父母纪念

### 3.6 主题选择页

字段：

- 主题名称
- 主题封面
- 主题说明
- 适合人群
- 案例数量
- 是否推荐

第一阶段主题：

- 结婚纪念
- 恋爱纪念
- 银婚金婚
- 情侣写真
- 个人形象定制

### 3.7 套餐选择页

字段：

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

按钮：

- 选择套餐
- 查看套餐详情
- 下一步

### 3.8 风格选择页

风格：

- 韩漫风
- 半写实写真风
- 国风插画风
- 电影写实风

字段：

- 风格预览图
- 适合主题
- 适合世界
- 是否高级风格

### 3.9 世界观选择页

模式：

- 单世界
- 多世界
- 自由排序
- 同款案例带入

套餐限制：

| 套餐 | 世界数量 |
|---|---|
| 标准图集 | 1 个 |
| 短视频 | 1-3 个 |
| 多世界纪念片 | 5-10 个 |
| 高端定制 | 按订单配置 |

### 3.10 场景选择页

每个世界下选择场景。

字段：

- 场景名称
- 场景预览图
- 推荐镜头数
- 是否支持视频动态
- 是否高级场景

### 3.11 照片上传页

双人主题：

- 人物 A：3-8 张
- 人物 B：3-8 张
- 双人合照：1-5 张，可选

单人主题：

- 本人照片：3-10 张

家庭主题：

- 每位成员 2-5 张
- 家庭合照 1-5 张

禁止上传：

- 模糊照片
- 戴墨镜/口罩
- 过度美颜
- 逆光严重
- 脸部遮挡
- 多人混乱

### 3.12 授权确认页

必须勾选：

- 我确认拥有上传照片的合法使用权
- 我确认已获得照片中人物授权
- 我授权平台为本次项目生成图片和视频
- 我知道作品默认不公开展示
- 如涉及未成年人，我确认我是监护人或已获得监护人授权

### 3.13 照片质检页

检测：

- 清晰度
- 人脸完整度
- 光照
- 遮挡
- 角度
- 多人混入
- 重复图片
- 角色归属
- 过度美颜

状态：

- pass：合格
- warning：可用但有风险
- fail：必须替换

### 3.14 定制信息页

字段：

- 人物姓名
- 关系类型
- 纪念日期
- 文案风格
- 一句话誓言
- 是否显示名字
- 是否显示日期
- 特别要求
- 是否允许公开展示

### 3.15 创作方案预览页

展示：

- 作品标题
- 主题
- 风格
- 世界顺序
- 场景顺序
- 镜头数量
- 图片数量
- 预计视频时长
- 旁白草稿
- 字幕草稿
- 预计消耗额度

按钮：

- 确认方案
- 修改世界
- 修改场景
- 修改文案
- 重新生成方案
- 取消项目

### 3.16 支付/额度确认页

字段：

- 套餐价格
- 优惠金额
- 需支付金额
- 预览额度
- 正式生成额度
- 修改次数

按钮：

- 立即支付
- 使用余额
- 取消订单

### 3.17 预览确认页

展示：

- 低清水印预览图
- 关键镜头
- 人物像不像反馈入口
- 风格满意度反馈入口

按钮：

- 满意，进入正式生成
- 不满意，重新生成预览
- 修改模板
- 联系客服

### 3.18 生成进度页

进度节点：

```text
项目已创建
照片检测完成
人物档案建立中
方案生成中
等待方案确认
预览生成中
等待预览确认
正式图生成中
图片质检中
音频生成中
字幕生成中
视频合成中
人工审核中
等待用户确认
已完成
```

### 3.19 成品确认页

展示：

- 成品视频
- 成品图集
- 封面图
- 有字幕版本
- 无字幕版本
- 下载入口
- 剩余修改次数

按钮：

- 确认完成
- 申请修改
- 下载视频
- 下载图片
- 删除作品
- 授权公开为案例

### 3.20 修改申请页

修改类型：

- 小改：名字、日期、字幕、音乐、片尾文案
- 中改：替换个别图片、重做 1-2 个场景
- 大改：换整体风格、换全部世界、整条重做

规则：大改必须重新计费。

### 3.21 我的项目页

字段：

- 项目名称
- 缩略图
- 主题
- 套餐
- 状态
- 创建时间
- 是否可下载

### 3.22 用户中心页

功能：

- 个人信息
- 我的项目
- 我的订单
- 我的收藏
- 隐私设置
- 删除作品申请
- 联系客服
- 退出登录

## 4. 后台页面清单

后台使用 Geeker-Admin 二开。

### 4.1 仪表盘

指标：

- 今日订单数
- 今日支付金额
- 今日生成项目数
- 今日完成项目数
- 失败任务数
- 待审核项目数
- 待处理修改数
- AI 调用成本
- 存储占用
- 热门主题排行
- 热门世界排行

### 4.2 用户管理

操作：

- 查看用户
- 禁用用户
- 恢复用户
- 查看用户项目
- 查看用户订单

### 4.3 项目管理

操作：

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

### 4.4 订单管理

操作：

- 查看订单
- 标记支付
- 退款记录
- 修改套餐
- 查看关联项目

### 4.5 模板管理

子模块：

- 人生主题管理
- 世界观模板管理
- 场景模板管理
- 镜头模板管理
- 视觉风格管理
- 文案模板管理
- 音乐模板管理
- 视频模板管理
- 套餐管理

### 4.6 任务管理

操作：

- 查看输入
- 查看输出
- 重试
- 终止
- 跳过
- 标记人工处理
- 查看错误日志

### 4.7 AI Provider 管理

管理：

- TextProvider
- ImageProvider
- VideoProvider
- VoiceProvider
- ModerationProvider
- FaceCheckProvider
- QualityCheckProvider

### 4.8 案例管理

操作：

- 从项目生成案例
- 设置首页推荐
- 上架/下架
- 排序
- 查看授权记录

### 4.9 修改申请管理

操作：

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

### 4.10 隐私与授权管理

管理：

- 用户授权记录
- 公开案例授权
- 未成年人授权确认
- 删除申请
- 数据导出申请
- 素材清理记录

## 5. 项目状态流转

### 5.1 Project 状态枚举

```text
draft
template_selecting
photo_uploading
authorization_pending
photo_checking
photo_rejected
person_profiling
info_filling
plan_generating
waiting_plan_confirm
payment_pending
payment_paid
preview_generating
waiting_preview_confirm
final_generating
image_qc
audio_generating
subtitle_generating
video_rendering
final_qc
manual_review
waiting_user_confirm
revision_requested
revising
completed
cancelled
failed
archived
```

### 5.2 主流程

```text
draft
→ template_selecting
→ photo_uploading
→ authorization_pending
→ photo_checking
→ person_profiling
→ info_filling
→ plan_generating
→ waiting_plan_confirm
→ payment_pending
→ payment_paid
→ preview_generating
→ waiting_preview_confirm
→ final_generating
→ image_qc
→ audio_generating
→ subtitle_generating
→ video_rendering
→ final_qc
→ manual_review
→ waiting_user_confirm
→ completed
→ archived
```

### 5.3 异常分支

照片失败：

```text
photo_checking → photo_rejected → photo_uploading → photo_checking
```

支付失败：

```text
payment_pending → payment_failed → payment_pending / cancelled
```

预览不满意：

```text
waiting_preview_confirm → template_selecting / info_filling / preview_generating
```

成品修改：

```text
waiting_user_confirm → revision_requested → revising → final_generating / video_rendering / manual_review → waiting_user_confirm
```

## 6. 任务状态

```text
pending
running
success
failed
retrying
cancelled
manual_required
```

任务类型：

```text
photo_check
person_profile
plan_generate
prompt_generate
preview_image
final_image
image_qc
video_clip_generate
audio_generate
subtitle_generate
video_render
final_qc
manual_review
```

## 7. V3 真人动态视频页面增量

### 7.1 输出模式选择

创建项目时必须让用户明确选择输出模式：

```text
photo_album：高清写真图集
image_video：图片纪念视频
motion_portrait：动态写真视频
real_video：AI 真人动态视频
premium_film：高端真人纪念片
```

页面必须提示：

- AI 真人动态视频生成时间更长。
- AI 真人动态视频费用更高。
- 真实视频可能需要人工审核和多次重试。
- 不保证每个动作完全自然。
- 真实视频失败时不会用 mock 假成功。

### 7.2 V3 照片上传要求

真人动态视频比图集更依赖参考照片，上传页应提高要求：

```text
单人：正脸清晰照 5-10 张，半身照 2-5 张，不同表情 2-5 张。
情侣/夫妻：男方 5-10 张，女方 5-10 张，双人合照 2-5 张。
家庭：每位成员 3-8 张，家庭合照 2-5 张。
```

禁止：

- 过度美颜
- 脸部遮挡
- 多人混乱
- 低清晰度
- 强滤镜
- 明显年龄不符照片

### 7.3 身份锚点确认页

新增页面或步骤：

- 展示每个人物的主参考照。
- 展示 AI 生成的身份锚点图。
- 显示人脸一致性评分。
- 用户选择“像本人 / 不像本人 / 需要重生”。
- 未确认身份锚点，不允许进入正式动态视频生成。

### 7.4 视频片段页

AI 真人动态视频项目新增片段管理：

- 镜头列表。
- 每个镜头动作模板。
- 输入关键帧。
- 输出视频片段。
- Provider、分辨率、时长、预计成本。
- 生成中 / 成功 / 失败 / 待质检状态。
- 片段预览。
- 重试、替换、转人工。

### 7.5 口型任务页，可选

如果项目启用口型：

- 选择需要口型的片段。
- 绑定音频资产。
- 生成 lip-sync 任务。
- 失败时可回退为旁白字幕版本。

## 8. V3 后台页面增量

后台项目详情页新增：

- 人物身份档案。
- 身份锚点图和用户确认状态。
- 人脸一致性评分。
- 动作模板。
- 视频片段列表。
- 口型任务列表。
- 视频 Provider 和成本。
- 片段质检结果。
- 片段重试和替换入口。

后台审核页新增：

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

## 9. V3 状态流转增量

AI 真人动态视频完整状态建议：

```text
photo_checking
→ person_profiling
→ identity_anchor_generating
→ waiting_identity_confirm
→ plan_generating
→ payment_paid
→ keyframe_generating
→ video_clip_estimating
→ video_clip_generating
→ video_clip_qc
→ audio_generating
→ lipsync_generating，可选
→ subtitle_generating
→ video_rendering
→ final_qc
→ manual_review
→ waiting_user_confirm
→ completed
```

新增任务类型：

```text
identity_anchor_generate
face_consistency_check
keyframe_generate
motion_portrait_generate
real_video_clip_generate
video_clip_qc
lipsync_generate
```