# 品牌模板 索引

> 版本：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-01-品牌列表页面.md) |
| 04-02 | 品牌编辑页面 | 页面文件 | [04-02-品牌编辑页面.md](./04-02-品牌编辑页面.md) |

---