第二章 硬件埋点数据源接入流程总览：整体流程图、关键节点、角色与责任矩阵
1. 适用场景
本流程适用于以下三类硬件埋点数据源的接入工作：
- 新硬件模组首次接入：尚未在 RICE 平台注册过数据通道的传感器、控制器或边缘网关。
- 存量硬件协议升级：已有埋点设备因固件版本变更导致数据帧结构、通信时序或元数据字段发生非兼容性变化。
- 数据源迁移或灾备重建：因基础设施割接、机房迁移或主数据链路故障需重新建立数据采集通道。
判断要点：只要涉及 数据帧结构定义、通信握手流程 或 元数据注册信息 三者中任一变化，就必须按本流程执行全量接入，不可跳过关键节点做局部修签。
2. 前置条件
| 序号 | 前置条件项 | 验收标准 | 责任角色 |
|---|---|---|---|
| 1 | 硬件数据帧规范文档已定稿 | 包含帧头、数据域、校验位、帧尾的完整字节定义 | 硬件工程师 |
| 2 | RICE 目标环境网络可达性已验证 | 设备端与采集网关之间 PING 测试通过，MTU 无分片 | 网络运维 |
| 3 | 接入所需的鉴权凭证已签发 | Token / 证书已下发至设备或边缘代理 | 安全管理员 |
| 4 | 数据源元数据模板已在 RICE 注册 | 数据源 ID、设备类型、采集点位表已录入 | 数据架构师 |
3. 整体流程图（核心节点）
下图展示了硬件埋点数据源从 物理连接 到 数据可用 的六个关键节点，
每个节点都对应明确的输入物、输出物及责任角色。
关键检查点：节点 ③（数据源元数据注册）是后续所有采集管道配置的基础，
元数据注册错误将直接导致节点 ④ 联调失败。此节点必须由数据架构师与硬件工程师双人复核签字。
4. 角色与责任矩阵（RACI）
| 关键节点 | 硬件工程师 | 嵌入式工程师 | 数据架构师 | 采集开发工程师 | 数据质量工程师 | 运维工程师 |
|---|---|---|---|---|---|---|
| ① 物理连接与链路校验 | R/A | C | I | I | - | C |
| ② 协议适配与帧解析 | C | R/A | C | I | - | - |
| ③ 数据源元数据注册 | C | I | R/A | C | I | - |
| ④ 采集管道配置与联调 | C | C | I | R/A | C | I |
| ⑤ 数据质量门禁 | - | I | C | C | R/A | I |
| ⑥ 上线与监控移交 | I | - | C | C | C | R/A |
R = 执行负责人（Responsible）｜A = 审批决策人（Accountable）｜C = 被咨询人（Consulted）｜I = 被告知人（Informed）
5. 输入输出物清单
| 节点编号 | 输入物 | 输出物 | 保管位置 |
|---|---|---|---|
| ① | 硬件接线图、供电规格书 | 链路状态报告（Link Status Report） | 硬件工程文档库 /hardware/link/ |
| ② | 数据帧规范文档 v2.1+ | 协议解析配置表（JSON 格式） | RICE 配置仓库 /protocol/ |
| ③ | 设备信息表、点位清单 | 数据源元数据注册记录（含 RICE ID） | RICE 元数据管理平台 |
| ④ | 管道参数模板、鉴权凭证 | 联调测试报告（含吞吐量/延迟/重连指标） | 项目交付文档 /delivery/ |
| ⑤ | 质量基线规则（完整性 ≥99.5% / 连续性 ≤0.5% 缺失） | 质量门禁报告（通过 / 降级 / 阻塞） | 数据质量看板 + 文档归档 |
| ⑥ | 运维交接清单、告警规则模板 | 监控仪表盘（Grafana 或类似工具） | 运维监控系统 |
6. 责任边界与协作规则
- 硬件工程师 对物理链路的电气特性负责，必须在节点①完成后输出“链路状态报告”，包含信号质量、电源稳定性、误码率三项指标。
- 嵌入式工程师 对协议解析的正确性负技术责任，帧解析配置表必须通过 至少 3 组典型数据帧 的离线验证方可提交。
- 数据架构师 是元数据注册的唯一审批人，任何人不得绕过审批直接在 RICE 平台创建数据源。
- 采集开发工程师 在联调阶段拥有管道配置的修改权限，但修改后必须回退至数据架构师做元数据一致性复核。
- 数据质量工程师 拥有门禁“一票否决权”：质量指标未达标时，节点⑤输出为“阻塞”，不得进入上线节点。
协作避坑提示：节点④联调阶段最容易出现“协议版本不同步”问题。
建议在联调开始前由嵌入式工程师与采集开发工程师双方
diff 当前固件实际帧结构与解析配置表，
确保字节偏移量、数据类型、校验算法完全一致。
7. 记录材料要求
| 材料名称 | 格式 | 签字/确认要求 | 保存期限 |
|---|---|---|---|
| 链路状态报告 | PDF + 原始日志 | 硬件工程师签字 | ≥ 12 个月 |
| 协议解析配置表 | JSON（带版本号） | 嵌入式工程师 + 数据架构师双签 | |
| 元数据注册记录 | 系统截图 + 审批单 | 数据架构师审批 | |
| 联调测试报告 | PDF + 压力测试原始曲线 | 采集开发工程师 + 硬件工程师会签 | |
| 质量门禁报告 | PDF + 质量看板快照 | 数据质量工程师签字 | |
| 运维交接清单 | Markdown + 监控截图 | 采集开发工程师 + 运维工程师交接 |
8. 异常处理策略
| 异常场景 | 发现环节 | 处理措施 | 回退条件 |
|---|---|---|---|
| 物理链路误码率 > 0.1% | 节点① | 更换线缆/接口/重做接地 | 误码率降至 0.01% 以下 |
| 帧解析字段偏移不匹配 | 节点② | 修订解析配置表，同步更新固件版本号 | 双人验证至少 5 帧全字段匹配 |
| 元数据注册 ID 冲突 | 节点③ | 重新分配数据源 ID，更新所有关联引用 | 冲突 ID 已废弃且无下游依赖 |
| 管道联调压力测试失败（吞吐量低于基线 80%） | 节点④ | 调整采集线程数/缓冲区大小/网络参数 | 连续 3 轮压力测试均达标 |
| 质量门禁完整性低于 99.5% | 节点⑤ | 检查链路丢包、设备采集间隔、数据队列积压 | 问题定位并修复后重新跑满 24 小时门禁窗口 |
| 上线后告警风暴 / 误告警 | 节点⑥ | 调整告警阈值、增加告警静默期、优化规则 | 告警收敛至每天 ≤3 条有效告警 |
SOP 执行建议：每个异常处理完成后，必须在对应节点的输出文档中追加 异常处理记录 小节，
写明根因、处理动作、验证人及时间戳，形成可追溯的流程闭环。
9. 验收标准
- 节点①～⑥ 每个节点的输出物均已归档，且文档版本号与 RICE 平台记录一致。
- 链路状态报告中三项指标均合格（信号质量 ≥ -70 dBm、电源纹波 ≤ 50 mV、误码率 ≤ 0.01%）。
- 协议解析配置表通过双人复核，且在 RICE 配置仓库中标记为“已验证”。
- 元数据注册记录已不可逆写入 RICE 元数据管理平台，并生成了唯一数据源 ID。
- 联调测试报告中吞吐量 ≥ 设计值的 90%，延迟 ≤ 200 ms（P99），断线重连 ≤ 3 秒。
- 质量门禁报告结论为“通过”，且质量看板已展示连续 24 小时合规数据。
- 运维交接清单已签署，监控仪表盘已上线且告警规则处于生效状态。