项目整机拼装与资源文件上传
This commit is contained in:
@@ -338,6 +338,12 @@ interface ProjectView {
|
||||
coverUrl: string | null;
|
||||
urdfMainUrl: string | null;
|
||||
urdfBaseUrl: string | null;
|
||||
modelGlbUrl: string | null;
|
||||
modelPartsBaseUrl: string | null;
|
||||
modelPartsFiles?: ResourceFileView[]; // 详情返回;列表省略
|
||||
assemblyJsonUrl: string | null;
|
||||
walkingResourcesBaseUrl: string | null;
|
||||
walkingResourcesFiles?: ResourceFileView[]; // 详情返回;列表省略
|
||||
projectType: string;
|
||||
owner: { userCode: string | null; nickname: string };
|
||||
repoStatus: RepoStatus;
|
||||
@@ -362,6 +368,12 @@ interface ManagedProjectView {
|
||||
deleted: boolean;
|
||||
}
|
||||
|
||||
interface ResourceFileView {
|
||||
relativePath: string;
|
||||
sizeBytes: number;
|
||||
url: string;
|
||||
}
|
||||
|
||||
interface TypeView {
|
||||
code: string;
|
||||
name: string;
|
||||
@@ -433,6 +445,12 @@ interface TypeView {
|
||||
"coverUrl": null,
|
||||
"urdfMainUrl": null,
|
||||
"urdfBaseUrl": null,
|
||||
"modelGlbUrl": null,
|
||||
"modelPartsBaseUrl": null,
|
||||
"modelPartsFiles": [],
|
||||
"assemblyJsonUrl": null,
|
||||
"walkingResourcesBaseUrl": null,
|
||||
"walkingResourcesFiles": [],
|
||||
"projectType": "WHEELED",
|
||||
"owner": { "userCode": "c3d4e5f6a7b8", "nickname": "社区官方" },
|
||||
"repoStatus": "READY",
|
||||
@@ -804,6 +822,78 @@ async function uploadUrdf(projectCode: string, selected: SelectedFile[]): Promis
|
||||
|
||||
任一文件失败时不要确认绑定;保留失败状态并检查上传结果。签名过期可重新申请完整批次;同批次已成功文件禁止覆盖,不要无条件重传。移除 URDF 只清除绑定,不物理删除已上传对象。
|
||||
|
||||
### 8.3 整机、零件、拼装步骤及行走资源
|
||||
|
||||
四类资源均为选填,只允许管理员上传。先创建项目取得 `projectCode`,项目 READY 后分别上传;每类只保存一个当前绑定,替换后立即反映到社区详情,不需要重新发布。
|
||||
|
||||
| resourceType | 页面入口 | 规则 | 详情字段 |
|
||||
| --- | --- | --- | --- |
|
||||
| `model-glb` | 选择整机 GLB | 恰好一个 `.glb`,提交文件名 | `modelGlbUrl` |
|
||||
| `model-parts` | 选择零件文件夹 | 只上传 `.glb`,保留子目录 | `modelPartsBaseUrl`、`modelPartsFiles` |
|
||||
| `assembly-json` | 高级导入 JSON | 恰好一个 `.json`,提交文件名,不解析业务内容 | `assemblyJsonUrl` |
|
||||
| `walking-resources` | 选择行走资源文件夹 | 保留全部文件与子目录,不要求 `robot.json` | `walkingResourcesBaseUrl`、`walkingResourcesFiles` |
|
||||
|
||||
扩展名忽略大小写,保留原文件名大小写。文件夹相对路径须去掉所选文件夹最外层名称,不能包含绝对路径、空段、`.`、`..`、反斜杠、控制字符、冒号或 `.git` 目录。不同目录可以有同名文件,同一相对路径不能重复。空文件夹不提交;未绑定或清除时地址为 null,详情清单为 `[]`。目录基础地址以 `/` 结尾,文件 URL 已按路径段编码,不要整体二次编码。
|
||||
|
||||
应用不设置文件数量、目录总量和单文件业务配额,不套用 URDF 的 50 MiB / 200 MiB / 500 文件限制;OSS 表单直传自身单文件上限为 5 GB(5368709120 字节),超出返回 413 `RESOURCE_FILE_TOO_LARGE`。新资源的签名和确认接口不套用普通 JSON 正文配额;反向代理需允许实际清单大小。零字节文件可以上传,本次仅核验扩展名、路径及对象大小。
|
||||
|
||||
| 方法和路径 | 请求 | 返回 data |
|
||||
| --- | --- | --- |
|
||||
| `POST /admin-api/projects/{projectCode}/resources/{resourceType}/signature` | `{ files: ResourceFile[] }` | `ResourceUploadSignature` |
|
||||
| `PUT /admin-api/projects/{projectCode}/resources/{resourceType}` | `{ batchCode, files: ResourceFile[] }` | 更新后的平铺 `ProjectView` |
|
||||
| `DELETE /admin-api/projects/{projectCode}/resources/{resourceType}` | 无 body | `null`,幂等清除绑定 |
|
||||
|
||||
```ts
|
||||
type ResourceType = 'model-glb' | 'model-parts' | 'assembly-json' | 'walking-resources';
|
||||
interface ResourceFile { relativePath: string; sizeBytes: number }
|
||||
interface ResourceUploadSignature {
|
||||
batchCode: string;
|
||||
uploadUrl: string;
|
||||
expiresAt: UtcDateTime;
|
||||
files: { relativePath: string; objectKey: string; formFields: Record<string, string> }[];
|
||||
}
|
||||
|
||||
function selectResourceFiles(type: ResourceType, chosen: FileList): SelectedFile[] {
|
||||
return Array.from(chosen).map(file => {
|
||||
const path = file.webkitRelativePath;
|
||||
const relativePath = path ? path.slice(path.indexOf('/') + 1) : file.name;
|
||||
return { file, relativePath };
|
||||
}).filter(item => type !== 'model-parts' || /\.glb$/i.test(item.relativePath));
|
||||
}
|
||||
|
||||
async function uploadProjectResource(
|
||||
projectCode: string, type: ResourceType, selected: SelectedFile[],
|
||||
): Promise<ProjectView> {
|
||||
if (!selected.length) throw new Error('请选择资源文件');
|
||||
const files: ResourceFile[] = selected.map(item => ({
|
||||
relativePath: item.relativePath, sizeBytes: item.file.size,
|
||||
}));
|
||||
const endpoint = `/projects/${projectCode}/resources/${type}`;
|
||||
const signature = await requestAdmin<ResourceUploadSignature>(`${endpoint}/signature`, {
|
||||
method: 'POST', body: { files },
|
||||
});
|
||||
const byPath = new Map(selected.map(item => [item.relativePath, item.file]));
|
||||
for (const item of signature.files) {
|
||||
const file = byPath.get(item.relativePath);
|
||||
if (!file) throw new Error(`缺少本地文件:${item.relativePath}`);
|
||||
await uploadOssFile(signature.uploadUrl, item.formFields, file);
|
||||
}
|
||||
return requestAdmin<ProjectView>(endpoint, {
|
||||
method: 'PUT', body: { batchCode: signature.batchCode, files },
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
前端把各文件的 `formFields` 原样加入 FormData,最后追加 `file`,直接 POST OSS,不携带平台 Authorization、不手动设置 multipart Content-Type。OSS 成功为 HTTP 200、空响应体。示例复用第 7 节的 `uploadOssFile`;实际大批量上传可使用有并发上限的队列。
|
||||
|
||||
每次签名生成新批次,有效期默认 1 小时,可通过 `PROJECT_RESOURCE_SIGNATURE_VALIDITY` 配置,例如 `2h`;签名响应禁止缓存。对象键为 `{环境根目录}/project-resources/{projectCode}/{resourceType}/{batchCode}/{relativePath}`,test 根目录为 `vibemake_dev`,prod 为 `vibemake`。Policy 精确绑定对象键、声明大小、MIME、成功状态,并禁止覆盖。全部上传成功后,提交原批次及原文件清单;后端逐文件 HEAD 核验存在和大小,再一次性更新当前绑定。
|
||||
|
||||
上传失败、取消或确认失败均保留原绑定;签名过期重新申请批次。确认缺文件返回 400 `RESOURCE_FILE_MISSING`,大小不符返回 400 `RESOURCE_FILE_SIZE_MISMATCH`;路径、扩展名、类型或清单错误返回 400,项目不存在或已删除返回 404,仓库未 READY 返回 409,OSS 未开启返回 503。清除绑定在 OSS 关闭时仍可执行。
|
||||
|
||||
Fork 只复制这四类资源的八个数据库字段,复用原 OSS 对象,不对这些资源执行 HEAD、复制或下载,OSS 暂不可用也不影响该继承过程。副本与来源后续各自替换绑定,替换、清除和删除项目均保留旧对象。已有 URDF 仍使用原独立复制规则。
|
||||
|
||||
部署前执行 [项目资源增量 SQL](admin-database.md#已有数据库增加四类项目资源字段)。RAM 用户对当前环境 `project-resources/*` 增加 `oss:PutObject` 和 `oss:GetObject` 权限;配置资源公开读取或公开 CDN,真实前端 Origin 的 OSS CORS 允许 POST、GET、HEAD,允许 Content-Type。无需为新增资源开通复制或删除权限,应用不修改 Bucket 配置。
|
||||
|
||||
## 9. GitHub 项目迁移
|
||||
|
||||
页面流程:**输入地址 → 预检 → 补充信息、可选上传封面和 URDF → 创建任务并绑定资源 → 查看阶段 → 检查文件 → 手动发布**。封面和 URDF 均可在迁移表单内完成,无需等迁移后再去项目列表寻找项目。
|
||||
@@ -1096,6 +1186,7 @@ requestId 同时可能出现在响应头 `X-Request-Id`。错误提示可附“
|
||||
| 文件编辑/上传 | 取得当前 SHA → 提交或上传 → 保存新 SHA → 刷新目录和历史 |
|
||||
| 发布确认 | 读取并检查当前 main 文件 → PUT publication → 刷新详情 |
|
||||
| URDF 设置 | 选目录 → signature → 逐文件 OSS 上传 → PUT urdf → 刷新详情 |
|
||||
| 整机、零件、拼装步骤、行走资源 | 创建项目并等待 READY → resources/{resourceType}/signature → 逐文件 OSS 上传 → PUT resources/{resourceType} |
|
||||
| 迁移创建 | preview → 补充表单 → 可选封面及迁移 URDF 签名/OSS 上传 → POST project-imports(含 urdf)→ 进入任务页 |
|
||||
| 迁移任务 | 详情轮询 → SUCCEEDED 后检查项目 → 明确发布 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user