上传表单/处理对齐说明（基于反编译版 & 数据库字段）

目标：按反编译文件彻底还原各素材类型的字段、必填项、文件要求、预览/展示图规则，并与 materials 表字段一致，避免落库不匹配。

数据库字段（materials）

关键：productModel(SPU)、categoryName(店铺)、sceneName(场景)、platformName、productCategoryName、materialType、renderer、previewUrl
文件：zipFileName（视频/音频存 S3 URL；其它存文件名）、zipFilePath（本地路径）、zipFileSize
展示：displayImages 数组
视频：videoSourceUrl、videoPreview540Url、videoPreviewClipUrl、videoCoverUrl、videoProcessingStatus、videoDuration、transcodeLastError、transcodeAttempts
分片：uploadId

3D场景、详情页、材质、模特、实拍图片、买家秀图片、小红书种草、主图模版、SKU模版、主图视频、安装视频、种草视频、音乐、C4D模型、标准饰品、标准模型、品牌VI灵感、矢量文件。

通用 SPU：大多数类型必填 productModel。批量（音乐/视频/3D场景/买家秀/小红书/品牌VI）每条都要 SPU。
店铺/场景自动填充：材质/音乐/种草视频 → categoryName=通用，sceneName=通用。
预览图必填（反编译逻辑）：
- 必填：除以下类型外都要预览图。
- 例外（可不填）：详情页、模特、实拍图片、买家秀图片、小红书种草、主图模版、SKU模版、品牌VI灵感、主图视频、安装视频、种草视频、音乐、(3D场景批量且各文件已带预览)。
- 3D场景批量：每个文件必须有预览图。
展示图/切片：
- 详情页：必须展示图（displayImages）。
- 模特/实拍/买家秀/小红书/主图模版/SKU模版/品牌VI：必须展示图或 PDF。展示图做压缩/切片。
- 买家秀批量：每批 ≥ 8 张图。
- 品牌VI：支持 PDF，自动从文件名生成 SPU 可手改。
主文件必填：
- 除模特/标准模型外，其余类型需要主文件。
- 音乐、种草视频：文件必传。
批量上传：
- 音乐(I[])、视频(D[])、3D场景(M[])、买家秀(A[])、小红书(L[])、品牌VI(O[]) 支持多批；每批含 productModel、文件/展示图。

视频/音频：直传 S3，zipFileName 保存 S3 URL，同时写 videoSourceUrl（视频类型），videoProcessingStatus='pending'。
其他：存本地 zipFilePath，文件名写 zipFileName。
展示图：displayImages 数组；预览图 previewUrl。
品牌VI PDF：走本地存储（zipFilePath/zipFileName/zipFileSize），允许展示图或 PDF。

图片压缩：预览/展示图压缩 maxWidth≈800, maxHeight≈2000, quality≈0.85，上传前压缩。
展示图切片：多图类型（模特/买家秀等）切片上传；买家秀批次 ≥ 8 图。
分片上传：主文件 >5MB 走 chunkUpload → /api/materials/upload/complete → 携 metadata 正式提交。
校验提示：SPU/预览/展示图/文件必填、买家秀≥8张、品牌VI PDF、标准模型需品类、通用店铺/场景填充等。

/api/materials/upload：
- 支持从分片合并文件 existingFilePath 读取。
- 视频/音频：S3 上传，写 videoSourceUrl、zipFileName=S3 URL，videoProcessingStatus='pending'。
- 品牌VI/PDF：存本地，写 zipFilePath/zipFileName/zipFileSize。
- 展示图数组写入 displayImages；预览图写 previewUrl。
分片阈值：反编译约 5MB（可按此恢复）。