feat(sdk): 绑定时上报设备 log 到 update-metadata 并内聚双层绑定

1:1 复刻 iOS commit 4bc8fdb。

- bind(userId) 内聚为硬绑 + getVersion + 软绑 + updateMetadata 一次原子调用,
  软绑失败自动硬解绑回滚 + 清状态;集成方无需感知双层绑定
- fetchLatestFirmware 简化为对账上报 + checkUpgrade 两步,不再重复软绑
- VersionInfo 增加 log: JSONObject?,fromJson 用 optJSONObject 解析;
  SDK 暴露只读 versionLog: StateFlow<JSONObject?>,断连/解绑/软绑回滚时清空
- ShipmentSnDeviceService 新增 updateMetadata(sn, data: JSONObject),
  HttpHelper.post 已支持 JSONObject 作为 body 子节点透传
- 老固件不返回 log → versionLog == null → 自动跳过 updateMetadata,前向兼容
- 同步更新 .wiki/tech-architecture.md(状态清理表 + OTA 编排图)
  + product-decisions.md(新增决策条目)+ README.md(versionLog 状态)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.wiki/product-decisions.md

@@ -13,7 +13,7 @@
 
 **影响**：集成方升级时构造函数签名报错，必须显式传两个参数。可接受，因为 demo / iOS / Harmony 都同步改了。
 
-## bind 改瘦 + fetchLatestFirmware 串三步
+## bind 改瘦 + fetchLatestFirmware 串三步（已废弃，见下条）
 
 **决策时间**：2026-05-08（commit `2dde274`）
 
@@ -27,6 +27,28 @@
 
 **集成方迁移指南**：bind 之后必须显式调 `fetchLatestFirmware(sn, currentVersion, userId)` 才能拿到固件信息和触发对账。
 
+## bind 内聚双层绑定 + updateMetadata 上报
+
+**决策时间**：2026-05-18（同步 iOS commit `4bc8fdb` 复刻）
+
+把软绑 + updateMetadata 从 `fetchLatestFirmware` 重新搬回 `bind` 内部，集成方一次调用完成"完整绑定"。
+
+| 阶段 | 上一版（2026-05-08） | 本版（2026-05-18） |
+|---|---|---|
+| `bind(userId)` | BLE 硬绑 + getVersion | BLE 硬绑 + getVersion + **软绑** + **updateMetadata** + 失败回滚 |
+| `fetchLatestFirmware(sn, currentVersion, userId)` | 对账 + 软绑 + checkUpgrade | 对账 + checkUpgrade（不再软绑） |
+
+**原因**：
+- 软绑是"绑定"语义的一部分，集成方不该感知双层之分（与 iOS HEAD 对齐）
+- updateMetadata 在 bind 时 versionLog 刚新鲜，语义上"绑定时一并上报状态"更连贯
+- 上一版"bind 改瘦"是过度拆分；事实证明拆开反而让集成方容易遗漏软绑
+
+**集成方迁移指南**：bind 调用方式不变，但**不再需要**调 `fetchLatestFirmware` 才完成软绑。检查更新仍调 `fetchLatestFirmware`，但它只做对账+checkUpgrade。
+
+**新增 SDK 状态**：`versionLog: StateFlow<JSONObject?>` —— 设备 BLE getVersion 响应中 `log` 字段（任意 JSON 对象，老固件不返回则 null）。bind 时 fire-and-forget 透传到 `POST /api/auth/loomart/shipment-sn/device/update-metadata`。**前向兼容**：老固件 versionLog == null → 自动跳过 updateMetadata。
+
+**JSON object 选型**：直接用 `org.json.JSONObject?` 透传（不解析、不转 Map），HttpHelper.post 已支持 `JSONObject` 作为 body 子节点序列化。对应 iOS 的 `[String: Any]?` 方案。
+
 ## disconnect 时不清 sn / firmwareUpgrade
 
 **决策时间**：2026-05-08（commit `0dbfab9`）