feat(chat): 新增聊天业务模块

范围:src/business/chat/
- 实现 ChatService 聊天业务服务(登录/登出/消息发送/位置更新)
- 实现 ChatSessionService 会话管理服务(会话创建/销毁/上下文注入)
- 实现 ChatFilterService 消息过滤服务(频率限制/敏感词/权限验证)
- 实现 ChatCleanupService 会话清理服务(定时清理过期会话)
- 添加完整的单元测试覆盖
- 添加模块 README 文档
This commit is contained in:
moyin
2026-01-14 19:17:32 +08:00
parent 5bcf3cb678
commit 30a4a2813d
11 changed files with 3298 additions and 0 deletions

View File

@@ -0,0 +1,71 @@
/**
* 聊天业务模块
*
* 功能描述:
* - 整合聊天相关的业务逻辑服务
* - 提供会话管理、消息过滤、清理等功能
* - 通过 SESSION_QUERY_SERVICE 接口向其他模块提供会话查询能力
*
* 架构层级Business Layer业务层
*
* 依赖关系:
* - 依赖 ZulipCoreModule核心层提供Zulip技术服务
* - 依赖 RedisModule核心层提供缓存服务
* - 依赖 LoginCoreModule核心层提供Token验证
*
* 导出接口:
* - SESSION_QUERY_SERVICE: 会话查询接口(供其他 Business 模块使用)
*
* 最近修改:
* - 2026-01-14: 代码规范优化 - 完善文件头注释规范 (修改者: moyin)
*
* @author moyin
* @version 1.1.1
* @since 2026-01-14
* @lastModified 2026-01-14
*/
import { Module } from '@nestjs/common';
import { ChatService } from './chat.service';
import { ChatSessionService } from './services/chat_session.service';
import { ChatFilterService } from './services/chat_filter.service';
import { ChatCleanupService } from './services/chat_cleanup.service';
import { ZulipCoreModule } from '../../core/zulip_core/zulip_core.module';
import { RedisModule } from '../../core/redis/redis.module';
import { LoginCoreModule } from '../../core/login_core/login_core.module';
import { SESSION_QUERY_SERVICE } from '../../core/session_core/session_core.interfaces';
@Module({
imports: [
// Zulip核心服务模块
ZulipCoreModule,
// Redis缓存模块
RedisModule,
// 登录核心模块
LoginCoreModule,
],
providers: [
// 主聊天服务
ChatService,
// 会话管理服务
ChatSessionService,
// 消息过滤服务
ChatFilterService,
// 会话清理服务
ChatCleanupService,
// 会话查询接口(供其他模块依赖)
{
provide: SESSION_QUERY_SERVICE,
useExisting: ChatSessionService,
},
],
exports: [
ChatService,
ChatSessionService,
ChatFilterService,
ChatCleanupService,
// 导出会话查询接口
SESSION_QUERY_SERVICE,
],
})
export class ChatModule {}