# 更新 `signal-table-excel-generator-design.md` 为 v2 两表生成器文档 ## Summary - 只更新 Markdown 设计/测试文档,不编写代码。 - 文档目标改为:前端网页用于维护设备和变量配置,点击“生成”后导出标准 Excel。 - 最终 Excel 只包含两个 Sheet: - `MES_基本变量原始数据` - `设备类型对应表` - 页面参考微信双栏结构:左侧是设备列表,点击某一行设备/工位,右侧显示该工位对应的基本变量详情。 ## Key Changes - 删除文档中所有“五个 Sheet”相关内容,包括: - `工厂接口配置` - `变量类型代码说明` - `配置_信号` - 重写 Excel 结构说明: - `设备类型对应表` 作为左侧设备/工位配置的数据来源。 - `MES_基本变量原始数据` 作为右侧基本变量详情的数据来源。 - 左侧设备创建表字段先定义为: - `设备名称` - `工位名称` - `设备型号` - `设备IP` - `是否启用` - 文档中注明:为了兼容现有 SCADA,导出 Excel 时 `设备类型对应表` 仍需要保留程序必读列,如 `DB`、`数据来源`;但第一版页面主界面先不展示,可作为默认值或后续高级字段补充。 - 页面行为写清楚: - 左侧一行代表一个设备/工位。 - 点击左侧某一行,右侧切换显示该工位的基本变量。 - 交互方式参考微信:左侧列表选中项高亮,右侧展示详情。 - 未选择设备时,右侧显示空状态。 - 文档明确后续规则: - 没有明确要求时,只更新 `.md` 文档。 - 不主动进行 Vue 代码实现。 ## Test Plan - 创建设备后,左侧列表出现一行新设备。 - 编辑设备后,左侧对应字段同步更新。 - 删除设备后,左侧列表移除该设备。 - 禁用设备后,导出 Excel 中 `是否启用` 为 `0`。 - 点击左侧不同工位,右侧显示对应工位的基本变量。 - 未选择左侧设备时,右侧显示空状态。 - 导出的 Excel 只包含两个 Sheet。 - `MES_基本变量原始数据` Sheet 名称必须完全一致。 - `设备类型对应表` Sheet 名称必须完全一致。 - 导出前校验设备名称、工位名称、设备型号、设备IP不能为空。 - 导出的文件能被当前 SCADA 项目读取。 ## Assumptions - 当前只更新设计文档,不改 Vue 源码。 - 第一版网页主界面只展示用户指定的 5 个设备字段。 - Excel 导出只生成两个 Sheet。 - 右侧基本变量详情由左侧选中的工位触发显示。 - 页面布局参考微信双栏交互:左侧列表,右侧详情。