feat(fulfillment): 新增 order_site 客户绑定集成

This commit is contained in:
yml
2026-11-18 10:59:20 +08:00
parent 8a58f2857d
commit 99c96974f2
9 changed files with 452 additions and 5 deletions
+18
View File
@@ -98,6 +98,24 @@ ORDER_SITE_LOOKUP_ENABLED=true
数据库账号必须是只读账号。跨库 SQL 只允许出现在
`web/backend/services/external_order_source.py`。
## order_site 客户领取集成
`order_site` 客户页通过服务端接口调用 live-hub,不允许客户浏览器直接访问
live-hub 管理 API。内部接口统一位于:
```text
/api/integration/platform-fulfillment/customer-sessions/*
```
接口使用 `X-Integration-Key` 鉴权,密钥来自
`PLATFORM_FULFILLMENT_INTEGRATION_KEY`。返回给 `order_site` 的客户会话只包含
二维码、二维码有效期、绑定阶段、平台识别角色和状态提示,不包含账号、CK、
积分、租约或限兑信息。
客户绑定二维码默认有效期 600 秒,可通过
`PLATFORM_BINDING_QR_TTL_SECONDS` 调整。过期、失败或客户主动刷新时会在
live-hub 创建新的绑定任务。
## 权限
- `platform_fulfillment:view`