6.2 KiB
品牌编辑页面
最后更新：2026-04-25 状态：已设计
1. 基本信息
| 项 | 值 |
|---|---|
| 路由 | /brand/create 或 /brand/{id}/edit |
| 权限 | admin |
| 入口 | 品牌列表页点击"新增品牌"或"编辑" |
| 面包屑 | 首页 / 品牌模板管理 / 新增品牌 或 编辑FANUC |
2. 界面布局
┌──────────────────────────────────────────────────────────┐ │ [面包屑] 首页 / 品牌模板管理 / 编辑FANUC │ ├──────────────────────────────────────────────────────────┤ │ [基本信息区] │ │ < 返回 编辑品牌模板：FANUC │ │ 品牌名称：[FANUC] │ │ device字段名：[device] │ │ tags路径：[tags] │ ├──────────────────────────────────────────────────────────┤ │ [字段映射配置区] [+ 添加映射] │ │ 标准字段 | 匹配方式 | 匹配值 | 类型 | 必须 | 操作 │ │ program_name | 按id | Tag5 | string | 是 | [删除] │ │ part_count | 按id | Tag8 | number | 是 | [删除] │ │ device_status | 按id | _io_status| number | 是 | [删除] │ │ ... │ ├──────────────────────────────────────────────────────────┤ │ ⚠ 修改映射配置仅影响后续新采集数据，历史数据不受影响 │ │ [取消] [保存] │ └──────────────────────────────────────────────────────────┘
3. 查询条件
无。
4. 操作按钮
| 名称 | 位置 | 显示条件 | 点击行为 |
|---|---|---|---|
| 添加映射 | 映射表头上方 | 始终 | 新增一行空映射 |
| 删除 | 映射行操作 | 始终 | 移除该行(不弹确认) |
| 保存 | 页脚 | 始终 | 校验->保存->返回列表 |
| 取消 | 页脚 | 始终 | 脏数据检测->返回列表 |
5. 弹窗规格
添加映射行：使用el-select选标准字段+输入匹配值+选择类型，直接在表格行内编辑，不弹窗。
6. 状态机
品牌is_enabled：
- 1(启用): el-tag success
- 0(停用): el-tag danger
7. 交互流程
- 加载(编辑)：请求品牌详情+映射列表->渲染
- 加载(新增)：空表单
- 添加映射：表格新增一行空行(标准字段下拉+匹配值输入+类型选择+必填勾选)
- 删除映射：直接移除该行
- 保存：确认弹窗"修改映射配置仅影响后续新采集数据，历史数据不受影响，确定保存？"->调API->成功返回列表
- 取消：脏数据检测->返回
8. 脏数据检测（本模块特殊规则）
品牌名称/device字段/tags路径/映射列表任一变更则isDirty=true。
9. Mock数据
GET /api/admin/brand/1 品牌详情+映射列表：
{ "code": 0, "data": {
"id": 1, "brandName": "FANUC", "deviceField": "device", "tagsPath": "tags",
"mappings": [
{ "id": 1, "standardField": "program_name", "fieldName": "Tag5", "matchBy": "id", "dataType": "string", "isRequired": 1 },
{ "id": 2, "standardField": "part_count", "fieldName": "Tag8", "matchBy": "id", "dataType": "number", "isRequired": 1 },
{ "id": 3, "standardField": "device_status", "fieldName": "_io_status", "matchBy": "id", "dataType": "number", "isRequired": 1 },
{ "id": 4, "standardField": "run_status", "fieldName": "Tag9", "matchBy": "id", "dataType": "number", "isRequired": 1 },
{ "id": 5, "standardField": "operate_mode", "fieldName": "Tag10", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 6, "standardField": "spindle_speed_set", "fieldName": "Tag11", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 7, "standardField": "feed_speed_set", "fieldName": "Tag12", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 8, "standardField": "spindle_speed_actual", "fieldName": "Tag13", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 9, "standardField": "feed_speed_actual", "fieldName": "Tag14", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 10, "standardField": "spindle_load", "fieldName": "Tag15", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 11, "standardField": "spindle_override", "fieldName": "Tag16", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 12, "standardField": "power_on_time", "fieldName": "Tag17", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 13, "standardField": "run_time", "fieldName": "Tag18", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 14, "standardField": "cutting_time", "fieldName": "Tag19", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 15, "standardField": "cycle_time", "fieldName": "Tag20", "matchBy": "id", "dataType": "number", "isRequired": 0 },
{ "id": 16, "standardField": "machining_status", "fieldName": "Tag21", "matchBy": "id", "dataType": "string", "isRequired": 0 }
]
}}
### 9. 数据需求
> 以下为本页面需要的数据，数据库设计定稿时需覆盖。参考 `01-数据库设计.md` 草案。
| 数据需求 | 草案对应 | 说明 |
|---------|---------|------|
| 品牌基本信息 | cnc_brand | brand_name/device_field/tags_path |
| 字段映射列表 | cnc_brand_field_mapping | 按brand_id查询，含standard_field/field_name/match_by/data_type/is_required |
| 标准字段枚举 | 代码层面约定（不建表） | program_name/part_count等16个标准字段 |