ai/docs/system_b/05_数据库表结构设计.md

# 05_数据库表结构设计

## 1. 文档目标

本文档定义系统 B 的 MySQL 核心表结构。字段类型为建议值，实际开发时可根据 ORM 选型调整。

## 2. 命名原则

- 表名使用复数：`users`, `projects`
- 主键统一为 `id BIGINT` 或 UUID，根据实现决定
- 时间字段统一：`created_at`, `updated_at`, `deleted_at`
- 状态字段统一使用字符串枚举
- 金额使用整数分：`amount_cent`
- JSON 配置使用 `JSON` 类型

## 3. users 用户表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 用户 ID |
| nickname | VARCHAR(100) | 昵称 |
| phone | VARCHAR(30) | 手机号 |
| email | VARCHAR(100) | 邮箱 |
| wechat_openid | VARCHAR(100) | 微信 openid |
| avatar_asset_id | BIGINT | 头像资源 |
| status | VARCHAR(30) | active/disabled |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

索引：

- UNIQUE(phone)
- UNIQUE(wechat_openid)

## 4. admin_users 后台用户表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 管理员 ID |
| username | VARCHAR(100) | 用户名 |
| password_hash | VARCHAR(255) | 密码哈希 |
| role_id | BIGINT | 角色 ID |
| status | VARCHAR(30) | 状态 |
| created_at | DATETIME | 创建时间 |

## 5. roles 角色表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 角色 ID |
| name | VARCHAR(100) | 角色名称 |
| code | VARCHAR(100) | 角色编码 |
| permissions | JSON | 权限列表 |
| status | VARCHAR(30) | 状态 |

## 6. projects 项目表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 项目 ID |
| user_id | BIGINT | 用户 ID |
| title | VARCHAR(200) | 项目标题 |
| life_theme_id | BIGINT | 人生主题 |
| package_id | BIGINT | 套餐 |
| style_id | BIGINT | 视觉风格 |
| output_type | VARCHAR(30) | image/video/both |
| status | VARCHAR(50) | 项目状态 |
| payment_status | VARCHAR(50) | 支付状态 |
| total_duration | INT | 视频秒数 |
| image_count | INT | 图片数量 |
| cover_asset_id | BIGINT | 封面 |
| video_asset_id | BIGINT | 视频 |
| allow_public_case | BOOLEAN | 是否允许公开案例 |
| custom_info | JSON | 用户定制信息 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |
| completed_at | DATETIME | 完成时间 |

索引：

- INDEX(user_id, status)
- INDEX(created_at)
- INDEX(life_theme_id)

## 7. orders 订单表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 订单 ID |
| user_id | BIGINT | 用户 ID |
| project_id | BIGINT | 项目 ID |
| package_id | BIGINT | 套餐 ID |
| amount_cent | INT | 金额，单位分 |
| pay_status | VARCHAR(30) | pending/paid/failed/cancelled |
| pay_method | VARCHAR(30) | wechat/alipay/balance/manual |
| transaction_id | VARCHAR(100) | 第三方交易号 |
| refund_status | VARCHAR(30) | none/refunding/refunded |
| created_at | DATETIME | 创建时间 |
| paid_at | DATETIME | 支付时间 |

## 8. packages 套餐表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 套餐 ID |
| code | VARCHAR(100) | 编码 |
| name | VARCHAR(100) | 名称 |
| price_cent | INT | 价格 |
| world_min | INT | 最少世界数 |
| world_max | INT | 最多世界数 |
| scene_min | INT | 最少场景数 |
| scene_max | INT | 最多场景数 |
| image_min | INT | 最少图片数 |
| image_max | INT | 最多图片数 |
| video_duration_min | INT | 最短视频秒数 |
| video_duration_max | INT | 最长视频秒数 |
| revision_count | INT | 修改次数 |
| allow_video | BOOLEAN | 是否视频 |
| allow_voice | BOOLEAN | 是否旁白 |
| allow_advanced_video | BOOLEAN | 是否高级动态 |
| manual_review_required | BOOLEAN | 是否人工审核 |
| config_json | JSON | 扩展配置 |
| status | VARCHAR(30) | 状态 |

