docs(architecture): consolidate domain protocols

This commit is contained in:
2026-07-21 10:08:12 +08:00
parent 8d6fe1e550
commit 17e5656f53
11 changed files with 524 additions and 149 deletions
+3 -3
View File
@@ -85,7 +85,7 @@ Authorization: Bearer <TOKEN>
/tip -> /characters/elio/tip
```
Chat 和 Private Room Provider `characterId` 为边界路由角色变化时必须创建新的 Actor,不能在旧 Actor 内切换角色
Chat Provider 以 `characterId` 为边界路由角色变化时创建新的 Actor。Private Room 的角色边界由 [Private Room 权威协议](./FRONTEND_PRIVATE_ROOM_API.md) 定义
## 3. Chat HTTP 协议
@@ -308,8 +308,8 @@ conversationKey = {ownerKey}::character:{encodeURIComponent(characterId)}
## 7. 关联业务边界
- Private Room 列表请求使用 `GET /api/private-room/albums?characterId={id}&limit=20`;相册解锁由 `albumId` 定位,body 只发送 `expectedCost`
- Tip 创建订单时发送 `recipientCharacterId`VIP 和 Top-up 不依赖角色归属
- Private Room 的相册、解锁、Gallery 和支付回跳由 [Private Room 权威协议](./FRONTEND_PRIVATE_ROOM_API.md) 定义
- Tip 的角色归属、订单轮询和支付回跳由 [Payment 权威协议](./FRONTEND_PAYMENT_API.md) 定义;Chat 只保存解锁所需的原角色回跳地址
- 登录、支付和解锁回跳保存原角色动态 URL,不能降级为通用 `/chat`
- Analytics 可以使用 `characterId`,聊天正文不属于路由或身份协议的一部分。