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

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）。

校验

python templates/ti-cl4/point-dict/_sanity_check.py

校验：CSV 表头与内核 schema 对齐（9 列）、非空、无空行、行内列数一致、 protocol 全部为合法协议（simulator 等）、sampleRate 为正整数。