## 9. life_themes 人生主题表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 主题 ID |
| code | VARCHAR(100) | 编码 |
| name | VARCHAR(100) | 名称 |
| description | TEXT | 说明 |
| cover_asset_id | BIGINT | 封面 |
| person_schema | JSON | 人物结构规则 |
| default_copy_moods | JSON | 默认文案风格 |
| status | VARCHAR(30) | 状态 |
| sort_order | INT | 排序 |

person_schema 示例：

```json
{
  "type": "couple",
  "roles": ["person_a", "person_b"],
  "min_photos_each": 3,
  "max_photos_each": 8,
  "minor_sensitive": false
}
```

## 10. style_templates 风格模板表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 风格 ID |
| code | VARCHAR(100) | 编码 |
| name | VARCHAR(100) | 名称 |
| description | TEXT | 说明 |
| cover_asset_id | BIGINT | 封面 |
| prompt_style | TEXT | 风格 Prompt |
| negative_rules | TEXT | 禁止项 |
| supported_theme_ids | JSON | 支持主题 |
| status | VARCHAR(30) | 状态 |

## 11. world_templates 世界观模板表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 世界 ID |
| code | VARCHAR(100) | 编码 |
| name | VARCHAR(100) | 名称 |
| category | VARCHAR(100) | 分类 |
| description | TEXT | 说明 |
| cover_asset_id | BIGINT | 封面 |
| prompt_base | TEXT | 世界基础 Prompt |
| costume_rules | TEXT | 服装规则 |
| scene_rules | TEXT | 场景规则 |
| style_rules | TEXT | 风格规则 |
| negative_rules | TEXT | 禁止项 |
| supported_theme_ids | JSON | 支持主题 |
| supported_style_ids | JSON | 支持风格 |
| is_premium | BOOLEAN | 高级模板 |
| status | VARCHAR(30) | 状态 |
| sort_order | INT | 排序 |

## 12. scene_templates 场景模板表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 场景 ID |
| world_id | BIGINT | 所属世界 |
| code | VARCHAR(100) | 编码 |
| name | VARCHAR(100) | 名称 |
| description | TEXT | 说明 |
| cover_asset_id | BIGINT | 封面 |
| scene_prompt | TEXT | 场景 Prompt |
| composition_rules | TEXT | 构图规则 |
| lighting_rules | TEXT | 光影规则 |
| effect_type | VARCHAR(100) | 特效类型 |
| recommended_shot_count | INT | 推荐镜头数 |
| is_premium | BOOLEAN | 高级场景 |
| status | VARCHAR(30) | 状态 |
| sort_order | INT | 排序 |

## 13. shot_templates 镜头模板表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 镜头模板 ID |
| scene_id | BIGINT | 所属场景 |
| code | VARCHAR(100) | 编码 |
| name | VARCHAR(100) | 名称 |
| shot_type | VARCHAR(100) | 镜头类型 |
| camera_angle | VARCHAR(100) | 视角 |
| composition | TEXT | 构图 |
| prompt_rule | TEXT | Prompt 规则 |
| duration | INT | 默认秒数 |
| effect_type | VARCHAR(100) | 运镜/特效 |
| status | VARCHAR(30) | 状态 |
| sort_order | INT | 排序 |

## 14. project_worlds 项目世界关系表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | ID |
| project_id | BIGINT | 项目 ID |
| world_id | BIGINT | 世界 ID |
| sort_order | INT | 顺序 |

## 15. project_scenes 项目场景关系表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | ID |
| project_id | BIGINT | 项目 ID |
| world_id | BIGINT | 世界 ID |
| scene_id | BIGINT | 场景 ID |
| sort_order | INT | 顺序 |

