chore: sync worktree changes - update protocols, trellis workspace, and config
This commit is contained in:
@@ -215,12 +215,18 @@ data: {"event_id":"6f0d...","occurred_at":"2026-03-30T07:00:00Z","user_id":"..."
|
||||
"occurred_at": "datetime",
|
||||
"user_id": "uuid",
|
||||
"message_id": "uuid",
|
||||
"event_type": "INBOX_MESSAGE_CREATED | INBOX_MESSAGE_READ_CHANGED | INBOX_MESSAGE_STATUS_CHANGED | INBOX_SNAPSHOT_REQUIRED",
|
||||
"op": "created | read_changed | status_changed | snapshot_required",
|
||||
"version": 1743313300000,
|
||||
"data": {}
|
||||
}
|
||||
```
|
||||
|
||||
说明:
|
||||
|
||||
- SSE 帧的 `event:` 行与 payload 内 `event_type` 当前实现保持一致。
|
||||
- 客户端可优先使用 SSE `event`,也可在 payload 内读取 `event_type` 做调试或补偿。
|
||||
|
||||
### Delta 约定
|
||||
|
||||
- `created`:
|
||||
@@ -275,3 +281,10 @@ data: {"event_id":"6f0d...","occurred_at":"2026-03-30T07:00:00Z","user_id":"..."
|
||||
- 对 `message_type=calendar`,前端必须按 `content.type` 严格分发:`invite | updated | deleted`。
|
||||
- 若 `content` 缺少协议必填字段(`schema_version/item/actor/summary`,以及 `updated` 的 `changes`),前端必须进入协议异常展示路径。
|
||||
- 禁止将协议异常消息兜底渲染为“默认日历邀请”或其他正常业务消息。
|
||||
|
||||
---
|
||||
|
||||
## Compatibility Strategy
|
||||
|
||||
- 策略:`backward-compatible`
|
||||
- 本次仅补全文档遗漏字段 `event_type`,不改变现有 SSE wire 协议。
|
||||
|
||||
@@ -43,7 +43,7 @@ Base URL: `/api/v1/users`
|
||||
|
||||
字段说明:
|
||||
- `id`: 用户唯一标识符 (UUID)
|
||||
- `username`: 用户名,3-30 字符
|
||||
- `username`: 用户名,当前后端更新接口约束为最大 30 字符(最小长度未在 API 层强制)
|
||||
- `phone`: E.164 格式手机号,可为 null
|
||||
- `avatar_url`: 头像 URL,可为 null
|
||||
- `bio`: 个人简介,最大 200 字符,可为 null
|
||||
@@ -142,3 +142,10 @@ Base URL: `/api/v1/users`
|
||||
### Response
|
||||
|
||||
`UserContext` 对象。
|
||||
|
||||
---
|
||||
|
||||
## Compatibility Strategy
|
||||
|
||||
- 策略:`backward-compatible`
|
||||
- 本次仅修正文档约束描述与实现一致,不改变接口字段与响应结构。
|
||||
|
||||
Reference in New Issue
Block a user