docs(web): 任务说明、DSH 约束与交付文档

2026-09-14 19:00:55 +08:00
parent 5a8b77b0a4
commit b9215d4190
16 changed files with 1461 additions and 0 deletions
@@ -0,0 +1,71 @@
+project: opendance-web-server
+version: 0.1.0
+repository: opendance-web
+default_branch: main
+contracts_version: 0.1.0
+
+# 契约变更流程（文档 §7.2）：
+#   任何跨端契约变更必须先在本项目修改 contracts/ 并提升版本，
+#   再在 opendance-windows / opendance-android 创建适配任务。
+
+database:
+  # 使用现有实例，本项目不部署、不管理 MySQL
+  managed_by: external
+  engine: MySQL 兼容（当前部署为 MariaDB 10.11.19）
+  name: dpendance
+  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: 动作数据上传 + 来源字段
+    status: done
+  - id: T-WEB-005
+    file: tasks/005-model-upload.md
+    scope: 模型上传 + VRM 优先 + 来源字段
+    status: done
+  - id: T-WEB-006
+    file: tasks/006-keypoint-preprocess.md
+    scope: BVH/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: 部署脚本（不部署 MySQL）
+    status: done
+
+deliverable:
+  artifact: opendance-web-v0.1.0.tar.gz
+  packaging: Docker Compose（不含 MySQL）
+  includes:
+    - web-server/          # NestJS 源码 + 构建产物
+    - admin/               # React 管理端构建产物
+    - deploy/              # docker-compose.yml / install.sh / .env.example
+    - contracts/           # 当前版本契约快照
+    - THIRD_PARTY.md       # 开源声明
+    - README.txt           # 使用说明