flnxi-Wu/docs/素材类型模板配置记录.md

素材类型模板配置记录

本文档记录新版本内置素材模板（3DMAX、PSD、AI 工作流、视频、模特、其他）的字段配置，用于数据迁移和模板初始化。

📋 素材类型列表（新版本）

• 3DMAX
• PSD
• AI 工作流
• 视频
• 模特
• 其他

🔧 标准字段配置

所有素材类型通用字段

字段键名	字段标签	类型	必填	布局宽度	首页筛选	可搜索	说明
productModel	型号	text	✅	full	❌	✅	SPU型号，材质类型时作为材质名称
categoryName	使用店铺	select	❌	full	✅	✅	下拉选择门店，初始提供“默认店铺”
sceneName	场景类别	select	❌	full	✅	✅	材质类型时使用默认值"通用"
platformName	平台分类	text	❌	half	❌	✅	可选字段
brandName	品牌名称	text	❌	half	❌	✅	可选字段
seriesName	系列/产品线	text	❌	half	❌	✅	可选字段
skuCode	SKU编码	text	❌	half	❌	✅	可选字段
materialTexture	材质/工艺	text	❌	half	❌	✅	可选字段
renderer	渲染器	select	❌	full	❌	✅	仅3DMAX使用，默认值"CR"，下拉可选
renderTime	渲染耗时	text	❌	half	❌	❌	可选字段
imageResolution	输出分辨率	text	❌	half	❌	❌	可选字段
colorMode	颜色模式	text	❌	half	❌	❌	可选字段
authorName	作者	text	❌	half	❌	✅	自动从用户信息获取

说明：所有 select 类型字段在初始化时都会带一个默认选项（例如“默认店铺”“默认场景”“CR”），以便在没有手动配置分类时也能选择。

📦 各素材类型推荐字段配置

1. 3DMAX 素材模板

模板名称：3DMAX 素材模板（老版本简化字段）
描述：只保留 3DMAX 上传时真正需要填写的字段。

字段列表（按顺序）：

1. productModel - SPU型号（必填，text，full）
2. categoryName - 使用店铺（必填，select，full，下拉）
3. sceneName - 场景类别（必填，select，full，下拉）
4. renderer - 渲染器（必填，select，full，下拉，默认值：CR）

特殊要求：

• 必须上传素材文件（.max 或压缩包）
• 必须上传预览图

---

2. PSD 素材模板

模板名称：PSD 素材模板（老版本简化字段）
描述：只保留店铺、场景以及 SPU 型号。

字段列表（按顺序）：

1. productModel - SPU型号（必填，text，full）
2. categoryName - 使用店铺（必填，select，full，下拉）
3. sceneName - 场景类别（必填，select，full，下拉）

特殊要求：

• 必须上传素材文件（.psd / .tif / .tiff / .psb）
• 必须上传展示图片（displayImage）
• 必须上传预览图

---

3. AI 工作流模板

字段列表（按顺序）：

1. productModel - SPU型号（必填，text，full）
2. categoryName - 使用店铺（必填，select，full，下拉）
3. sceneName - 场景类别（必填，select，full，下拉）

特殊要求：

• 必须上传源文件（.ai / .svg / 压缩包）
• 必须上传预览图

---

4. 视频 素材模板

字段列表（按顺序）：

1. productModel - SPU型号（必填，text，full）
2. categoryName - 使用店铺（必填，select，full，下拉）
3. sceneName - 场景类别（必填，select，full，下拉）

特殊要求：

• 必须上传视频文件（.mp4 / .avi / .mov / .wmv / .flv / .mkv / .webm）
• 必须上传预览图（视频封面）

---

5. 模特 / 实拍 素材模板

字段列表（按顺序）：

1. productModel - SPU型号（必填，text，full）
2. categoryName - 使用店铺（必填，select，full，下拉）
3. sceneName - 场景类别（必填，select，full，下拉）

特殊要求：

• 预览图与其他模板共用“预览图片”区域，至少上传一张
• 素材文件可选（可以不传）

---

6. 其他 素材模板

字段列表（按顺序）：

1. productModel - SPU型号（必填，text，full）
2. categoryName - 使用店铺（必填，select，full，下拉）
3. sceneName - 场景类别（必填，select，full，下拉）

特殊要求：

• 必须上传素材文件（压缩包）
• 必须上传预览图

---

🔄 数据迁移注意事项

1. 字段映射：确保老版本素材字段能够映射到新模板的通用字段（productModel/categoryName/sceneName）。
2. 默认值处理：
   • 模板已绑定 materialType 元数据，无需再在字段中存储。
   • 如果未维护分类/场景，保持“默认店铺”“默认场景”即可。
   • 3DMAX 模板的 renderer 默认值为 "CR"。
3. 必填字段验证：
   • 所有模板至少需要 productModel。
   • 模特模板可选素材压缩包，其余模板必须上传素材文件。
4. 文件要求：
   • PSD：必须上传展示图片 + 预览图。
   • 模特：必须上传至少一张展示图片。
   • 视频：必须上传视频文件与封面图。

📝 预制模板说明

本文件列出的 6 个素材模板已作为内置预制模板定义在 app/admin/_components/TemplateManager.tsx 的 BUILTIN_TEMPLATES 中，并通过 materialType 元数据直接绑定素材类型。

管理员可以在模板管理面板中直接使用这些预制模板创建新的模板，系统会自动填充对应的字段配置。

使用方式

1. 进入管理后台 → 模板管理
2. 在"内置模板"区域选择目标模板
3. 点击"使用此模板"按钮
4. 系统会自动创建对应的模板，包含所有预配置字段与 materialType 元数据

字段配置说明

所有预制模板都基于 STANDARD_FIELD_TEMPLATES 的标准字段配置，确保：

• 字段键名统一（如 productModel、categoryName 等）
• 字段类型和验证规则一致
• 布局宽度和可见性配置合理
• 与现有素材数据兼容