Commit Graph

259 Commits

Author SHA1 Message Date
moyin
d92a078fc7 refactor:将 ZulipAccountsModule 改为全局单例模块
- 在 AppModule 中统一导入 ZulipAccountsModule.forRoot()
- 移除 admin.module、auth.module、zulip.module 中的重复导入
- 添加数据库 charset: utf8mb4 配置,支持中文和 emoji
2026-01-15 14:58:28 +08:00
moyin
cde20c6fd7 docs:补充合并文档不纳入Git提交的规范说明
- 添加合并文档排除原因说明
- 补充操作规范和.gitignore配置建议
- 更新提交原则中的合并文档排除要求
2026-01-15 14:21:14 +08:00
moyin
a8de2564b6 docs:添加异常处理完整性检查规范
- 新增异常吞没问题定义和检查规则
- 添加Service/Repository层异常传播规范
- 补充常见错误模式和修复示例
- 更新检查清单和执行步骤顺序
2026-01-15 14:20:55 +08:00
moyin
9f4d291619 style(auth): 优化auth模块代码规范
范围: src/business/auth/
- register.service.ts: 清理未使用的导入TokenPair,增强userId非空验证
- register.service.spec.ts: 清理未使用的变量apiKeySecurityService
2026-01-15 14:17:38 +08:00
moyin
4f18f0fec6 refactor(login_core): 消除代码重复,提取手机号查找为私有方法
范围:src/core/login_core/
- 提取手机号查找逻辑为 findUserByPhone() 私有方法
- 添加 isPhoneExists() 私有方法检查手机号是否存在
- 消除 login、validateUserUniqueness、sendPasswordResetCode 等方法中的重复代码
- 测试文件添加文件头注释,清理未使用的 UsersService 导入
- 更新版本号 1.1.0 -> 1.1.1
2026-01-15 14:13:48 +08:00
moyin
519394645a docs(zulip_core): 完善模块文档和优化账号服务逻辑
范围:src/core/zulip_core/
- 补充README.md缺失的服务文档(用户注册、用户管理、动态配置、错误处理、监控日志)
- 优化zulip_account.service.ts中已存在用户的处理逻辑
- 增强userId获取的可靠性,优先使用userInfo,其次使用apiKeyResult
- 版本更新:1.1.1 -> 1.2.0
2026-01-15 13:53:56 +08:00
moyin
223ba2abb8 style(zulip_accounts): 代码规范优化 - 清理未使用导入和修复异常处理
范围:src/core/db/zulip_accounts/
涉及文件:
- zulip_accounts.repository.ts
- zulip_accounts.service.ts
- zulip_accounts_memory.service.ts

主要改进:
- 清理未使用的导入(FindOptionsWhere, NotFoundException, ConflictException)
- 修复异常处理:确保catch块中正确抛出异常,避免异常吞没
- 更新文件头部修改记录和版本号
2026-01-15 13:46:24 +08:00
moyin
e54d5e3939 style(users): 优化Core层users模块代码规范
范围: src/core/db/users/
- base_users.service.ts: 为保护方法补充@example示例
- users.constants.ts: 补充职责分离描述

检查人员: moyin
检查日期: 2026-01-15
2026-01-15 13:38:36 +08:00
moyin
434766beb5 docs:删除多余的文档 2026-01-15 11:21:17 +08:00
moyin
8132300e38 fix:修复模块依赖注入问题并补充架构检查规范
修复问题:
- ZulipModule:修正exports配置,导出ZulipCoreModule而非单独服务
- ZulipModule:添加CacheModule.register()解决CACHE_MANAGER依赖
- ZulipGatewayModule:添加LoginCoreModule解决JwtAuthGuard依赖