## 16. person_profiles 人物档案表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 人物档案 ID |
| project_id | BIGINT | 项目 ID |
| role | VARCHAR(50) | person_a/person_b/child 等 |
| name | VARCHAR(100) | 名称 |
| gender_label | VARCHAR(50) | 性别标签，可选 |
| age_group | VARCHAR(50) | 年龄段 |
| appearance_summary | TEXT | 外貌摘要 |
| reference_asset_ids | JSON | 参考照片 |
| anchor_asset_id | BIGINT | 锚点图 |
| quality_score | DECIMAL(5,2) | 质量分 |
| status | VARCHAR(30) | 状态 |
| created_at | DATETIME | 创建时间 |

V3 真人动态视频增强字段：

| 字段 | 类型 | 说明 |
|---|---|---|
| identity_lock_status | VARCHAR(50) | unlocked/generating_anchor/waiting_user_confirm/locked/rejected |
| face_consistency_score | DECIMAL(5,2) | 本人相似度评分 |
| primary_reference_asset_id | BIGINT | 主参考照片 |
| approved_anchor_asset_id | BIGINT | 用户确认的身份锚点 |
| age_preserve_rule | VARCHAR(100) | 年龄保持规则：strict/soft/allow_younger 等 |
| beautify_level | VARCHAR(50) | 美化强度：none/light/medium/high |
| style_transform_level | VARCHAR(50) | 风格转换强度：realistic/semi_real/comic |
| privacy_level | VARCHAR(50) | 隐私等级：normal/sensitive/minor |

## 17. assets 素材表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 素材 ID |
| user_id | BIGINT | 用户 ID |
| project_id | BIGINT | 项目 ID |
| asset_type | VARCHAR(50) | 类型 |
| file_path | VARCHAR(500) | 存储路径 |
| file_url | VARCHAR(500) | 访问 URL，可为空 |
| mime_type | VARCHAR(100) | MIME |
| width | INT | 宽 |
| height | INT | 高 |
| duration | INT | 音视频秒数 |
| size | BIGINT | 文件大小 |
| hash | VARCHAR(100) | 文件哈希 |
| visibility | VARCHAR(30) | private/public/case |
| status | VARCHAR(30) | 状态 |
| created_at | DATETIME | 创建时间 |

asset_type：

```text
upload_photo
preview_image
final_image
audio
subtitle
video
cover
case_asset
music
```

## 18. shot_plans 镜头计划表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 镜头计划 ID |
| project_id | BIGINT | 项目 ID |
| world_id | BIGINT | 世界 ID |
| scene_id | BIGINT | 场景 ID |
| shot_template_id | BIGINT | 镜头模板 ID |
| title | VARCHAR(200) | 标题 |
| description | TEXT | 画面描述 |
| prompt_text | TEXT | 正向 Prompt |
| negative_prompt | TEXT | 负向 Prompt |
| duration | INT | 秒数 |
| output_asset_id | BIGINT | 生成图 |
| sort_order | INT | 顺序 |
| status | VARCHAR(30) | 状态 |

## 19. render_tasks 生成任务表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 任务 ID |
| project_id | BIGINT | 项目 ID |
| task_type | VARCHAR(100) | 任务类型 |
| provider_id | BIGINT | Provider |
| status | VARCHAR(30) | 状态 |
| input_json | JSON | 输入 |
| input_hash | VARCHAR(100) | 幂等哈希 |
| output_asset_id | BIGINT | 输出素材 |
| provider_request_id | VARCHAR(200) | 三方请求 ID |
| retry_count | INT | 重试次数 |
| max_retry | INT | 最大重试 |
| cost_estimate_cent | INT | 预估成本 |
| cost_actual_cent | INT | 实际成本 |
| error_code | VARCHAR(100) | 错误码 |
| error_message | TEXT | 错误信息 |
| created_at | DATETIME | 创建时间 |
| started_at | DATETIME | 开始时间 |
| finished_at | DATETIME | 完成时间 |

