Files
iAOP/templates/ti-cl4/point-dict/README.md
T

47 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# iAOP-Template-Ti 一期 · 缺省通用点位集(Demo 点位字典)
对应 EPIC #2「[M1] 数据接入准备」子任务 **#20**(0.5d):
搭建**缺省通用点位集**(演示用,不依赖客户数据),供 PRD 13 章
「缺省数据策略」使用——客户 DCS 点表延迟/字段不完整时,
启用本点位集完成**演示与框架验证**,点表到位后无缝切换真实点位字典。
## 用途(PRD 13 章)
| 场景 | 处理 |
| --- | --- |
| 客户 DCS 点表延迟 | 启用 `point_dict.default.csv` 先行演示(M1 截止日仍未收到完整点表时触发) |
| 点表字段不完整 | 仅接入已确认点位;未确认部分保持缺省点位占位 |
| 点表到位后 | 由配置台导入真实点位字典,**无缝切换**,网关零改动 |
点位范围对齐 PRD 7.2「点位字典范围(一期)」:
- **沸腾氯化炉**(`CLF-01`):炉温、炉压、氯气流量、CO/CO₂、炉层状态、进料量;
- **精制/还原工序**(`RF-01`):还原温度、真空度、TiCl₄ 纯度、杂质含量;
- **能源/公用工程**(`E-01` / `ST-01` / `CW-01`):电、蒸汽、循环水。
## 资产说明
| 资产 | 说明 |
| --- | --- |
| `point_dict.default.csv` | 缺省通用点位字典(对齐内核 CSV schema:9 列,与 `core/edge-gateway/config/point_dict.example.csv` 一致) |
## 设计说明
- **不依赖客户数据**:所有点位 `protocol = simulator`,由内核模拟采集驱动
(`core/edge-gateway/drivers/simulator_driver.py`)按点位生成确定性伪随机值,
本地即可端到端联调(采集→spool→Kafka),无需任何现场设备/点表;
- **schema 对齐**:表头、量纲、数据类型、采样率、协议与内核点位字典
schema(`core/edge-gateway/point_dict/schema.py`)完全一致,
`python core/edge-gateway/point_dict/validator.py` 可直接校验通过;
- **opcNode 占位**:`opcNode` 列保留典型 OPC UA 节点路径(如 `ns=2;s=CLF.Temp`),
模拟现场点表结构;真实点表导入时按配置台校验后替换;
- **采样率**:工艺快变量 1000ms(1Hz),质量类慢变量(纯度/杂质)60000ms(1min)。
## 校验
```bash
python templates/ti-cl4/point-dict/_sanity_check.py
```
校验:CSV 表头与内核 schema 对齐(9 列)、非空、无空行、行内列数一致、
protocol 全部为合法协议(simulator 等)、sampleRate 为正整数。