设备与协议
物联硬件项目，页面通常不是工作量所在。协议、注册、鉴权、影子状态、离线判定、断网补传、OTA 失败回滚，这些才决定设备在现场能不能长期在线。我们先把设备模型写清：品类、固件版本、能力、所属网关、所属空间。同一套平台要接不同厂家时，适配层必须可加，而不是每个厂家改一版核心。离线多久算离线、心跳多久一次、补传窗口多长，要按现场网络写，不能按实验室 Wi-Fi 验收。
硬件联网的项目，协议和异常处理是主要工作量。设备什么时候算离线、断网期间数据怎么补、固件升级失败怎么回滚，这些要在方案里写清楚。
物联硬件项目，页面通常不是工作量所在。协议、注册、鉴权、影子状态、离线判定、断网补传、OTA 失败回滚，这些才决定设备在现场能不能长期在线。我们先把设备模型写清：品类、固件版本、能力、所属网关、所属空间。同一套平台要接不同厂家时，适配层必须可加，而不是每个厂家改一版核心。离线多久算离线、心跳多久一次、补传窗口多长，要按现场网络写，不能按实验室 Wi-Fi 验收。
指令下行比上报更危险：误控、重试导致重复执行、设备忙时拒绝，都要有状态回读。告警要能区分传感器故障和业务越限。批量配置和分组很重要，上千台设备不能一台一台点。安装、更换、报废的生命周期要进系统，否则仓库里的设备和平台上的 ID 会对不上。
一次失败的全量升级可以让整场设备变砖。我们做灰度、版本校验、失败阈值熔断和回滚包。升级过程中的业务是否暂停，要按场景定。安全方面，证书、密钥、非法设备接入，按项目实际威胁写，不堆砌名词。
设备入网要有安装位置、照片和验收，否则平台上的在线率和现场对不上。网关和下挂子设备的拓扑要能看，换网关不能让子设备全部失踪。告警抑制和值班表一起配，半夜把所有心跳失败推到同一个手机，运维会把推送关掉。证书过期、非法设备、弱口令，按项目实际威胁做，不堆砌名词充安全。
上线先小批量安装在真实环境，跑完离线、补传、升级和更换，再扩点。现场安装手册和售后换机流程是交付物，不是附件。培训对象是实施和运维，不是只给产品经理看演示大屏。物联系统做成了，设备找得到、状态信得过、升级敢做、坏了能换，平台数字和现场实物是同一批。
多协议接入，设备注册与鉴权规范统一，新增型号按模板接入。
固件分批灰度升级，失败自动回滚，远程指令留下发与回执记录。
上报数据按点位解析入库，断网补传按时间戳去重。
每家厂商一套协议，接一款设备写一遍代码
接入层做协议适配与点位映射，新设备只配置不改代码。
设备离线判断不准，误报一堆
离线判定按心跳周期和容忍次数配置，网络抖动不触发告警。
升级失败的设备变砖，只能上门
升级分批灰度、校验签名、失败回滚，升级结果逐台可查。
型号模板、设备台账、鉴权管理。
多协议适配、点位映射、数据解析。
灰度升级、回滚、远程指令回执。
时序数据、补传去重、保留策略。
离线判定、阈值告警、工单联动。
对外 API、Webhook、第三方对接。
写清设备模型、离线判定、补传窗口和 OTA 范围，列出本阶段要接的厂家协议和安装现场条件。
定注册鉴权、影子状态和指令回读，确认网关、固件分批升级和换机流程如何设计。
在真实网络测离线、补传、误控保护和升级熔断。失败可回滚作为验收项提前写好。
小批量安装跑通更换和售后，再扩点。交付安装手册，培训实施和运维，平台与实物台账一致。