采集服务器接入总览#

本章是接入视角章（分层术语见根目录 CONTEXT.md「文档分层模型」）：面向采集服务器（data-acquisition-server）软件的开发者——即开发运行在中心侧、管理采集设备（执法记录仪等）接入的采集服务软件的工程师。它与按部署客群划分的机构场景、零售场景手册并列：机构/零售手册讲「Web/App 如何使用平台」，本章讲「采集服务器软件本身如何对接平台」。

验证状态：本章为接入视角新写（dev-manual-restructure 19 号票）。页面事实全部引用清单层（endpoints / mqtt inventory / runtime 生成页，自带 provenance 头）与机构手册已核验场景正本（各页自带验证状态与适用基线），本章只做导航级复述与动线重组，不做二次核验、未联调；事实冲突时一律以链接目标为准。

读者画像与接入前提#

你开发的是「采集服务器」上运行的软件。接入前需要具备：

• 一套已部署的中心服务器（center-server），且管理侧已在台账中登记了这台采集服务器（台账维护是机构管理台的动作，见名下设备与绑定清单同步的分工说明）；
• 中心分配的采集服务器编号（serverNo）——对中心 REST 与 MQTT 的寻址都以编号而非 ID 进行；
• 你要实现的三块软件面：
  1. REST 服务间客户端——调用 device-service 的采集服务器/采集设备支撑端点（认证、清单同步、信息回流、IP 自报）；
  2. MQTT 客户端——以 server,{serverNo},… 身份上行遥测/检索、接收下行 deliver；
  3. data/v1 指令服务面——响应机构 Web 端经 Broker 直达的遥控与文件查询命令（server/{serverNo}/data/v1/*，中心网关不消费、由你实现）。

接入动线#

按对接顺序读本章各页：

步骤	页面	解决的问题
1. 身份与认证	接入身份与服务间认证	serverNo 如何换来 REST 令牌密钥；MQTT 客户端身份怎么构造
2. 设备清单	名下设备与绑定清单同步	「我名下有哪些采集设备」从哪读、绑定从哪来、设备信息如何回流
3. 消息链	设备消息链（MQTT）	上行遥测/检索谓词族、下行 deliver、在线状态如何参与
4. 文件	文件上报与检索	设备文件如何进入中心存储区、如何被检索与回放消费
5. 运维与指令面	运维与 Web 指令面	内网 IP 自报与 DMS 推送链、固件同步、必须实现的 data/v1 命令全集

事实引用边界#

本章遵守场景层引用边界（spec「场景层改写」）：

• 可复述：导航级端点行（方法 + 路径 + 一句话用途）、MQTT topic 形状与方向、行为规则的一句话点名；
• 不复述：参数表、请求/响应字段、错误码、鉴权细节、QoS/超时等 wire 细节——一律链清单层（api/center-server/{service}/endpoints|mqtt|runtime）与业务页（business/）；
• 机构手册中「Web 如何遥控采集服务器」的逐命令正本（遥控族 9 页、回放文件链 6 页）是 data/v1 服务面的需求来源，本章从实现方视角反向引用，不复制其字段级内容。

术语与阅读坐标#

• 采集服务器 / 采集设备：采集服务器是中心侧的采集服务软件宿主；采集设备（执法记录仪等）是它管理的接入设备。台账概念见设备与资产域总览。
• REST 面：device-service device 模块是面向采集服务器/采集设备的服务间支撑面（清单层）；data-service device 模块是管理侧台账（清单层）——两者分工见各动线页。
• MQTT 面：主题全量（18 静态 + 7 谓词族 + 5 动态下行 + 服务端订阅面）见MQTT 主题清单，消息信封与客户端 ID 规则见设备服务接口规范。
• 公共 wire 边界（发布 Promise 语义、QoS 不可推必达等）见机构手册MQTT 连接与消息边界。