体脂秤部署与数据链路 SOP
指导场馆完成 BLE 体脂秤接入，打通「上秤 → MQTT → 体质档案 → 报表」全链路。
1. 部署清单#
| 项 | 要求 |
|---|---|
| 体脂秤 | 支持 BLE 广播或厂商网关转 MQTT 的型号（B 端「体测设备 → 体脂秤」已纳管的型号优先） |
| 场边网关 | 可连接平台 EMQX Broker（见《智慧场馆设备接入指南》§1） |
| 网络 | 场馆 4G/WiFi，可出公网到 Broker 对外端口 |
2. 部署步骤#
- 登记设备：B 端「智能硬件 → 设备台账」新增设备，类型选体脂秤，记录 device_id
- 配置网关：网关 MQTT 指向环境 Broker 地址，上秤数据转
device/{device_id}/scale主题 - 联调验证：
- 网关侧：观察 publish 成功回执（QoS 1）
- 平台侧：B 端「体脂秤分析 / 体质数据」出现该设备测量记录
- 人员关联：payload 携带
user_id/child_id时自动归档到个人体质档案；不携带则只入设备测量流水
3. 数据字段与报表#
测量 payload 字段（weight / body_fat_rate / muscle_rate / water_rate / bone_mass / bmi / bmr / visceral_fat）落库后驱动：
- 学员端 / 家长端体质报告（B 端与小程序可见）
- 教练台「体质数据总览」
- 场馆「体质数据统计」报表
4. 常见问题#
| 问题 | 处理 |
|---|---|
| 测量记录出现但报表没有 | 检查 user_id/child_id 是否为空（空则不计入个人报表） |
| 多台秤数据串扰 | 每台秤独立 device_id，主题不可复用 |
| 弱网环境 | 网关本地缓存补传，平台按幂等消费，重复上报安全 |
版本 v1（2026-09-21）· 配套协议见《智慧场馆设备接入指南》