Initial AI manga platform

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

@@ -0,0 +1,769 @@
+# 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
+```