添加拼装动画状态

This commit is contained in:
2026-11-19 18:46:56 +08:00
parent 6b96ca1eb0
commit f404da334f
21 changed files with 1496 additions and 27 deletions
+17
View File
@@ -326,6 +326,7 @@ interface UserView {
```ts
type RepoStatus = 'CREATING' | 'READY' | 'FAILED';
type PublishStatus = 'UNPUBLISHED' | 'PUBLISHED' | 'BLOCKED';
type AssemblyAnimationStatus = 'UNPROCESSED' | 'IN_PROGRESS' | 'COMPLETED';
interface ProjectInput {
name: string;
@@ -369,6 +370,7 @@ interface ProjectView {
interface ManagedProjectView {
project: ProjectView;
assemblyAnimationStatus: AssemblyAnimationStatus;
moderationStatus: 'NORMAL' | 'BLOCKED';
moderationReason: string | null;
deleted: boolean;
@@ -394,6 +396,7 @@ interface TypeView {
| publishStatus | `UNPUBLISHED` 未发布;`PUBLISHED` 已发布;`BLOCKED` 管理员下架 |
| publishedCommitSha | 社区当前已发布的文件版本,**不是工作区最新版本** |
| moderationStatus / moderationReason | 后台治理状态及下架原因;BLOCKED 与 publishStatus=BLOCKED 对应 |
| assemblyAnimationStatus | 拼装动画制作状态:`UNPROCESSED` 未处理(默认)、`IN_PROGRESS` 进行中、`COMPLETED` 已完成;位于 ManagedProjectView 顶层,仅管理端返回 |
| sourceProjectCode / sourceCommitSha | 从社区内部 Fork 的来源;没有则为 null |
| sourceRepositoryUrl / sourceLicense | 在线迁移项目的外部来源和许可证;没有或未取得则为 null |
| urdfMainUrl / urdfBaseUrl | 已绑定的 URDF 主文件和资源基地址;未绑定则为 null |
@@ -438,6 +441,7 @@ interface TypeView {
| publishStatus | UNPUBLISHED / PUBLISHED / BLOCKED |
| repoStatus | CREATING / READY / FAILED |
| moderationStatus | NORMAL / BLOCKED |
| assemblyAnimationStatus | UNPROCESSED / IN_PROGRESS / COMPLETED;省略时查询全部,非法值返回 400 |
| sort | 可选:`CREATED_AT_DESC`(默认)、`PUBLISHED_AT_DESC`、`RESOURCES_FIRST`;其他值返回 400 |
结果只包含未删除项目。排序模式:
@@ -489,11 +493,24 @@ interface TypeView {
"updatedAt": "2026-10-20T02:30:00"
},
"moderationStatus": "NORMAL",
"assemblyAnimationStatus": "UNPROCESSED",
"moderationReason": null,
"deleted": false
}
```
#### 拼装动画制作状态
`PUT /admin-api/projects/{projectCode}/assembly-animation-status` → `ManagedProjectView`。
```json
{ "status": "IN_PROGRESS" }
```
`status` 必填且仅接受 `UNPROCESSED`、`IN_PROGRESS`、`COMPLETED`,可以在三种状态之间自由切换。新建及历史项目默认未处理。此接口仅限管理员,按项目编码更新数据库状态及系统更新时间,返回可直接用于回显的完整管理详情;不存在或已删除项目返回 404。仓库未就绪时也可设置状态,不触发资源上传、绑定或发布。重复设置同一状态不更新系统时间;并发操作由项目锁串行处理,以最后一次成功写入为准。
前端在「装配与仿真」页的「刷新资源绑定」右侧显示状态下拉框,选择后自动保存,保存期间禁用重复操作,失败时保留原显示值并提示错误。项目列表显示同一字段,筛选携带 `assemblyAnimationStatus`;清空或重置时省略此参数,查询、分页和发布时间倒序沿用原有规则。
### 5.4 创建、编辑、删除
`POST /admin-api/projects` → `ProjectView`,body: