contracts/database.md - 数据库契约 v0.1.0

环境

类型：MySQL 兼容实例（外部提供，含 MariaDB 10.5+），TypeORM 使用 mysql driver(mysql2)连接，SQL 语法限制在 MySQL 5.7 / MariaDB 10.5+ 共同子集内，不使用 MySQL 8 专有语法（窗口函数 CTE 递归除外）。
数据库名：由部署方提供，通过 DB_NAME 注入(本文档示例统一用 opendance)
字符集：utf8mb4 / utf8mb4_general_ci（沿用现有实例默认排序规则）
迁移工具：TypeORM migration, 不使用 DB_SYNCHRONIZE

host / port / user / password 一律通过环境变量注入，不入库、不入仓。

DB_HOST=<数据库主机>
DB_PORT=3306
DB_USER=opendance_app
DB_PASS=<数据库口令>
DB_NAME=opendance
DB_SYNCHRONIZE=false
DB_LOGGING=false

所有表名使用 snake_case，复数形式(songs / motions / models)
主键统一为 BIGINT AUTO_INCREMENT，字段名 id
时间字段统一 DATETIME, created_at / updated_at, updated_at 由应用层维护
软删除统一使用 deleted_at DATETIME NULL(@DeleteDateColumn)
布尔字段使用 TINYINT(1)
来源（出处）字段为 5 元组，任何资产入库必须齐备： source_type / source_name / source_url / license / author
不使用 DB_SYNCHRONIZE，所有表结构变更走 migration
每个 migration 必须可逆（提供 down 方法）
迁移文件名格式：<timestamp>-<kebab-name>.ts

迁移	变更
`AddModelConversionFields`	`models` 增加 `source_asset_id BIGINT NULL`（上传的压缩包，用于溯源）与 `conversion_note VARCHAR(500) NULL`(转换说明，见 model-formats.md 1.1)
`AddModelStats`	`models` 增加 `stats TEXT NULL`（模型分析结果：面数、骨骼树、humanoid 覆盖、可驱动性），供审核界面展示

draft ──submit──▶ pending ──approve──▶ published
                     │
                     └──reject──▶ rejected ──submit──▶ pending

列	类型	说明
`id`	bigint PK
`name`	varchar(200)	场景名称
`glb_asset_id`	bigint NULL	场景 GLB（以 GLB 为主，不转 VRM）
`thumbnail_asset_id`	bigint NULL	缩略图
`config`	mediumtext NULL	`SceneConfig` JSON（物理 / 环境 / 出生点 / 相机）
`stats`	mediumtext NULL	场景 GLB 分析结果（复用模型检查器）
`file_size` / `file_sha256` / `conversion_note`	-	与 models 同义
`source_type` `source_name` `source_url` `license` `author`	-	来源五元组（必填）
`status`	varchar(16)	上传一律 `pending`，审核后 `published`/`rejected`
`created_at` `updated_at` `deleted_at`	datetime	软删除