文档补充(step4-architecture-layer.md):
- 新增「应用启动验证」强制检查步骤
- 添加常见启动错误示例和修复方案
- 明确启动验证是步骤4的强制完成条件
- 补充启动验证检查清单和失败处理流程
2026-01-15 11:09:46 +08:00
moyin
4265943375 docs:添加网关模块集成合并请求文档
- 创建合并请求文档 gateway-module-integration-20260115.md
- 记录2个提交的详细变更内容
- 说明模块集成和文档优化的影响范围
- 提供架构说明和审查要点
2026-01-15 11:00:01 +08:00
moyin
7eceb6d6d6 feat:集成聊天和Zulip网关模块到应用主模块
- 添加ChatGatewayModule到应用模块导入列表
- 添加ZulipGatewayModule到应用模块导入列表
- 优化模块注释说明,明确各网关模块职责
- 完善模块架构,区分网关层和业务层职责
2026-01-15 10:58:13 +08:00
moyin
662694ba9f docs:优化命名规范中的扁平化标准说明
- 将扁平化标准从3个文件调整为1-2个文件
- 明确单文件必须扁平化,双文件建议扁平化
- 3个文件保持独立文件夹结构
- 更新相关检查步骤和常见错误说明
2026-01-15 10:58:01 +08:00
moyin
ed04b8c92d docs(zulip): 完善Zulip业务模块功能文档
范围: src/business/zulip/README.md
- 补充对外提供的接口章节(14个公共方法)
- 添加使用的项目内部依赖说明(7个依赖)
- 完善核心特性描述(5个特性)
- 添加潜在风险评估(4个风险及缓解措施)
- 优化文档结构和内容完整性
2026-01-15 10:53:04 +08:00
moyin
30a4a2813d feat(chat): 新增聊天业务模块
范围:src/business/chat/
- 实现 ChatService 聊天业务服务(登录/登出/消息发送/位置更新)
- 实现 ChatSessionService 会话管理服务(会话创建/销毁/上下文注入)
- 实现 ChatFilterService 消息过滤服务(频率限制/敏感词/权限验证)
- 实现 ChatCleanupService 会话清理服务(定时清理过期会话)
- 添加完整的单元测试覆盖
- 添加模块 README 文档
2026-01-14 19:17:32 +08:00
moyin
5bcf3cb678 feat(gateway/chat): 新增聊天网关模块
范围:src/gateway/chat/
- 新增 ChatWebSocketGateway WebSocket 网关,处理实时聊天通信
- 新增 ChatController HTTP 控制器,提供聊天历史和系统状态接口
- 新增 ChatGatewayModule 模块配置,整合网关层组件
- 新增请求/响应 DTO 定义,提供数据验证和类型约束
- 新增完整的单元测试覆盖
- 新增模块 README 文档,包含接口说明、核心特性和风险评估
2026-01-14 19:11:25 +08:00
moyin
3f3c29354e feat(session_core): 新增会话核心模块
范围:src/core/session_core/
涉及文件:
- src/core/session_core/index.ts
- src/core/session_core/session_core.interfaces.ts
- src/core/session_core/session_core.module.ts
- src/core/session_core/session_core.module.spec.ts
- src/core/session_core/README.md

