Initial AI manga platform

2026-06-15 17:45:28 +08:00
commit 7a8191650f
267 changed files with 105987 additions and 0 deletions
@@ -0,0 +1,358 @@
+# 11_订单支付_额度_成本控制设计
+
+## 1. 文档目标
+
+本文档定义系统 B 的订单、支付、额度、退款、修改计费和 AI 成本控制。由于系统使用高质量模型，成本控制是商业落地的核心。
+
+## 2. 核心原则
+
+1. 高成本正式生成前必须支付或冻结额度。
+2. 预览生成必须限制次数。
+3. 失败重试不重复扣用户额度。
+4. 用户主动大改需要重新计费。
+5. 每个任务必须记录预估成本和实际成本。
+6. 后台必须能看到项目毛利。
+
+## 3. 套餐计费
+
+### 3.1 标准图集版
+
+包含：
+
+- 1 个主题
+- 1 个世界
+- 3 个场景
+- 6-12 张图
+- 1 次小改
+
+### 3.2 短视频版
+
+包含：
+
+- 1-3 个世界
+- 30-60 秒视频
+- 12-24 张图
+- 字幕、BGM
+- 1 次小改
+
+### 3.3 多世界纪念片
+
+包含：
+
+- 5-10 个世界
+- 1-3 分钟视频
+- 25-60 张图
+- 旁白、字幕、片头片尾
+- 2 次修改
+
+### 3.4 高端定制版
+
+按人工报价，支持：
+
+- 自由主题
+- 专属文案
+- 高级动态
+- 人工精修
+- 多轮修改
+
+### 3.5 V3 动态写真版
+
+包含：
+
+- 1-3 个世界
+- 6-18 张写真图
+- 3-8 个轻动态片段
+- 眨眼、微笑、背景动效、花瓣光效等轻动作
+- 30-60 秒视频
+- 不默认启用完整真人短剧动作
+
+### 3.6 V3 AI 真人动态视频版
+
+包含：
+
+- 1-3 个世界
+- 4-10 个真人动态镜头
+- 每个镜头 3-6 秒
+- 默认 720P
+- 人物表情、转头、牵手、行礼、慢走等动作
+- 片段质检
+- 真实视频生成前必须二次确认成本
+
+### 3.7 V3 高端真人纪念片
+
+按人工报价，支持：
+
+- 多世界
+- 多场景
+- 关键镜头真人动态
+- 口型 / 誓言 / 旁白
+- 人工精修
+- 人工审核
+- 多轮修改
+
+## 4. 订单状态
+
+```text
+pending：待支付
+paid：已支付
+cancelled：已取消
+failed：支付失败
+refunding：退款中
+refunded：已退款
+closed：已关闭
+```
+
+## 5. 支付流程
+
+```text
+用户选择套餐
+→ 创建订单
+→ 用户支付
+→ 支付回调
+→ 订单标记 paid
+→ 项目标记 payment_paid
+→ 开放预览/正式生成
+```
+
+## 6. 预览策略
+
+推荐策略：
+
+```text
+登录用户每天可免费生成 1 次低清水印预览。
+超过免费次数需支付小额预览费或先购买套餐。
+正式高清生成必须支付。
+```
+
+预览规则：
+
+- 加水印
+- 低清或中清
+- 数量少
+- 不提供无水印下载
+- 预览图仅用于确认人物和风格
+
+## 7. 额度模型
+
+每个订单生成以下额度：
+
+```text
+preview_quota：预览次数
+image_quota：正式图片生成额度
+video_quota：视频生成额度
+revision_quota：修改次数
+advanced_video_quota：高级动态镜头额度
+```
+
+## 8. 额度扣减规则
+
+### 8.1 正常成功
+
+任务成功后扣减对应额度。
+
+### 8.2 AI 失败
+
+如果 Provider 失败、系统错误、超时导致未产生成果，不扣用户额度。
+
+### 8.3 用户不满意
+
+如果成果符合套餐说明但用户主观不满意，按修改次数或重新生成次数扣减。
+
+### 8.4 大改
+
+以下属于大改，需重新计费：
+
+- 更换整体风格
+- 更换全部世界观
+- 重建人物档案
+- 整条视频重做
+- 超出套餐范围的场景替换
+
+## 9. 成本记录
+
+每个任务记录：
+
+```text
+task_id
+project_id
+provider_id
+task_type
+estimated_cost_cent
+actual_cost_cent
+input_size
+output_size
+latency_ms
+status
+```
+
+每个项目汇总：
+
+```text
+订单收入
+AI 文本成本
+AI 图片成本
+AI 视频成本
+TTS 成本
+存储成本估算
+人工成本估算
+总成本
+毛利
+```
+
+## 10. 成本控制策略
+
+### 10.1 预览和正式分离
+
+预览阶段：
+
+- 少量生成
+- 水印
+- 低清
+- 限制次数
+
+正式阶段：
+
+- 高质量
+- 无水印
+- 完整生成
+
+### 10.2 重试限制
+
+每个任务默认：
+
+```text
+max_retry = 2 或 3
+```
+
+多次失败后转人工，不无限重试。
+
+### 10.3 高级动态限制
+
+AI 视频成本高，应按套餐限制：
+
+- 标准图集：不支持
+- 短视频：可选 0-1 个
+- 多世界纪念片：2-5 个
+- 高端定制：按报价
+
+### 10.5 V3 真人动态视频成本规则
+
+真人动态视频成本按以下维度估算：
+
+```text
+视频片段秒数
+视频 Provider
+模型
+分辨率
+候选数量
+重试次数
+口型任务
+人工审核
+```
+
+后台配置项：
+
+```text
+max_video_seconds_per_project
+max_clip_duration
+max_clip_candidates
+max_video_retry_per_clip
+default_video_resolution
+max_cost_per_project
+max_cost_per_call
+daily_cost_limit
+```
+
+示例：
+
+```text
+AI 真人动态视频 40 秒：
+8 个镜头
+每个 5 秒
+每镜头最多 1 次重试
+默认 720P
+```
+
+真实视频 Provider 必须满足：
+
+- 默认禁用。
+- 运营手动启用。
+- 填写 `price_per_second` 或 `price_per_clip`。
+- 设置单次成本上限和当日成本上限。
+- 用户端展示预计费用。
+- 用户确认后才执行。
+- Provider 失败不回落 mock 假成功。
+
+### 10.6 V3 片段级成本展示
+
+后台和用户端应展示：
+
+- 每个片段预计成本。
+- 每个片段实际成本。
+- 每个项目视频总成本。
+- 每个用户累计成本。
+- 每个 Provider 今日成本。
+- 重试造成的额外成本。
+
+### 10.4 复用素材
+
+同一项目中可复用：
+
+- 人物锚点图
+- 同一世界服装锚点
+- 背景图
+- 片头片尾模板
+
+## 11. 退款规则
+
+建议规则：
+
+| 阶段 | 退款建议 |
+|---|---|
+| 未开始生成 | 可全额退款 |
+| 已生成预览 | 可部分退款 |
+| 正式生成中 | 一般不退款，可协商 |
+| 已交付成品 | 不支持退款，支持套餐内修改 |
+| 系统失败无法交付 | 可退款或补偿额度 |
+
+## 12. 修改计费规则
+
+### 小改
+
+套餐内可用修改次数。
+
+### 中改
+
+消耗 1 次修改，必要时消耗部分生成额度。
+
+### 大改
+
+重新报价或重新下单。
+
+## 13. 后台成本看板
+
+指标：
+
+- 今日收入
+- 今日 AI 成本
+- 今日毛利
+- 项目平均成本
+- 图片平均成本
+- 视频平均成本
+- Provider 成本排行
+- 高成本项目提醒
+
+## 14. 成本告警
+
+触发条件：
+
+- 单项目成本超过套餐价格的设定比例
+- Provider 日成本超过阈值
+- 失败重试成本异常
+- 用户短时间大量生成预览
+
+处理：
+
+- 暂停项目自动生成
+- 通知管理员
+- 转人工审核