You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

6.8 KiB

Raw Blame History Unescape Escape

品牌编辑页面

最后更新：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/正式API的URL、HTTP方法均定义在 03-API接口设计.md §3.4 端点清单，本节仅引用编号并定义返回数据结构。

接口引用

接口名称	端点编号	界面用途
品牌详情（含映射）	§3.4 #2	页面加载时获取品牌信息+字段映射列表
编辑品牌	§3.4 #4	保存按钮提交
标准字段列表	§3.4 #8	映射表格的标准字段下拉

数据结构

品牌详情（§3.4 #2）：

Response：

{ "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 }
  ]
}}

编辑品牌（§3.4 #4）：