feat: add redis cache and fanout support

2026-08-25 20:54:03 +08:00
parent 07376c70e3
commit f900a08a01
68 changed files with 3949 additions and 5696 deletions
@@ -0,0 +1,45 @@
+ET /v1/im/favorites/{favorite_id} 返回的是单条收藏详情，当前核心字段大概是这样：
+{
+  "favorite_id": "fav_demo_19179719768_text",
+  "type": "text",
+  "snapshot": {
+    "topic": "favSeed19179719768",
+    "seq": 7001,
+    "from": "usr...",
+    "ts": "2026-08-25T07:26:06Z",
+    "type": "text",
+    "head": {},
+    "content": {},
+    "text": "这是一条收藏的文本消息"
+  },
+  "source": {
+    "topic": "favSeed19179719768",
+    "seq": 7001
+  },
+  "collected_at": "2026-08-25T07:26:06Z",
+  "availability": "available"
+}
+字段说明：
+字段	含义
+favorite_id	收藏记录 ID，后续详情、删除、转发都用它。
+type	收藏类型：text、image、video、voice、file、link。
+snapshot	收藏时保存的展示快照。即使原消息后续变化或删除，收藏列表也主要用这个字段渲染。
+source.topic	原始消息所在会话 Topic。
+source.seq	原始消息在该 Topic 下的消息序号。
+collected_at	收藏时间，ISO/RFC3339 时间格式。
+availability	当前可用状态，通常是 available；如果原资源被合规删除或失效，可能返回 removed 等状态。
+
+
+snapshot 里面比较重要：
+字段	含义
+snapshot.topic	原消息 Topic。
+snapshot.seq	原消息 seq。
+snapshot.from	原消息发送人。
+snapshot.ts	原消息发送时间。
+snapshot.type	消息类型。通常和外层 type 一致。
+snapshot.head	原消息头部扩展，比如 mime、x-im-type 等。
+snapshot.content	原消息内容。文本、文件、图片、语音、链接等具体展示数据一般在这里。
+snapshot.text	服务端提取出的纯文本摘要，方便列表搜索和预览展示。
+
+
+前端一般列表页用外层 type + snapshot + collected_at + availability 渲染；点开详情时，如果是文件/图片/视频/语音，再根据 snapshot.content.file_id、thumbnail_file_id 等字段去走文件下载/预览逻辑。