索引：

- UNIQUE(project_id, task_type, input_hash)
- INDEX(status, created_at)

## 20. provider_configs Provider 配置表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | Provider ID |
| provider_type | VARCHAR(50) | text/image/video/voice/moderation |
| provider_name | VARCHAR(100) | 名称 |
| model_name | VARCHAR(100) | 模型名 |
| api_base | VARCHAR(500) | API Base |
| api_key_ref | VARCHAR(100) | 密钥引用，不直接存明文 |
| priority | INT | 优先级 |
| quality_level | VARCHAR(50) | quality/speed/cost |
| rate_limit_json | JSON | 限流配置 |
| cost_rule_json | JSON | 成本规则 |
| fallback_provider_id | BIGINT | 备用 Provider |
| status | VARCHAR(30) | 状态 |

## 21. provider_logs Provider 日志表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 日志 ID |
| provider_id | BIGINT | Provider |
| project_id | BIGINT | 项目 |
| task_id | BIGINT | 任务 |
| request_payload | JSON | 请求，可脱敏 |
| response_payload | JSON | 响应，可脱敏 |
| status | VARCHAR(30) | 状态 |
| cost_cent | INT | 成本 |
| latency_ms | INT | 耗时 |
| created_at | DATETIME | 创建时间 |

## 22. revision_requests 修改申请表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 修改 ID |
| project_id | BIGINT | 项目 ID |
| user_id | BIGINT | 用户 ID |
| revision_type | VARCHAR(30) | small/medium/major |
| request_text | TEXT | 修改内容 |
| status | VARCHAR(30) | 状态 |
| remaining_count_before | INT | 修改前剩余次数 |
| handled_by | BIGINT | 处理人 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## 23. authorizations 授权记录表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 授权 ID |
| user_id | BIGINT | 用户 ID |
| project_id | BIGINT | 项目 ID |
| authorization_type | VARCHAR(50) | 类型 |
| content | TEXT | 授权文本 |
| ip | VARCHAR(100) | IP |
| user_agent | TEXT | UA |
| confirmed_at | DATETIME | 确认时间 |

类型：

```text
photo_usage
public_case
minor_guardian
privacy_policy
terms
```

## 24. case_showcases 案例表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 案例 ID |
| project_id | BIGINT | 来源项目 |
| title | VARCHAR(200) | 标题 |
| cover_asset_id | BIGINT | 封面 |
| video_asset_id | BIGINT | 视频 |
| theme_id | BIGINT | 主题 |
| style_id | BIGINT | 风格 |
| world_ids | JSON | 世界列表 |
| sort_order | INT | 排序 |
| is_featured | BOOLEAN | 首页推荐 |
| status | VARCHAR(30) | 状态 |
| authorization_id | BIGINT | 授权记录 |

## 25. music_assets 音乐素材表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 音乐 ID |
| name | VARCHAR(200) | 名称 |
| mood | VARCHAR(100) | 情绪 |
| asset_id | BIGINT | 音频资源 |
| duration | INT | 秒数 |
| license_type | VARCHAR(100) | 授权类型 |
| source | VARCHAR(200) | 来源 |
| usage_scope | TEXT | 使用范围 |
| status | VARCHAR(30) | 状态 |

## 26. system_configs 系统配置表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 配置 ID |
| config_key | VARCHAR(100) | Key |
| config_value | JSON | Value |
| description | TEXT | 说明 |
| updated_at | DATETIME | 更新时间 |

## 27. audit_logs 操作日志表

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 日志 ID |
| actor_type | VARCHAR(30) | user/admin/system |
| actor_id | BIGINT | 操作人 |
| action | VARCHAR(100) | 动作 |
| target_type | VARCHAR(100) | 目标类型 |
| target_id | BIGINT | 目标 ID |
| detail_json | JSON | 详情 |
| ip | VARCHAR(100) | IP |
| created_at | DATETIME | 创建时间 |

