haoliang-net/docs/02-功能清单/管理后台/04-品牌模板/00-品牌模板-索引.md

品牌模板 索引

版本：v1.0 最后更新：2026-04-25

---

模块概述

管理CNC品牌模板及其字段映射配置。品牌数量少，列表无分页无筛选。编辑使用独立页面（非弹窗），支持字段映射行内编辑。修改映射不影响历史数据。

页面清单

页面编号	页面名称	路由	功能概述
04-01	品牌列表页面	/brand	品牌列表+新增/编辑/启停/复制
04-02	品牌编辑页面	/brand/create 或 /brand/{id}/edit	品牌基本信息+字段映射配置

页面功能详情

04-01 品牌列表页面

路由：/brand 功能概述：品牌模板列表，新增/编辑/启停/复制操作

功能列表：

功能编号	功能名称	触发条件	交互行为	涉及API
F01	加载品牌列表	页面挂载	请求列表API	GET /api/admin/brand
F02	新增品牌	点击新增	跳转新增编辑页	-
F03	编辑品牌	点击编辑	跳转编辑页	-
F04	启停品牌	点击启用/禁用	确认->切换状态	PUT /api/admin/brand/{id}/toggle
F05	复制品牌	点击复制	复制模板到新增页	GET /api/admin/brand/{id}

状态机：品牌is_enabled：1(启用)/0(停用)

路由跳转：

• 新增/编辑 -> 品牌编辑页(/brand/create 或 /brand/{id}/edit)

04-02 品牌编辑页面

路由：/brand/create 或 /brand/{id}/edit 功能概述：编辑品牌基本信息(名称/device字段/tags路径)及字段映射配置(行内表格编辑)

功能列表：

功能编号	功能名称	触发条件	交互行为	涉及API
F01	加载品牌详情(编辑)	页面挂载(编辑模式)	请求品牌详情+映射列表	GET /api/admin/brand/{id}
F02	添加映射行	点击添加映射	表格新增空行	-
F03	删除映射行	点击删除	移除该行	-
F04	保存品牌	点击保存	校验->调API->返回列表	POST/PUT /api/admin/brand
F05	取消编辑	点击取消	脏数据检测->返回列表	-

路由跳转：

• 保存/取消 -> 返回品牌列表页(/brand)

子目录/文件

编号	名称	类型	索引
04-01	品牌列表页面	页面文件	04-01-品牌列表页面.md
04-02	品牌编辑页面	页面文件	04-02-品牌编辑页面.md

---