zijunchiang
7a74f598be
部署 v0.7.3 后，/health 的 scenes.error 给出决定性线索： No metadata for "Scene" was found. src/entities/index.ts 的 ENTITIES 一直漏了 Scene： export const ENTITIES = [Asset, Song, Motion, CharacterModel, ReviewRecord]; TypeORM 只按 ENTITIES 注册 metadata，漏注册的后果极其隐蔽： - 启动完全正常（DI 可解析、/health 正常、migrationsPending 0）； - 迁移也正常（AddScenes 已执行，表其实是建好的）； - 但第一次查 Scene 就抛 No metadata，于是 /api/scenes、/api/catalog/export、 /api/catalog/version、/api/reviews?status=pending 全部 500 → 客户端拉不到任何目录、管理端待审列表打不开。 即：此前"数据库缺 scenes 表"的判断也是错的（v0.7.3 的降级与诊断脚本因此仍然值得保留 —— 它们把"场景坏了"限制成"场景不可用"，而不是整站不可用）。 修复：ENTITIES 加入 Scene 并导出。 新增静态防线 test/entities-registry.spec.ts（4 项）：扫描 src/entities/*.entity.ts 里的 @Entity() 类并逐一与 ENTITIES 对账（漏一个即失败）、检查无重复/无多余、核对 AddScenes 迁移文件存在。已做反向验证：把 Scene 从 ENTITIES 移除后该测试立刻失败。 这类缺陷既过得了 tsc、也过得了启动冒烟（应用能启动），只能靠静态核对兜住。 文档：README.md/.txt 增加 v0.7.4 修订说明；tasks/015-scene-management.md 增 「缺陷修复记录四」；开发文档 §4.12 补「新增实体必须加入 ENTITIES」的硬性要求。 验证：npm run verify 通过（23 文件 / 285 项测试 + 契约/路由/版本一致 + 启动冒烟）； 发布产物 opendance-web-v0.7.4.tar.gz sha256 e680c23fc382b6c39498608ea0154f8f80e9e6b5c13518f0f88095644ce88fe1。
103 lines
3.8 KiB
YAML
103 lines
3.8 KiB
YAML
project: opendance-web-server
|
||
version: 0.7.4
|
||
repository: opendance-web
|
||
default_branch: main
|
||
contracts_version:
|
||
rest-api: 0.5.0
|
||
websocket-keypoints: 0.2.0
|
||
data-models: 0.7.0
|
||
skeleton-topology: 0.2.0
|
||
model-formats: 0.5.0
|
||
database: 0.4.0
|
||
|
||
# 契约变更流程（文档 7.2）：
|
||
# 任何跨端契约变更必须先在本项目修改 contracts/ 并提升版本，
|
||
# 再在 opendance-windows / opendance-android 创建适配任务。
|
||
|
||
database:
|
||
# 使用现有实例，本项目不部署、不管理 MySQL
|
||
managed_by: external
|
||
engine: MySQL 兼容（含 MariaDB 10.5+）
|
||
name: opendance
|
||
charset: utf8mb4
|
||
migrations: TypeORM migration
|
||
synchronize: forbidden
|
||
|
||
tasks:
|
||
- id: T-WEB-001
|
||
file: tasks/001-scaffold.md
|
||
scope: NestJS 骨架 + 连接现有 MySQL
|
||
status: done
|
||
- id: T-WEB-002
|
||
file: tasks/002-db-migration.md
|
||
scope: TypeORM 迁移生成 opendance 表结构
|
||
status: done
|
||
- id: T-WEB-003
|
||
file: tasks/003-song-crud.md
|
||
scope: /api/songs CRUD
|
||
status: done
|
||
- id: T-WEB-004
|
||
file: tasks/004-motion-upload.md
|
||
scope: 动作数据上传（BVH / VMD / FBX / glTF / keypoints）+ 来源字段
|
||
status: done
|
||
- id: T-WEB-005
|
||
file: tasks/005-model-upload.md
|
||
scope: 模型上传（GLB/VRM 直接导入 + PMX/FBX 转换 + .zip 自动搜索）+ 自动分析/缩略图 + 上传即待审
|
||
status: done
|
||
- id: T-WEB-006
|
||
file: tasks/006-keypoint-preprocess.md
|
||
scope: BVH / VMD / FBX -> 关键点序列预处理
|
||
status: done
|
||
- id: T-WEB-007
|
||
file: tasks/007-upload-review.md
|
||
scope: 上传审核流程
|
||
status: done
|
||
- id: T-WEB-008
|
||
file: tasks/008-admin-ui-songs.md
|
||
scope: 歌曲管理界面
|
||
status: done
|
||
- id: T-WEB-009
|
||
file: tasks/009-admin-ui-models.md
|
||
scope: 模型管理界面 + 来源展示
|
||
status: done
|
||
- id: T-WEB-010
|
||
file: tasks/010-deploy.md
|
||
scope: 部署脚本（双端口：软件 API 3000 + 管理端 3001，不部署 MySQL）+ deploy/.env 初始化引导（init-env.sh，HOST 默认 0.0.0.0）
|
||
status: done
|
||
- id: T-WEB-011
|
||
file: tasks/011-version-display.md
|
||
scope: 管理端左下角展示当前版本号（唯一来源 package.json）
|
||
status: done
|
||
- id: T-WEB-012
|
||
file: tasks/012-vrm-first.md
|
||
scope: 模型主力格式全面转为 VRM（非 VRM 入库标记不可用，不进已发布目录）
|
||
status: done
|
||
- id: T-WEB-013
|
||
file: tasks/013-bone-rebinding.md
|
||
scope: 动作内部标准（33 点）+ 模型骨骼按名重绑定（含 MMD/中文名）
|
||
status: done
|
||
- id: T-WEB-014
|
||
file: tasks/014-motion-preview.md
|
||
scope: 动作管理预览（离线骨架缩略图 + 管理端 3D 回放）
|
||
status: done
|
||
- id: T-WEB-015
|
||
file: tasks/015-scene-management.md
|
||
scope: 场景管理（GLB + 重力/风/物理参数，服务端只存参数）
|
||
status: done
|
||
- id: T-WEB-016
|
||
file: tasks/016-websocket-contract-020.md
|
||
scope: 契约 websocket-keypoints 0.2.0（保活 / 设备去重 / 状态机，与 T-AND-011 对齐）
|
||
status: done
|
||
|
||
deliverable:
|
||
artifact: opendance-web-v0.7.4.tar.gz
|
||
packaging: Linux 业务服务（系统服务托管，双端口：软件 API + 管理端，不含 MySQL、不含反向代理、不使用 Docker）
|
||
includes:
|
||
- web-server/ # NestJS 源码 + 构建产物（含 BVH / VMD 内置解析、ZIP 读取与模型压缩包转换）
|
||
- admin/ # React 管理端构建产物
|
||
- deploy/ # install.sh / init-env.sh / systemd / openrc / initd / ctl.sh / .env.example（PORT、ADMIN_PORT、HOST）
|
||
- deploy/proxy/ # 反向代理说明（nginx / IIS，仅供参考不部署）
|
||
- contracts/ # 当前版本契约快照（rest-api 0.5.0 / websocket-keypoints 0.2.0 / data-models 0.7.0 / database 0.4.0）
|
||
- THIRD_PARTY.md # 开源声明
|
||
- README.txt # 使用说明
|