datawhale/whale-town-end
3
4
Fork 2
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
159 Commits 4 Branches 0 Tags
003091494f50e70d790aba177502e41a74ac7713
Commit Graph

159 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
moyin
003091494f docs：升级 OpenAPI 文档配置到 v2.0.0 
- 版本号从 1.1.1 升级到 2.0.0
- 新增聊天系统 (chat) API 标签和说明
- 完善 API 文档描述，包含 WebSocket 连接指南
- 添加 JWT Token 格式要求说明
- 新增开发环境和生产环境服务器配置
- 包含 Zulip 集成和地图系统说明
 2026-01-07 15:07:01 +08:00
moyin
b01ea38a17 config：更新 Zulip 模块配置 
- 注册 ChatController 和 WebSocketDocsController
- 添加聊天系统相关控制器到模块导出
- 完善模块依赖关系配置
 2026-01-07 15:06:40 +08:00
moyin
a30ef52c5a docs：添加 WebSocket API 文档控制器 
- 实现 /websocket/docs 接口提供完整的 WebSocket API 文档
- 实现 /websocket/message-examples 接口提供消息格式示例
- 包含连接配置、认证要求、事件格式说明
- 提供 JavaScript 和 Godot 客户端连接示例
- 包含故障排除指南和测试工具推荐
 2026-01-07 15:05:57 +08:00
moyin
d1fc396db7 api：添加聊天系统 REST API 控制器 
- 实现 /chat/send 消息发送接口（引导使用 WebSocket）
- 实现 /chat/history 聊天历史查询接口
- 实现 /chat/status 系统状态监控接口
- 实现 /chat/websocket/info WebSocket 连接信息接口
- 包含完整的 Swagger API 文档注解
- 集成 JWT 身份验证和错误处理
 2026-01-07 15:05:40 +08:00
moyin
7fd6740090 dto：添加聊天系统相关的数据传输对象 
- 新增 SendChatMessageDto 用于发送聊天消息请求
- 新增 ChatMessageResponseDto 用于消息发送响应
- 新增 GetChatHistoryDto 用于获取聊天历史请求
- 新增 ChatHistoryResponseDto 用于聊天历史响应
- 新增 SystemStatusResponseDto 用于系统状态查询
- 包含完整的 API 文档注解和数据验证规则
 2026-01-07 15:05:21 +08:00
moyin
4bda65d593 fix：修复 ZulipAccounts 实体索引配置错误 
- 将索引字段从数据库列名改为实体属性名
- 修复 zulip_user_id 和 zulip_email 索引配置
- 解决服务启动时的 TypeORM 索引错误
 2026-01-07 15:04:57 +08:00