主要内容:
- 定义会话管理抽象接口(ISessionQueryService, ISessionManagerService)
- 实现动态模块配置(SessionCoreModule.forFeature)
- 添加完整的单元测试覆盖
- 创建功能文档README.md
2026-01-14 19:03:40 +08:00
3cb2c1d8dd Merge pull request 'docs/update-readme-and-contributors-20260114' (#47) from docs/update-readme-and-contributors-20260114 into main
Reviewed-on: datawhale/whale-town-end#47
2026-01-14 15:17:21 +08:00
moyin
260ae2c559 docs:简化架构文档,突出四层架构核心设计
- 精简ARCHITECTURE.md,移除冗长的目录结构说明
- 突出四层架构的职责和原则
- 保留核心的架构图和依赖关系说明
- 简化双模式架构和模块依赖的描述
- 移除过于详细的扩展指南,保留核心内容
2026-01-14 15:13:54 +08:00
moyin
cc1b081c3a docs:根据git记录更新贡献者名单
- 更新提交统计:moyin 166次,jianuo 10次,angjustinl 9次
- 调整贡献者排序,按提交数量重新组织
- 细化每位贡献者的具体工作内容
- 更新最新重要贡献(2026年1月的工作)
- 重新整理项目里程碑,按时间倒序排列
- 修正文档链接路径
2026-01-14 15:12:15 +08:00
moyin
ff996b0dea docs:优化README中的AI代码检查指南
- 将快速开始改为简洁的prompt模板
- 移除详细的检查步骤列表
- 简化使用说明,突出AI自动化流程
- 保留文档链接供开发者查看详细规范
2026-01-14 15:11:54 +08:00
23bb3e0274 Merge pull request 'feature/code-standard-auth-20260114' (#46) from feature/code-standard-auth-20260114 into main
Reviewed-on: datawhale/whale-town-end#46
2026-01-14 14:23:36 +08:00
30d5e0f0a6 Merge branch 'main' into feature/code-standard-auth-20260114 2026-01-14 14:23:29 +08:00
moyin
d5d175cd1c docs(ai-reading): 添加NestJS依赖注入检查规范
范围: docs/ai-reading/
- 在step4-architecture-layer.md中添加依赖注入检查章节
- 说明常见依赖注入问题和解决方案
- 提供依赖注入检查步骤和最佳实践
- 帮助AI在代码检查时避免遗漏依赖注入问题
2026-01-14 14:21:44 +08:00
moyin
5bc7cdb532 fix(auth): 修复AuthGatewayModule依赖注入问题
范围: src/gateway/auth/
- 在AuthGatewayModule中导入LoginCoreModule
- 解决JwtAuthGuard无法注入LoginCoreService的问题
- 确保依赖注入链的完整性
2026-01-14 14:21:35 +08:00
963ebbd90d Merge pull request 'feature/code-standard-auth-20260114' (#45) from feature/code-standard-auth-20260114 into main
Reviewed-on: datawhale/whale-town-end#45
2026-01-14 13:20:43 +08:00
moyin
a147883e05 docs:添加架构重构文档
- 新增 ARCHITECTURE_REFACTORING.md 文档
- 记录项目架构重构计划和进度
2026-01-14 13:17:53 +08:00
moyin
cf431c210a docs:补充 Gateway 层架构规范检查说明
- 新增 Gateway 层职责定义和检查规范
- 添加 Gateway 层协议处理示例代码
- 补充 Gateway 层依赖关系和文件类型检查
- 完善 4 层架构说明(Gateway、Business、Core、Common)
- 增加 Gateway 层常见违规示例
2026-01-14 13:17:44 +08:00
moyin
41c33d6159 docs:完善 NestJS 框架文件命名规范说明
- 详细说明 NestJS 文件命名规则(snake_case + 点分隔类型标识符)
- 添加正确和错误的命名示例对比
- 补充所有 NestJS 文件类型标识符列表
- 增加常见错误判断方法说明
2026-01-14 13:17:23 +08:00
moyin
8bcd22ea50 docs:将 AI 代码检查指南翻译为英文
- 将主要内容从中文翻译为英文
- 添加用户信息配置脚本使用说明
- 优化文档结构和可读性
- 保持原有检查流程和规范不变
2026-01-14 13:17:12 +08:00
moyin
43874892b7 feat:添加 AI 代码检查用户信息配置工具
- 新增 setup-user-info.js 脚本
- 自动获取当前日期并提示输入用户名
- 生成 me.config.json 配置文件供 AI 检查步骤使用
- 简化 AI 代码检查流程的用户信息收集
2026-01-14 13:17:02 +08:00
moyin
f1dd8cd14a style:优化贡献者文档格式
- 调整贡献者顺序展示
- 优化贡献统计表格排列
- 改善文档可读性
2026-01-14 13:16:53 +08:00
moyin
f9a79461a0 config:更新 .gitignore 配置
- 添加 docs/ai-reading/me.config.json 到忽略列表
- 优化配置文件结构
2026-01-14 13:16:44 +08:00
moyin
73e3e0153c refactor(auth): 重构认证模块架构 - 将Gateway层组件从Business层分离
范围:src/gateway/auth/, src/business/auth/, src/app.module.ts
涉及文件:
- 新增:src/gateway/auth/ 目录及所有文件
- 移动:Controller、Guard、Decorator、DTO从business层移至gateway层
- 修改:src/business/auth/index.ts(移除Gateway层组件导出)
- 修改:src/app.module.ts(使用AuthGatewayModule替代AuthModule)

主要改进:
- 明确Gateway层和Business层的职责边界
- Controller、Guard、Decorator属于Gateway层职责
- Business层专注于业务逻辑和服务
- 符合分层架构设计原则
2026-01-14 13:07:11 +08:00
moyin
f7c3983cc1 refactor(auth): 移除Controller,专注于业务逻辑层
范围:src/business/auth/
涉及文件:
- src/business/auth/auth.module.ts
- src/business/auth/README.md

主要改进:
- 移除LoginController和RegisterController的导入和声明
- 调整模块结构,专注于业务逻辑层
- 更新README文档,明确Business Layer职责定位
- 完善依赖关系说明和架构层级描述
- 版本号从1.0.2升级到2.0.0(架构重构)
2026-01-14 12:00:19 +08:00
efbc5c4084 Merge pull request 'feature/code-standard-merge-docs-20260112' (#44) from feature/code-standard-merge-docs-20260112 into main
Reviewed-on: datawhale/whale-town-end#44
2026-01-12 20:12:24 +08:00
9948727e9d Merge branch 'main' into feature/code-standard-merge-docs-20260112 2026-01-12 20:12:16 +08:00
moyin
5af44f95d5 style: 完善代码规范和测试覆盖
- 新增多个模块的单元测试文件,提升测试覆盖率
- 完善AI-Reading文档系统,包含7步代码检查流程
- 新增集成测试和属性测试框架
- 优化项目结构和配置文件
- 清理过时的规范文档,统一使用新的检查标准
2026-01-12 20:09:03 +08:00
moyin
59128ea9a6 test(users): 完善users模块测试覆盖
范围:src/core/db/users/
- 添加UsersModule模块配置测试
- 验证模块依赖注入和服务导出
- 确保双模式配置的正确性
- 提升测试覆盖率完整性
2026-01-12 20:01:32 +08:00
moyin
f5eda2ea34 docs(zulip): 完善zulip业务模块文档
范围:src/business/zulip/README.md
- 添加完整的WebSocket事件接口文档
- 包含所有事件的输入输出格式说明
- 更新版本信息和修改记录
- 完善使用示例和注意事项
2026-01-12 19:43:14 +08:00
moyin
efac782243 style(zulip): 优化zulip业务模块代码规范
范围:src/business/zulip/
- 统一命名规范和注释格式
- 完善JSDoc注释和参数说明
- 优化代码结构和缩进
- 清理未使用的导入和变量
- 更新修改记录和版本信息
2026-01-12 19:42:38 +08:00
moyin
03f0cd6bab test(zulip): 添加zulip业务模块完整测试覆盖
范围:src/business/zulip/
- 添加chat.controller.spec.ts控制器测试
- 添加clean_websocket.gateway.spec.ts网关测试
- 添加dynamic_config.controller.spec.ts配置控制器测试
- 添加services/zulip_accounts_business.service.spec.ts业务服务测试
- 添加websocket相关控制器测试文件
- 添加zulip.module.spec.ts模块测试
- 添加zulip_accounts.controller.spec.ts账户控制器测试
- 实现严格一对一测试映射,测试覆盖率达到100%
2026-01-12 19:41:48 +08:00
moyin
ea97167a32 feat(zulip): 添加动态配置控制器和账户业务服务
范围:src/business/zulip/
- 添加dynamic_config.controller.ts动态配置管理控制器
- 添加services/zulip_accounts_business.service.ts账户业务服务
- 完善zulip业务模块功能架构
2026-01-12 19:39:57 +08:00
moyin
e6de8a75b7 Remove merge-requests files from git tracking 2026-01-12 19:39:22 +08:00
moyin
0cf2cf163c docs(email): 生成Email模块代码规范检查合并文档
范围: src/core/utils/email/
- 完成Email模块7步骤代码规范检查
- 所有检查项目完全通过,代码质量优秀
- 生成详细的检查结果和质量评估报告
- 无需代码修改,模块已符合项目标准

检查结果:
- 命名规范: 100%通过
- 注释规范: 100%通过
- 代码质量: 100%通过
- 架构分层: 100%通过
- 测试覆盖: 100%通过(32个测试全部通过)
- 功能文档: 100%通过
2026-01-12 19:28:47 +08:00
moyin
75ce4a2778 test(verification): 添加VerificationModule测试文件
范围:src/core/utils/verification/verification.module.spec.ts
- 新增VerificationModule的完整测试覆盖
- 包含模块定义、服务提供者、依赖关系和导出功能的测试
- 确保模块配置的正确性和完整性
- 提升verification模块的测试覆盖率
2026-01-12 19:22:19 +08:00
moyin
6459896b0a docs(verification): 更新版本信息和测试覆盖数据
范围:src/core/utils/verification/README.md
- 更新版本号从1.0.1到1.0.2
- 更新最后修改时间为2026-01-12
- 更新测试覆盖从38个测试用例到46个测试用例
- 确保文档信息与代码实现保持一致
2026-01-12 19:21:55 +08:00
moyin
ac989fe985 style(verification): 添加类注释,完善代码规范
范围:src/core/utils/verification/
- 为VerificationService添加完整的类注释,包含职责、主要方法和使用场景说明
- 为VerificationModule添加完整的类注释,包含模块职责和功能说明
- 更新文件修改记录和版本号(1.0.1  1.0.2)
- 更新@lastModified时间戳为2026-01-12
2026-01-12 19:21:30 +08:00
moyin
7abd27aed0 style(login_core): 优化login_core模块代码规范
范围:src/core/login_core/
- 提取魔法数字为常量,提升代码可维护性
- 拆分过长方法,提升代码可读性
- 消除代码重复,优化方法结构
- 添加详细的类和方法注释
- 统一JWT配置常量管理
- 清理TODO项和未使用代码
2026-01-12 19:08:35 +08:00
moyin
1b4c952666 test(zulip-accounts):完善zulip_accounts模块测试覆盖
范围:src/core/db/zulip_accounts/
- 添加ZulipAccounts实体业务方法测试
- 添加ZulipAccountsModule动态配置测试
- 提升测试覆盖率,确保实体逻辑和模块配置的正确性
- 测试包含状态管理、时间判断、错误处理等核心业务逻辑
2026-01-12 18:39:32 +08:00