feat(client): define digital sync contract

This commit is contained in:
baiyanyun
2026-06-08 17:10:38 +08:00
parent ff25c2fef7
commit 3bab6af63c
3 changed files with 150 additions and 7 deletions

View File

@@ -577,6 +577,21 @@ sync_error
管理端 API 尚未在 qiming-backend 中确认最终路径,因此当前 qimingclaw 先落本地同步契约,不硬编码远端接口。
当前同步 item 契约:
```text
contract_version = qimingclaw.digital_employee.sync.v1
outbox_id
entity_type
entity_id
operation
entity_summary { title, status, summary }
business_view { entity_type, local_id, title, status, ...typed fields }
payload
```
`business_view` 按 Plan / Task / Run / Event / Artifact / Approval 归一常用业务字段,管理端可以先消费该稳定视图;`payload` 保留客户端原始上下文,便于后续扩展和审计。
### 产出
- 数字员工页面可以从源码重新构建。