54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
# 更新 `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。
|
||
- 右侧基本变量详情由左侧选中的工位触发显示。
|
||
- 页面布局参考微信双栏交互：左侧列表，右侧详情。
|