docs(oneos): publish API integration runbook

vehicle-data-platform/docs/vehicle-data-platform-meeting-todo.md

@@ -402,7 +402,23 @@
 
 ### P1-04 OneOS 业务接口对接
 
-状态：`进行中`
+状态：`进行中（中台接入端已完成，等待 OneOS 正式接口联调）`
+
+已完成的中台侧结果（release `oneos-api-client-20260716184601`）：
+
+- 新增可切换的 OneOS HTTP 范围快照客户端；正式模式为 `ONEOS_SCOPE_SOURCE=api`，原有数据库直读仅保留为接口上线前的只读影子核对，不修改 `ln-asset-management`。
+- 请求使用独立 Service Token、请求 ID、Unix 时间戳和 HMAC-SHA256 防重放签名；非私网字面 IP 强制 HTTPS，服务令牌与签名密钥均不写日志。
+- 支持每页 500 条的稳定游标分页，最多 100 页/50,000 条；要求所有分页 `scopeVersion`、`generatedAt` 完全一致且 `complete=true`。网络错误、429 和 5xx 最多重试 3 次，版本漂移、重复游标、业务错误、格式错误或越界立即失败关闭。
+- 客户、车辆、合同雪花 ID 按 JSON 字符串读取；投影已增加客户名称、部门、负责人、合同、项目、启用时间和来源更新时间，并继续以内容地址版本原子发布。
+- 修复旧迁移 012 中生产 MySQL 保留关键字 `row_number` 的兼容问题；生产已成功应用 012 和 016，投影字段及索引齐全。
+- 同步定时器继续保持未安装/未启用，当前 `active_version` 为空、accepted/rejected 均为 0。缺少正式接口配置时生产手工运行返回退出码 1，不发布空快照，也不退化成全量车辆。
+- 发布安装器支持同时原子替换新版 `oneos-scope-sync`；Go 全量测试、接口签名/分页/版本漂移/瞬时重试测试和安装器测试通过，ECS 三个现有服务均为 active。
+
+尚待 OneOS 团队交付并联调：
+
+- 正式内网 URL、独立服务令牌、HMAC 密钥和允许访问的 ECS 私网源地址；
+- 符合契约的全客户完整快照，包含稳定版本、客户/部门/负责人、合同/项目、正式交车启用时间及机器可读隔离原因；
+- OneOS 侧完成时间戳窗口、request ID 去重、来源限制和接口监控。取得后先手工影子同步、核对抽样与总数，再启用两分钟定时器。
 
 目标：