moyin
ed04b8c92d
docs(zulip): 完善Zulip业务模块功能文档
...
范围: src/business/zulip/README.md
- 补充对外提供的接口章节（14个公共方法）
- 添加使用的项目内部依赖说明（7个依赖）
- 完善核心特性描述（5个特性）
- 添加潜在风险评估（4个风险及缓解措施）
- 优化文档结构和内容完整性
2026-01-15 10:53:04 +08:00
moyin
efac782243
style(zulip): 优化zulip业务模块代码规范
...
范围：src/business/zulip/
- 统一命名规范和注释格式
- 完善JSDoc注释和参数说明
- 优化代码结构和缩进
- 清理未使用的导入和变量
- 更新修改记录和版本信息
2026-01-12 19:42:38 +08:00
moyin
d04ab7f75f
CRITICAL ISSUES: Database management service with major problems
...
WARNING: This commit contains code with significant issues that need immediate attention:
1. Type Safety Issues:
- Unused import ZulipAccountsService causing compilation warnings
- Implicit 'any' type in formatZulipAccount method parameter
- Type inconsistencies in service injections
2. Service Integration Problems:
- Inconsistent service interface usage
- Missing proper type definitions for injected services
- Potential runtime errors due to type mismatches
3. Code Quality Issues:
- Violation of TypeScript strict mode requirements
- Inconsistent error handling patterns
- Missing proper interface implementations
Files affected:
- src/business/admin/database_management.service.ts (main issue)
- Multiple test files and service implementations
- Configuration and documentation updates
Next steps required:
1. Fix TypeScript compilation errors
2. Implement proper type safety
3. Resolve service injection inconsistencies
4. Add comprehensive error handling
5. Update tests to match new implementations
Impact: High - affects admin functionality and system stability
Priority: Urgent - requires immediate review and fixes
Author: moyin
Date: 2026-01-10
2026-01-10 19:27:28 +08:00
moyin
75ac7ac0f8
websocket：统一WebSocket网关配置
...
- 为CleanWebSocketGateway添加/game路径配置
- 支持通过环境变量WEBSOCKET_PORT配置端口
- 移除ZulipWebSocketGateway的模块引用
- 统一使用CleanWebSocketGateway作为唯一WebSocket网关
- 更新模块注释，反映当前架构
2026-01-09 17:45:51 +08:00
moyin
e9dc887c59
feat: 移除Socket.IO依赖，实现原生WebSocket支持
...
- 移除所有Socket.IO相关装饰器和依赖
- 创建CleanWebSocketGateway使用原生WebSocket Server
- 实现完整的多客户端实时同步功能
- 支持地图房间分组管理
- 支持本地和全局消息广播
- 支持位置更新实时同步
- 更新API文档和连接信息
- 完成多客户端同步测试验证
技术改进:
- 使用原生ws库替代Socket.IO，减少依赖
- 实现更高效的消息路由和广播机制
- 添加地图房间自动管理功能
- 提供实时连接统计和监控接口
测试验证:
- 多客户端连接和认证
- 聊天消息实时同步
- 位置更新广播
- 地图房间分组
- 系统状态监控
2026-01-09 17:00:23 +08:00
moyin
0f37130832
refactor：重构业务层服务架构
...
- 重构共享模块，移除冗余DTO定义
- 优化Zulip服务模块，重新组织控制器结构
- 更新用户管理和认证服务
- 移除过时的登录服务测试文件
2026-01-08 23:05:13 +08:00
moyin
bb796a2469
refactor：项目架构重构和命名规范化
...
- 统一文件命名为snake_case格式（kebab-case snake_case）
- 重构zulip模块为zulip_core，明确Core层职责
- 重构user-mgmt模块为user_mgmt，统一命名规范
- 调整模块依赖关系，优化架构分层
- 删除过时的文件和目录结构
- 更新相关文档和配置文件
本次重构涉及大量文件重命名和模块重组，
旨在建立更清晰的项目架构和统一的命名规范。
2026-01-08 00:14:14 +08:00
moyin
b01ea38a17
config：更新 Zulip 模块配置
...
- 注册 ChatController 和 WebSocketDocsController
- 添加聊天系统相关控制器到模块导出
- 完善模块依赖关系配置
2026-01-07 15:06:40 +08:00
angjustinl
8f9a6e7f9d
feat(login, zulip): 引入 JWT 验证并重构 API 密钥管理
...
### 详细变更描述
* **修复 JWT 签名冲突**：重构 `LoginService.generateTokenPair()`，移除载荷（Payload）中的 `iss` (issuer) 与 `aud` (audience) 字段，解决签名校验失败的问题。
* **统一验证逻辑**：更新 `ZulipService` 以调用 `LoginService.verifyToken()`，消除重复的 JWT 校验代码，确保逻辑单一职责化（Single Responsibility）。
* **修复硬编码 API 密钥问题**：消息发送功能不再依赖静态配置，改为从 Redis 动态读取用户真实的 API 密钥。
* **解耦依赖注入**：在 `ZulipModule` 中注入 `AuthModule` 依赖，以支持标准的 Token 验证流程。
* **完善技术文档**：补充了关于 JWT 验证流程及 API 密钥管理逻辑的详细文档。
* **新增测试工具**：添加 `test-get-messages.js` 脚本，用于验证通过 WebSocket 接收消息的功能。
* **更新自动化脚本**：同步更新了 API 密钥验证及用户注册校验的快速测试脚本。
* **端到端功能验证**：确保消息发送逻辑能够正确映射并调用用户真实的 Zulip API 密钥。
2026-01-06 18:51:37 +08:00
moyin
2d10131838
refactor：重构Zulip模块按业务功能模块化架构
...
- 将技术实现服务从business层迁移到core层
- 创建src/core/zulip/核心服务模块，包含API客户端、连接池等技术服务
- 保留src/business/zulip/业务逻辑，专注游戏相关的业务规则
- 通过依赖注入实现业务层与核心层的解耦
- 更新模块导入关系，确保架构分层清晰
重构后的架构符合单一职责原则，提高了代码的可维护性和可测试性
2025-12-31 15:44:36 +08:00
angjustinl
3dd5f23d79
fix(zulip): Fix e2e test errors and pdate author attribution across all Zulip integration files
...
- Standardize author attribution across 27 files in the Zulip integration module
- Maintain consistent code documentation and authorship tracking
2025-12-25 23:37:26 +08:00
angjustinl
55cfda0532
feat(zulip): 添加全面的 Zulip 集成系统
...
* **新增 Zulip 模块**：包含完整的集成服务，涵盖客户端池（client pool）、会话管理及事件处理。
* **新增 WebSocket 网关**：用于处理 Zulip 的实时事件监听与双向通信。
* **新增安全服务**：支持 API 密钥加密存储及凭据的安全管理。
* **新增配置管理服务**：支持配置热加载（hot-reload），实现动态配置更新。
* **新增错误处理与监控服务**：提升系统的可靠性与可观测性。
* **新增消息过滤服务**：用于内容校验及速率限制（流控）。
* **新增流初始化与会话清理服务**：优化资源管理与回收。
* **完善测试覆盖**：包含单元测试及端到端（e2e）集成测试。
* **完善详细文档**：包括 API 参考手册、配置指南及集成概述。
* **新增地图配置系统**：实现游戏地点与 Zulip Stream（频道）及 Topic（话题）的逻辑映射。
* **新增环境变量配置**：涵盖 Zulip 服务器地址、身份验证及监控相关设置。
* **更新 App 模块**：注册并启用新的 Zulip 集成模块。
* **更新 Redis 接口**：以支持增强型的会话管理功能。
* **实现 WebSocket 协议支持**：确保与 Zulip 之间的实时双向通信。
2025-12-25 22:22:30 +08:00
