# 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 为正整数。