历史（业务）#

历史模块是十张轨迹表：采集箱使用、采集设备领用/归还（含归还文件索引）、设备位置/状态、指纹扫描仪与 NFC 卡使用、数据同步（含采集服务器同步审计）各自的时间线记录。虽以 REST CRUD 形态暴露，业务上是「服务内部写入、集成面查询」的审计面——集成方通常只读。注意区分：设备文件/遥测的检索动线走 Meilisearch 代理（/system-api/meilisearch/multi-search，不在 springdoc 分组）与设备侧 MQTT retrieve，不经本模块。

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

• OpenAPI JSON（可直接导入 Postman 等工具）：https://zxs.netbodycamera.com/main-service/v3/api-docs/history
• 在线 Swagger 视图：data-service · 历史
• 端点全量清单（含权限点与中文说明）：清单层 · history

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

data-acquisition-box-usage-hist 采集箱使用历史#

采集箱使用轨迹记录（查询型）；契约见清单层。

data-acquisition-device-claim-hist 采集设备领用历史#

采集设备领用轨迹记录（与 snapshot 的当前值快照配对）；契约见清单层。

data-acquisition-device-give-back-file-index-hist 采集设备归还文件索引历史#

归还时文件索引条目的轨迹记录；契约见清单层。

data-acquisition-device-give-back-hist 采集设备归还历史#

采集设备归还轨迹记录；契约见清单层。

data-acquisition-server-data-sync-audit-hist 采集服务器数据同步审计历史#

采集服务器数据同步的审计轨迹（数据同步族，见运行时关联）；契约见清单层。

data-sync-hist 数据同步历史#

主从数据同步的轨迹记录（数据同步族，见运行时关联）；契约见清单层。

device-position-hist 设备位置历史#

设备位置轨迹记录（查询型）；契约见清单层。

device-state-hist 设备状态历史#

设备状态轨迹记录（查询型）；契约见清单层。

fingerprint-scanner-usage-hist 指纹扫描仪使用历史#

指纹扫描仪使用轨迹记录；契约见清单层。

nfc-card-usage-hist NFC 卡使用历史#

NFC 卡使用轨迹记录；契约见清单层。

runtime-links 运行时关联#

数据同步族资源（data-sync-hist / data-acquisition-server-data-sync-audit-hist）与主从数据同步调度同域（定时任务表的 DataSyncMasterSchedule/DataSyncSecondarySchedule：数据导出、归档清理、input 目录扫描导入）——命名对应关系在表，各 hist 表的具体写入方未逐表核验，以源码为准。其余轨迹表在 runtime 全量表（定时任务/缓存/消费者）中无专属条目；设备遥测入 Meilisearch 的写入链在 device-service 侧（BatteryAddDocumentsScheduling 等任务族），与本模块的数据库表是两套存储。