基础数据（业务）#

基础数据模块讲一件事：把中心侧的员工名册与文件索引以「按采集服务器编号」的口径开放给采集侧服务间调用。管理面正本（员工 CRUD、员工-用户绑定等）在 data-service 的基础数据（业务），本模块只是它的采集侧投影，共 2 端点。

本页是 device-service basedata 模块接口的业务说明，非业务说明不在本页复述：

• OpenAPI JSON（可直接导入 Postman 等工具）：https://zxs.netbodycamera.com/device-service/v3/api-docs/basedata
• 在线 Swagger 视图：device-service · 基础数据
• 端点全量清单（含中文说明）：清单层 · basedata

参数、请求/响应字段、错误码等契约事实一律见上述 Swagger 与清单层；本页只讲业务语义与动线。

employee 员工#

listByDataAcquisitionServerNo：按采集服务器编号查询其租户范围内的员工列表——采集服务器在处理采集数据（如执法记录仪归属、人员匹配）时拉取本租户员工名册的只读投影。员工的创建/更新/用户绑定等管理端语义全在 data-service（见员工），本端点不提供任何写形态。契约见清单层 · employee。

file-index 文件索引#

uploadByDataAcquisitionServerNo：采集服务器按自身编号上传文件索引文件（multipart）——采集侧把设备文件的索引清单回传中心的入库端点。它与设备消息链的检索侧同属文件检索面：中心侧的 iot retrieve 谓词族按 params.items 检索词汇表检索（ice / firmware / dms / ptt / upload/*，未知项静默忽略）、应答经 reply 回包（见MQTT 消费者，谓词族形状与字段级契约见主题清单与yaml 详解 · retrieve）——REST 上传入库、MQTT 检索应答构成动线两侧；两侧数据的直接关联属源码细节，本页不展开。契约见清单层 · file-index。

runtime-links 运行时关联#

本模块无专属定时任务与缓存（全量表见 device-service 消费者与 data-service 定时任务、缓存的 device-service 节）；文件检索动线的消费侧见上文 file-index。