feat: 完成 issue #20 [M1] 搭建缺省通用点位集（演示用，不依赖客户数据）

2026-08-04 22:44:20 +08:00
parent 91bb0c5912
commit 366311abdc
3 changed files with 135 additions and 0 deletions
@@ -0,0 +1,46 @@
+# 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 为正整数。