feat(zulip): 添加全面的 Zulip 集成系统

* **新增 Zulip 模块**:包含完整的集成服务,涵盖客户端池(client pool)、会话管理及事件处理。
* **新增 WebSocket 网关**:用于处理 Zulip 的实时事件监听与双向通信。
* **新增安全服务**:支持 API 密钥加密存储及凭据的安全管理。
* **新增配置管理服务**:支持配置热加载(hot-reload),实现动态配置更新。
* **新增错误处理与监控服务**:提升系统的可靠性与可观测性。
* **新增消息过滤服务**:用于内容校验及速率限制(流控)。
* **新增流初始化与会话清理服务**:优化资源管理与回收。
* **完善测试覆盖**:包含单元测试及端到端(e2e)集成测试。
* **完善详细文档**:包括 API 参考手册、配置指南及集成概述。
* **新增地图配置系统**:实现游戏地点与 Zulip Stream(频道)及 Topic(话题)的逻辑映射。
* **新增环境变量配置**:涵盖 Zulip 服务器地址、身份验证及监控相关设置。
* **更新 App 模块**:注册并启用新的 Zulip 集成模块。
* **更新 Redis 接口**:以支持增强型的会话管理功能。
* **实现 WebSocket 协议支持**:确保与 Zulip 之间的实时双向通信。
This commit is contained in:
angjustinl
2025-12-25 22:22:30 +08:00
parent f6fa1ca1e3
commit 55cfda0532
46 changed files with 21488 additions and 2 deletions

View File

@@ -11,6 +11,14 @@ export interface IRedisService {
*/
set(key: string, value: string, ttl?: number): Promise<void>;
/**
* 设置键值对并指定过期时间
* @param key 键
* @param ttl 过期时间(秒)
* @param value 值
*/
setex(key: string, ttl: number, value: string): Promise<void>;
/**
* 获取值
* @param key 键
@@ -46,6 +54,34 @@ export interface IRedisService {
*/
ttl(key: string): Promise<number>;
/**
* 自增
* @param key 键
* @returns 自增后的值
*/
incr(key: string): Promise<number>;
/**
* 添加元素到集合
* @param key 键
* @param member 成员
*/
sadd(key: string, member: string): Promise<void>;
/**
* 从集合移除元素
* @param key 键
* @param member 成员
*/
srem(key: string, member: string): Promise<void>;
/**
* 获取集合所有成员
* @param key 键
* @returns 成员列表
*/
smembers(key: string): Promise<string[]>;
/**
* 清空所有数据
*/