项目整机拼装与资源文件上传

This commit is contained in:
lxp
2026-10-28 17:49:54 +08:00
parent 4e7d11d586
commit 0dd39eb23d
32 changed files with 964 additions and 29 deletions
+33 -1
View File
@@ -6,7 +6,39 @@
## 项目字段收敛
project 只新增 moderation_reason(管理员下架原因)和 repo_write_status(跨进程写入状态)两个字段。下架直接使用现有 publish_status=BLOCKED,不再增加独立治理状态。GitHub来源标识、地址、默认分支和许可证属于迁移任务,统一放在 project_import_task;第一版只支持GitHub,不存平台类型,也不额外区分用户创建与后台创建。
治理相关字段为 moderation_reason(管理员下架原因)和 repo_write_status(跨进程写入状态)。下架直接使用现有 publish_status=BLOCKED,不再增加独立治理状态。GitHub来源标识、地址、默认分支和许可证属于迁移任务,统一放在 project_import_task;第一版只支持GitHub,不存平台类型,也不额外区分用户创建与后台创建。
## 已有数据库增加四类项目资源字段
在已完成原有部署的数据库中手工执行以下 SQL,再升级社区端、管理端和导入工具。新建数据库的 `database.md` 建表语句已包含这些字段,不要重复执行。
```sql
ALTER TABLE project
ADD COLUMN model_glb_object_key VARCHAR(512)
CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL DEFAULT ''
COMMENT '整机GLB环境相对路径,不含域名和环境根目录',
ADD COLUMN model_glb_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0
COMMENT '整机GLB文件大小,单位字节',
ADD COLUMN model_parts_prefix VARCHAR(512)
CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL DEFAULT ''
COMMENT '零件模型环境相对目录,以斜杠开头和结尾',
ADD COLUMN model_parts_files JSON NOT NULL DEFAULT (JSON_ARRAY())
COMMENT '零件GLB文件清单,包含relativePath和sizeBytes',
ADD COLUMN assembly_json_object_key VARCHAR(512)
CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL DEFAULT ''
COMMENT '拼装步骤JSON环境相对路径,不含域名和环境根目录',
ADD COLUMN assembly_json_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0
COMMENT '拼装步骤JSON文件大小,单位字节',
ADD COLUMN walking_resources_prefix VARCHAR(512)
CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL DEFAULT ''
COMMENT '行走资源环境相对目录,以斜杠开头和结尾',
ADD COLUMN walking_resources_files JSON NOT NULL DEFAULT (JSON_ARRAY())
COMMENT '行走资源文件清单,包含relativePath和sizeBytes';
```
路径为未编码的 `/project-resources/{projectCode}/{resourceType}/{batchCode}/{relativePath}`,不含域名和环境根目录。目录字段以 `/` 结尾,清单内路径相对于对应目录。未绑定或清除后路径为 `''`、大小为 `0`、清单为 `[]`。
Fork 直接复制这八个字段并复用原 OSS 对象,因此副本保存的路径可以包含源项目编码。读取不校验路径属于当前项目;新上传和确认只能使用当前项目的目录。替换、清除和删除项目均保留 OSS 对象,避免破坏其他副本的引用。后续如增加资源清理任务,必须检查所有项目的共享引用。
## 已有数据库增加字段