moyin
179f0f66eb Merge pull request 'feat(login, zulip): 引入 JWT 验证并重构 API 密钥管理' (#34) from ANGJustinl/whale-town-end:zulip_dev into main 
Reviewed-on: #34
 2026-01-07 11:33:24 +08:00
ANGJustinl
1b380e4bb9 Merge branch 'main' into zulip_dev 2026-01-06 19:07:38 +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
07d9c736fa Merge pull request 'feat: 添加JWT认证系统和Zulip用户管理服务' (#32) from feature/jwt-auth-and-zulip-services into main 
Reviewed-on: #32
 2026-01-06 16:54:59 +08:00
moyin
5e1afc2875 Merge branch 'main' into feature/jwt-auth-and-zulip-services 2026-01-06 16:54:52 +08:00
moyin
3733717d1f feat: 添加JWT令牌刷新功能 
- 新增 @nestjs/jwt 和 jsonwebtoken 依赖包
- 实现 refreshAccessToken 方法支持令牌续期
- 添加 RefreshTokenDto 和 RefreshTokenResponseDto
- 新增 /auth/refresh-token 接口
- 完善令牌刷新的限流和超时控制
- 增加相关单元测试覆盖
- 优化错误处理和日志记录
 2026-01-06 16:48:24 +08:00
moyin
470b0b8dbf feat: 添加JWT认证系统和Zulip用户管理服务 
- 新增JWT认证守卫(JwtAuthGuard)和当前用户装饰器(CurrentUser)
- 添加JWT使用示例和完整的认证流程文档
- 实现Zulip用户管理服务，支持用户查询、验证和管理
- 实现Zulip用户注册服务，支持新用户创建和注册流程
- 添加完整的单元测试覆盖
- 新增真实环境测试脚本，验证Zulip API集成
- 更新.gitignore，排除.kiro目录

主要功能:
- JWT令牌验证和用户信息提取
- 用户存在性检查和信息获取
- Zulip API集成和错误处理
- 完整的测试覆盖和文档
 2026-01-06 15:17:05 +08:00
ANGJustinl
c2ecb3c1a7 Merge pull request 'main' (#2) from main into zulip_dev 
Reviewed-on: ANGJustinl/whale-town-end#2
 2026-01-05 17:43:18 +08:00
angjustinl
6ad8d80449 feat(zulip): Add Zulip account management and integrate with auth system 
- Add ZulipAccountsEntity, repository, and module for persistent Zulip account storage
- Create ZulipAccountService in core layer for managing Zulip account lifecycle
- Integrate Zulip account creation into login flow via LoginService
- Add comprehensive test suite for Zulip account creation during user registration
- Create quick test script for validating registered user Zulip integration
- Update UsersEntity to support Zulip account associations
- Update auth module to include Zulip and ZulipAccounts dependencies
- Fix WebSocket connection protocol from ws:// to wss:// in API documentation
- Enhance LoginCoreService to coordinate Zulip account provisioning during authentication
 2026-01-05 17:41:54 +08:00
moyin
fcb81f80d9 Merge pull request 'feat/websocket-remote-connection-fix' (#31) from feat/websocket-remote-connection-fix into main 
Reviewed-on: #31
 2026-01-05 11:23:51 +08:00
moyin
065d3f2fc6 Merge branch 'main' into feat/websocket-remote-connection-fix 2026-01-05 11:23:42 +08:00
moyin
f335b72f6d chore：删除多余的文档 2026-01-05 11:23:07 +08:00
moyin
3bf1b6f474 config：添加nginx WebSocket代理配置文件 
- nginx.conf: 当前生产环境的nginx配置
- nginx_complete_fix.conf: 完整的WebSocket支持配置模板

包含WebSocket升级映射、HTTP重定向、SSL配置等完整方案
支持ws://到wss://的协议升级和重定向处理
 2026-01-05 11:17:16 +08:00
moyin
38f9f81b6c test：添加WebSocket连接诊断和测试工具集 
- test_zulip.js: Zulip集成功能的端到端测试脚本
- full_diagnosis.js: 全面的WebSocket连接诊断工具
- test_protocol_difference.js: 不同协议(ws/wss/http/https)的对比测试
- test_redirect_and_websocket.js: HTTP重定向和WebSocket升级测试
- test_websocket_handshake_redirect.js: WebSocket握手重定向机制验证
- websocket_with_redirect_support.js: 支持重定向的WebSocket连接实现

提供完整的WebSocket连接问题诊断和解决方案
 2026-01-05 11:16:52 +08:00
moyin
4818279fac chore：更新项目依赖和配置 
- 更新WebSocket相关依赖版本
- 优化项目配置以支持远程连接
- 确保依赖兼容性和安全性
 2026-01-05 11:15:30 +08:00
moyin
270e7e5bd2 test：大幅扩展Zulip核心服务的测试覆盖率 
- API密钥安全服务：新增422个测试用例，覆盖加密、解密、验证等核心功能
- 配置管理服务：新增515个测试用例，覆盖配置加载、验证、更新等场景
- 错误处理服务：新增455个测试用例，覆盖各种错误场景和恢复机制
- 监控服务：新增360个测试用例，覆盖性能监控、健康检查等功能

总计新增1752个测试用例，显著提升代码质量和可靠性
 2026-01-05 11:14:57 +08:00
moyin
e282c9dd16 service：完善Zulip服务的连接管理和错误处理 
- 增强WebSocket连接状态监控
- 优化错误处理和重连机制
- 完善服务层的日志记录
- 提升连接稳定性和可靠性

支持远程WebSocket连接的服务层改进
 2026-01-05 11:14:22 +08:00
moyin
d8b7143f60 websocket：增强Zulip WebSocket网关的调试和监控功能 
- 添加详细的连接和断开日志记录
- 增强错误处理和异常捕获机制
- 完善客户端状态管理和会话跟踪
- 优化消息处理的调试输出

提升WebSocket连接问题的诊断能力
 2026-01-05 11:14:04 +08:00
moyin
6002f53cbc config：优化WebSocket远程连接的CORS配置 
- 明确指定允许的域名列表，包括生产环境域名
- 添加Vite开发服务器端口支持
- 完善CORS方法和头部配置，确保WebSocket握手正常
- 支持xinghangee.icu子域名的通配符匹配

修复远程域名WebSocket连接问题的核心配置
 2026-01-05 11:13:43 +08:00
moyin
9cb172d645 Merge pull request 'refactor：重构安全模块架构，将security模块迁移至core层' (#30) from refactor/security-core-module into main 
Reviewed-on: #30
 2026-01-04 19:35:10 +08:00
moyin
70c020a97c refactor：重构安全模块架构，将security模块迁移至core层 
- 将src/business/security模块迁移至src/core/security_core
- 更新模块导入路径和依赖关系
- 统一安全相关组件的命名规范（content_type.middleware.ts）
- 清理过时的配置文件和文档
- 更新架构文档以反映新的模块结构

此次重构符合业务功能模块化架构设计原则，将技术基础设施
服务统一放置在core层，提高代码组织的清晰度和可维护性。
 2026-01-04 19:34:16 +08:00
moyin
67ade48ad7 Merge pull request 'docs：更新贡献者信息和项目里程碑' (#29) from docs/update-contributors-info into main 
Reviewed-on: #29
 2025-12-31 16:16:34 +08:00
moyin
29b8b05a2a docs：更新贡献者信息和项目里程碑 
- 更新所有贡献者的提交数统计（moyin: 112, jianuo: 11, angjustinl: 7）
- 添加最新重要贡献记录，包括Zulip模块架构重构和文档体系优化
- 更新项目里程碑，记录12月31日的重大架构重构
- 完善贡献者的主要贡献描述，反映最新的工作成果

本次更新确保贡献者信息与实际提交记录保持一致
 2025-12-31 16:14:23 +08:00
moyin
bbf3476d75 Merge pull request 'ANGJustinl-zulip_dev' (#28) from ANGJustinl/whale-town-end:ANGJustinl-zulip_dev into main 
Reviewed-on: #28
 2025-12-31 16:08:12 +08:00
moyin
faf93a30e1 chore：更新配置文件和项目文档 
- 更新tsconfig.json配置以支持新的模块结构
- 添加REFACTORING_SUMMARY.md记录重构过程
- 更新git_commit_guide.md完善提交规范
- 添加相关图片资源

这些配置和文档更新支持项目架构重构后的正常运行
 2025-12-31 15:45:26 +08:00
moyin
2d10131838 refactor：重构Zulip模块按业务功能模块化架构 
- 将技术实现服务从business层迁移到core层
- 创建src/core/zulip/核心服务模块，包含API客户端、连接池等技术服务
- 保留src/business/zulip/业务逻辑，专注游戏相关的业务规则
- 通过依赖注入实现业务层与核心层的解耦
- 更新模块导入关系，确保架构分层清晰

重构后的架构符合单一职责原则，提高了代码的可维护性和可测试性
 2025-12-31 15:44:36 +08:00
moyin
5140bd1a54 docs：优化项目文档结构和架构说明 
- 优化主README.md的文件结构总览，采用总分结构设计
- 大幅改进docs/ARCHITECTURE.md，详细说明业务功能模块化架构
- 新增docs/DOCUMENT_CLEANUP.md记录文档清理过程
- 更新docs/README.md添加新文档的导航链接

本次更新完善了项目文档体系，便于开发者快速理解项目架构
 2025-12-31 15:43:15 +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
daaf5c3f22 Merge branch 'main' into zulip_dev 
* main: (31 commits)
  docs：更新README中的测试说明
  chore：整理API测试脚本
  test：添加验证码冷却时间清除功能测试
  feat：集成验证码冷却时间自动清除机制
  feat：添加验证码冷却时间清除功能
  api：更新登录验证码接口Swagger注解
  docs：更新登录验证码邮件模板修复相关文档
  test：添加登录验证码邮件发送测试
  fix：修复登录验证码邮件模板错误
  feat: 邮箱冲突检测优化 v1.1.1
  docs: 更新API文档，反映HTTP状态码修复
  fix: 修复用户注册冲突错误的HTTP状态码问题
  chore: 升级版本到1.1.0
  feat(docs): 更新OpenAPI文档，添加验证码登录和完整接口定义
  fix(docs): 修正API文档中的错误码和验证码说明
  docs: 完善API文档，添加验证码登录功能说明
  fix：修复注册逻辑和HTTP状态码问题
  fix：修复API状态码和限流配置问题
  chore: 清理旧文件和更新项目配置
  refactor: 更新核心服务和应用配置
  ...
 2025-12-25 23:27:24 +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
moyin
dd856b9ba6 Merge pull request 'fix/login-verification-email-template' (#26) from fix/login-verification-email-template into main 
Reviewed-on: #26
 2025-12-25 20:57:25 +08:00
moyin
07601b6d79 docs：更新README中的测试说明 
- 更新快速测试部分，使用新的综合测试脚本
- 添加测试脚本的参数说明（跳过限流测试、自定义服务器等）
- 更新测试内容列表，包含新增的功能测试
- 统一测试命令，简化开发者使用流程
 2025-12-25 20:51:00 +08:00
moyin
7429de3cf4 chore：整理API测试脚本 
- 移除分散的旧测试脚本（test-api.ps1, test-api.sh, test-register-fix.ps1, test-throttle.ps1）
- 添加统一的综合测试脚本（test-comprehensive.ps1）
- 新脚本支持更多功能：跳过限流测试、自定义服务器地址等
- 提供更完整的API功能测试覆盖
 2025-12-25 20:50:29 +08:00
moyin
0192934c66 test：添加验证码冷却时间清除功能测试 
为新增的验证码冷却时间清除功能添加全面的测试用例：

验证服务测试：
- 测试成功清除冷却时间
- 测试清除不存在的冷却时间
- 测试Redis操作错误处理
- 测试不同类型和标识符的冷却时间清除

登录核心服务测试：
- 测试注册成功后自动清除冷却时间
- 测试密码重置成功后自动清除冷却时间
- 测试验证码登录成功后自动清除冷却时间
- 测试冷却时间清除失败的优雅处理
 2025-12-25 20:49:16 +08:00
moyin
64370c3206 feat：集成验证码冷却时间自动清除机制 
在用户成功完成关键操作后自动清除验证码冷却时间：
- 用户注册成功后清除邮箱验证码冷却时间
- 密码重置成功后清除密码重置验证码冷却时间
- 验证码登录成功后清除登录验证码冷却时间

清除失败不影响主流程，只记录警告日志，确保用户体验。
 2025-12-25 20:48:53 +08:00
moyin
a78df48101 feat：添加验证码冷却时间清除功能 
新增 clearCooldown 方法，用于在用户成功完成操作后
清除验证码冷却时间，提升用户体验：
- 注册成功后清除邮箱验证码冷却时间
- 密码重置成功后清除重置验证码冷却时间
- 验证码登录成功后清除登录验证码冷却时间
 2025-12-25 20:48:15 +08:00
moyin
0005dc773c api：更新登录验证码接口Swagger注解 
更新发送登录验证码接口的ApiOperation描述，
明确说明邮件使用专门的登录验证码模板，
内容标识为登录验证而非密码重置。
 2025-12-25 20:41:00 +08:00
moyin
946d328be6 docs：更新登录验证码邮件模板修复相关文档 
- 在API文档重要提醒中添加邮件模板修复说明
- 更新OpenAPI文档版本号至1.1.3
- 增强发送登录验证码接口的描述，明确说明使用专门的登录验证码模板
 2025-12-25 20:40:45 +08:00
moyin
841a58886e test：添加登录验证码邮件发送测试 
为修复的登录验证码邮件模板功能添加专门的测试用例：
- 测试登录验证码邮件发送功能
- 验证邮件模板内容包含正确的登录验证码信息
- 确保邮件主题和内容符合预期
 2025-12-25 20:40:27 +08:00
moyin
91565f716d fix：修复登录验证码邮件模板错误 
登录验证码发送时错误地使用了密码重置邮件模板，
导致用户收到的邮件内容显示为'密码重置'而不是'登录验证码'。

修改 EmailService.sendVerificationCode 方法，
当 purpose 为 'login_verification' 时使用正确的
getLoginVerificationTemplate 方法而不是 getPasswordResetTemplate。
 2025-12-25 20:40:08 +08:00
moyin
417b01323e Merge pull request 'feature/email-conflict-detection-v1.1.1' (#25) from feature/email-conflict-detection-v1.1.1 into main 
Reviewed-on: #25
 2025-12-25 18:33:58 +08:00
moyin
b3de6dec5f Merge branch 'main' into feature/email-conflict-detection-v1.1.1 2025-12-25 18:33:47 +08:00
moyin
d683f0d5da feat: 邮箱冲突检测优化 v1.1.1 
- 新增邮箱冲突检测：发送验证码前检查邮箱是否已被注册
- 优化用户体验：避免向已注册邮箱发送无用验证码
- 改进错误处理：返回409 Conflict状态码和明确错误信息
- 更新API文档：重新整理文档结构，突出前端开发要点
- 完善测试用例：添加邮箱冲突检测相关测试
- 版本升级：1.1.0  1.1.1

核心修改：
- src/core/login_core/login_core.service.ts: 在sendEmailVerification方法中添加邮箱存在性检查
- src/business/auth/controllers/login.controller.ts: 正确处理409冲突状态码
- docs/api/api-documentation.md: 重新整理为精简实用的前端开发文档
- docs/api/openapi.yaml: 更新版本和接口描述
- test-register-fix.ps1: 添加邮箱冲突检测测试用例
 2025-12-25 18:31:36 +08:00
moyin
aae77866ac docs: 更新API文档，反映HTTP状态码修复 
文档更新内容：
- 更新注册接口响应示例，区分400和409状态码
- 添加资源冲突响应示例（用户名、邮箱、手机号已存在）
- 完善OpenAPI文档，添加详细的响应示例
- 更新错误码表格，明确不同错误的状态码
- 添加HTTP状态码测试场景

 修复说明：
- 409 Conflict：用户名/邮箱/手机号已存在
- 400 Bad Request：验证码错误/参数格式错误
- 符合RESTful API规范

 测试验证：
- 邮箱冲突：HTTP 409
- 用户名冲突：HTTP 409
- 验证码错误：HTTP 400

 前端开发者现在可以：
- 根据HTTP状态码进行精确的错误处理
- 移除临时解决方案，使用标准状态码判断
- 提供更好的用户体验和错误提示
 2025-12-25 16:32:51 +08:00