docs: 修回被误压空格的 ':=' 写法;契约与文档去真实 MariaDB 版本串

- contracts/websocket-keypoints.md(三库同源):把上一轮空格清理误伤的
  'var x:= ...' 修回 'var x := ...',保持文档内代码样例可读
- contracts/rest-api.yaml(三库同源):'如 MariaDB 10.11.19' -> '如 MariaDB 10.5+'
- DSH.md / tasks/001:去掉真实部署实例版本号,改为'由部署方确认'的表述
- 重新打包 v0.2.0

验证:契约 6 项一致(三库 md5 相同)、30 条路由一致。
This commit is contained in:
2026-09-15 21:33:20 +08:00
parent 8c2f2afaea
commit 5de0891706
4 changed files with 10 additions and 9 deletions
+1 -1
View File
@@ -27,7 +27,7 @@ opendance-web ←── 本仓库
|--|--|
| 后端 | NestJS 11 |
| ORM | TypeORM 0.3 |
| 数据库 | **现有 MySQL 兼容实例**(当前部署为 MariaDB 10.11.19),mysql2 驱动 |
| 数据库 | **现有 MySQL 兼容实例**(含 MariaDB 10.5+,由部署方提供),mysql2 驱动 |
| 管理前端 | React 18 + Vite + TypeScript |
| 3D 预览 | three.js + @pixiv/three-vrm |
| 多格式解析 | BVH / VMD 内置纯 TS 解析器;FBX/glTF 走可选外部 Assimp |
+1 -1
View File
@@ -664,7 +664,7 @@ components:
type: object
properties:
connected: { type: boolean }
server: { type: string, description: '如 MariaDB 10.11.19' }
server: { type: string, description: '如 MariaDB 10.5+' }
database: { type: string }
migrationsPending: { type: integer }
+5 -5
View File
@@ -52,13 +52,13 @@ ws://<windows-host>:8765/pose
```gdscript
func decode(buf: PackedByteArray) -> Dictionary:
assert(buf.size() == 239)
var magic:= buf.decode_u16(0)
var magic := buf.decode_u16(0)
assert(magic == 0x4F44 and buf.decode_u8(2) == 1)
var flags:= buf.decode_u8(3)
var frame_id:= buf.decode_u32(4)
var pts:= []
var flags := buf.decode_u8(3)
var frame_id := buf.decode_u32(4)
var pts := []
for i in 33:
var o:= 8 + i * 7
var o := 8 + i * 7
pts.append({
"x": float(buf.decode_s16(o)) / 32767.0,
"y": float(buf.decode_s16(o + 2)) / 32767.0,
+3 -2
View File
@@ -52,9 +52,10 @@ curl -s http://localhost:3000/health
```
期望:`status=ok`、`database.connected=true`、`database.server` 形如
`10.11.19-MariaDB-...`。
`<版本>-MariaDB-<发行版>`(版本字符串由实例返回)。
> **环境差异记录**:文档假设 MySQL 8.x,实际部署实例为 **MariaDB 10.11.19**。
> **环境差异记录**:文档假设 MySQL 8.x;实际部署方提供的是 **MariaDB 10.5+** 兼容实例
> (具体版本由部署方确认,本项目不使用 MySQL 8 专有语法)。
> 已确认 TypeORM `mysql` 驱动(mysql2)兼容,SQL 限制在两者共同子集内,
> 详见 `contracts/database.md`。