## 28. V3 identity_anchors 身份锚点表

用于保存真人身份锚点，确保后续图片和视频尽量像本人。

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 锚点 ID |
| project_id | BIGINT | 项目 ID |
| person_id | BIGINT | 人物档案 ID |
| anchor_asset_id | BIGINT | 锚点素材 |
| anchor_type | VARCHAR(80) | real_photo_anchor/semi_realistic_anchor/korean_comic_anchor/ancient_costume_anchor/future_style_anchor |
| quality_score | DECIMAL(5,2) | 锚点质量分 |
| face_consistency_score | DECIMAL(5,2) | 与本人相似度 |
| approved_by_user | BOOLEAN | 用户是否确认 |
| approved_by_admin | BOOLEAN | 后台是否确认 |
| status | VARCHAR(50) | generating/waiting_confirm/approved/rejected |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## 29. V3 motion_templates 动作模板表

用于控制动态写真和真人视频片段的动作范围。

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 动作模板 ID |
| name | VARCHAR(100) | 动作名称 |
| motion_type | VARCHAR(100) | smile/blink/turn_head/walk_forward/hold_hands 等 |
| description | TEXT | 说明 |
| supported_themes | JSON | 支持人生主题 |
| supported_worlds | JSON | 支持世界模板 |
| supported_styles | JSON | 支持视觉风格 |
| prompt_rule | TEXT | 动作 Prompt 规则 |
| duration | INT | 默认片段秒数 |
| difficulty_level | VARCHAR(50) | easy/medium/hard |
| cost_level | VARCHAR(50) | low/medium/high |
| status | VARCHAR(30) | 状态 |
| sort_order | INT | 排序 |

推荐动作：

```text
smile
blink
turn_head
walk_forward
hold_hands
look_at_each_other
bow_ceremony
lift_veil
hug
wave
stand_still_cinematic
slow_camera_push
```

## 30. V3 video_clips 视频片段表

每个 AI 动态视频片段单独存储，便于重试、替换、质检和成本追踪。

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 视频片段 ID |
| project_id | BIGINT | 项目 ID |
| scene_id | BIGINT | 场景 ID |
| shot_id | BIGINT | 镜头 ID |
| person_ids | JSON | 涉及人物 ID |
| provider_id | BIGINT | Provider 配置 ID |
| input_asset_id | BIGINT | 输入关键帧 / 参考图 |
| output_asset_id | BIGINT | 输出视频素材 |
| prompt_text | TEXT | 视频 Prompt |
| duration | INT | 秒数 |
| resolution | VARCHAR(50) | 720p/1080p |
| motion_type | VARCHAR(100) | 动作类型 |
| lipsync_enabled | BOOLEAN | 是否启用口型 |
| status | VARCHAR(50) | pending/running/generated/failed/manual_required |
| retry_count | INT | 重试次数 |
| cost_actual | DECIMAL(12,4) | 实际成本 |
| quality_score | DECIMAL(5,2) | 质检分 |
| quality_issues | JSON | 质检问题 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |

## 31. V3 lipsync_tasks 口型任务表

口型任务可选，不应阻塞基础交付；失败时可回退旁白字幕版本。

| 字段 | 类型 | 说明 |
|---|---|---|
| id | BIGINT PK | 任务 ID |
| project_id | BIGINT | 项目 ID |
| video_clip_id | BIGINT | 视频片段 ID |
| audio_asset_id | BIGINT | 输入音频 |
| output_asset_id | BIGINT | 口型后视频 |
| provider_id | BIGINT | LipSync Provider |
| status | VARCHAR(50) | pending/running/success/failed/manual_required |
| cost_actual | DECIMAL(12,4) | 实际成本 |
| retry_count | INT | 重试次数 |
| error_code | VARCHAR(100) | 错误码 |
| error_message | TEXT | 错误信息 |
| created_at | DATETIME | 创建时间 |
| updated_at | DATETIME | 更新时间 |