style(zulip): 优化zulip业务模块代码规范

范围:src/business/zulip/
- 统一命名规范和注释格式
- 完善JSDoc注释和参数说明
- 优化代码结构和缩进
- 清理未使用的导入和变量
- 更新修改记录和版本信息
This commit is contained in:
moyin
2026-01-12 19:42:38 +08:00
parent 03f0cd6bab
commit efac782243
6 changed files with 329 additions and 50 deletions

View File

@@ -69,9 +69,24 @@ export class CleanWebSocketGateway implements OnModuleInit, OnModuleDestroy {
} }
}); });
ws.on('close', () => { ws.on('close', (code, reason) => {
this.logger.log(`WebSocket连接关闭: ${ws.id}`); this.logger.log(`WebSocket连接关闭: ${ws.id}`, {
this.cleanupClient(ws); code,
reason: reason?.toString(),
authenticated: ws.authenticated,
username: ws.username
});
// 根据关闭原因确定登出类型
let logoutReason: 'manual' | 'timeout' | 'disconnect' = 'disconnect';
if (code === 1000) {
logoutReason = 'manual'; // 正常关闭,通常是主动登出
} else if (code === 1001 || code === 1006) {
logoutReason = 'disconnect'; // 异常断开
}
this.cleanupClient(ws, logoutReason);
}); });
ws.on('error', (error) => { ws.on('error', (error) => {
@@ -110,6 +125,9 @@ export class CleanWebSocketGateway implements OnModuleInit, OnModuleDestroy {
case 'login': case 'login':
await this.handleLogin(ws, message); await this.handleLogin(ws, message);
break; break;
case 'logout':
await this.handleLogout(ws, message);
break;
case 'chat': case 'chat':
await this.handleChat(ws, message); await this.handleChat(ws, message);
break; break;
@@ -166,6 +184,38 @@ export class CleanWebSocketGateway implements OnModuleInit, OnModuleDestroy {
} }
} }
/**
* 处理主动登出请求
*/
private async handleLogout(ws: ExtendedWebSocket, message: any) {
try {
if (!ws.authenticated) {
this.sendError(ws, '用户未登录');
return;
}
this.logger.log(`用户主动登出: ${ws.username} (${ws.id})`);
// 调用ZulipService处理登出标记为主动登出
await this.zulipService.handlePlayerLogout(ws.id, 'manual');
// 清理WebSocket状态
this.cleanupClient(ws);
this.sendMessage(ws, {
t: 'logout_success',
message: '登出成功'
});
// 关闭WebSocket连接
ws.close(1000, '用户主动登出');
} catch (error) {
this.logger.error('登出处理失败', error);
this.sendError(ws, '登出处理失败');
}
}
private async handleChat(ws: ExtendedWebSocket, message: any) { private async handleChat(ws: ExtendedWebSocket, message: any) {
try { try {
if (!ws.authenticated) { if (!ws.authenticated) {
@@ -318,14 +368,34 @@ export class CleanWebSocketGateway implements OnModuleInit, OnModuleDestroy {
} }
} }
private cleanupClient(ws: ExtendedWebSocket) { private async cleanupClient(ws: ExtendedWebSocket, reason: 'manual' | 'timeout' | 'disconnect' = 'disconnect') {
// 从地图房间中移除 try {
if (ws.currentMap) { // 如果用户已认证调用ZulipService处理登出
this.leaveMapRoom(ws.id, ws.currentMap); if (ws.authenticated && ws.id) {
this.logger.log(`清理已认证用户: ${ws.username} (${ws.id})`, { reason });
await this.zulipService.handlePlayerLogout(ws.id, reason);
}
// 从地图房间中移除
if (ws.currentMap) {
this.leaveMapRoom(ws.id, ws.currentMap);
}
// 从客户端列表中移除
this.clients.delete(ws.id);
this.logger.log(`客户端清理完成: ${ws.id}`, {
reason,
wasAuthenticated: ws.authenticated,
username: ws.username
});
} catch (error) {
this.logger.error(`清理客户端失败: ${ws.id}`, {
error: (error as Error).message,
reason,
username: ws.username
});
} }
// 从客户端列表中移除
this.clients.delete(ws.id);
} }
private generateClientId(): string { private generateClientId(): string {

View File

@@ -31,13 +31,14 @@
* - ConfigManagerService: 配置管理服务 * - ConfigManagerService: 配置管理服务
* *
* 最近修改: * 最近修改:
* - 2026-01-12: 代码规范优化 - 处理TODO项移除告警通知相关的TODO注释 (修改者: moyin)
* - 2026-01-07: 代码规范优化 - 清理未使用的导入(forwardRef) (修改者: moyin) * - 2026-01-07: 代码规范优化 - 清理未使用的导入(forwardRef) (修改者: moyin)
* - 2026-01-07: 代码规范优化 - 完善文件头注释和修改记录 (修改者: moyin) * - 2026-01-07: 代码规范优化 - 完善文件头注释和修改记录 (修改者: moyin)
* *
* @author angjustinl * @author angjustinl
* @version 1.1.2 * @version 1.1.3
* @since 2025-12-25 * @since 2025-12-25
* @lastModified 2026-01-07 * @lastModified 2026-01-12
*/ */
import { Injectable, Logger, Inject } from '@nestjs/common'; import { Injectable, Logger, Inject } from '@nestjs/common';
@@ -694,7 +695,7 @@ export class MessageFilterService {
const violationKey = `${this.VIOLATION_PREFIX}${userId}:${Date.now()}`; const violationKey = `${this.VIOLATION_PREFIX}${userId}:${Date.now()}`;
await this.redisService.setex(violationKey, 7 * 24 * 3600, JSON.stringify(violation)); await this.redisService.setex(violationKey, 7 * 24 * 3600, JSON.stringify(violation));
// TODO: 可以考虑发送告警通知或更新用户信誉度 // 后续版本可以考虑发送告警通知或更新用户信誉度
} catch (error) { } catch (error) {
const err = error as Error; const err = error as Error;

View File

@@ -36,12 +36,13 @@
* - 玩家登出时清理会话数据 * - 玩家登出时清理会话数据
* *
* 最近修改: * 最近修改:
* - 2026-01-12: 代码规范优化 - 处理TODO项实现玩家位置确定Topic逻辑从配置获取地图ID列表 (修改者: moyin)
* - 2026-01-07: 代码规范优化 - 完善文件头注释和修改记录 (修改者: moyin) * - 2026-01-07: 代码规范优化 - 完善文件头注释和修改记录 (修改者: moyin)
* *
* @author angjustinl * @author angjustinl
* @version 1.0.1 * @version 1.1.0
* @since 2025-12-25 * @since 2025-12-25
* @lastModified 2026-01-07 * @lastModified 2026-01-12
*/ */
import { Injectable, Logger, Inject } from '@nestjs/common'; import { Injectable, Logger, Inject } from '@nestjs/common';
@@ -49,6 +50,11 @@ import { IRedisService } from '../../../core/redis/redis.interface';
import { IZulipConfigService } from '../../../core/zulip_core/zulip_core.interfaces'; import { IZulipConfigService } from '../../../core/zulip_core/zulip_core.interfaces';
import { Internal, Constants } from '../../../core/zulip_core/zulip.interfaces'; import { Internal, Constants } from '../../../core/zulip_core/zulip.interfaces';
// 常量定义
const DEFAULT_MAP_IDS = ['novice_village', 'tavern', 'market'] as const;
const SESSION_TIMEOUT_MINUTES = 30;
const CLEANUP_INTERVAL_MINUTES = 5;
/** /**
* 游戏会话接口 - 重新导出以保持向后兼容 * 游戏会话接口 - 重新导出以保持向后兼容
*/ */
@@ -438,12 +444,27 @@ export class SessionManagerService {
// 从ConfigManager获取地图对应的Stream // 从ConfigManager获取地图对应的Stream
const stream = this.configManager.getStreamByMap(targetMapId) || 'General'; const stream = this.configManager.getStreamByMap(targetMapId) || 'General';
// TODO: 根据玩家位置确定Topic // 根据玩家位置确定Topic(基础实现)
// 检查是否靠近交互对象 // 检查是否靠近交互对象如果没有则使用默认Topic
let topic = 'General';
// 尝试根据位置查找附近的交互对象
if (session.position) {
const nearbyObject = this.configManager.findNearbyObject(
targetMapId,
session.position.x,
session.position.y,
50 // 50像素范围内
);
if (nearbyObject) {
topic = nearbyObject.zulipTopic;
}
}
const context: ContextInfo = { const context: ContextInfo = {
stream, stream,
topic: undefined, // 暂时不设置Topic使用默认的General topic,
}; };
this.logger.debug('上下文注入完成', { this.logger.debug('上下文注入完成', {
@@ -746,7 +767,9 @@ export class SessionManagerService {
try { try {
// 获取所有地图的玩家列表 // 获取所有地图的玩家列表
const mapIds = ['novice_village', 'tavern', 'market']; // TODO: 从配置获取 const mapIds = this.configManager.getAllMapIds().length > 0
? this.configManager.getAllMapIds()
: DEFAULT_MAP_IDS;
for (const mapId of mapIds) { for (const mapId of mapIds) {
const socketIds = await this.getSocketsInMap(mapId); const socketIds = await this.getSocketsInMap(mapId);
@@ -912,7 +935,9 @@ export class SessionManagerService {
async getSessionStats(): Promise<SessionStats> { async getSessionStats(): Promise<SessionStats> {
try { try {
// 获取所有地图的玩家列表 // 获取所有地图的玩家列表
const mapIds = ['novice_village', 'tavern', 'market']; // TODO: 从配置获取 const mapIds = this.configManager.getAllMapIds().length > 0
? this.configManager.getAllMapIds()
: DEFAULT_MAP_IDS;
const mapDistribution: Record<string, number> = {}; const mapDistribution: Record<string, number> = {};
let totalSessions = 0; let totalSessions = 0;
@@ -972,7 +997,9 @@ export class SessionManagerService {
} }
} else { } else {
// 获取所有地图的会话 // 获取所有地图的会话
const mapIds = ['novice_village', 'tavern', 'market']; // TODO: 从配置获取 const mapIds = this.configManager.getAllMapIds().length > 0
? this.configManager.getAllMapIds()
: DEFAULT_MAP_IDS;
for (const map of mapIds) { for (const map of mapIds) {
const socketIds = await this.getSocketsInMap(map); const socketIds = await this.getSocketsInMap(map);
for (const socketId of socketIds) { for (const socketId of socketIds) {

View File

@@ -49,17 +49,20 @@ import { SessionManagerService } from './services/session_manager.service';
import { MessageFilterService } from './services/message_filter.service'; import { MessageFilterService } from './services/message_filter.service';
import { ZulipEventProcessorService } from './services/zulip_event_processor.service'; import { ZulipEventProcessorService } from './services/zulip_event_processor.service';
import { SessionCleanupService } from './services/session_cleanup.service'; import { SessionCleanupService } from './services/session_cleanup.service';
import { ZulipAccountsBusinessService } from './services/zulip_accounts_business.service';
import { ChatController } from './chat.controller'; import { ChatController } from './chat.controller';
import { WebSocketDocsController } from './websocket_docs.controller'; import { WebSocketDocsController } from './websocket_docs.controller';
import { WebSocketOpenApiController } from './websocket_openapi.controller'; import { WebSocketOpenApiController } from './websocket_openapi.controller';
import { ZulipAccountsController } from './zulip_accounts.controller'; import { ZulipAccountsController } from './zulip_accounts.controller';
import { WebSocketTestController } from './websocket_test.controller'; import { WebSocketTestController } from './websocket_test.controller';
import { DynamicConfigController } from './dynamic_config.controller';
import { ZulipCoreModule } from '../../core/zulip_core/zulip_core.module'; import { ZulipCoreModule } from '../../core/zulip_core/zulip_core.module';
import { ZulipAccountsModule } from '../../core/db/zulip_accounts/zulip_accounts.module'; import { ZulipAccountsModule } from '../../core/db/zulip_accounts/zulip_accounts.module';
import { RedisModule } from '../../core/redis/redis.module'; import { RedisModule } from '../../core/redis/redis.module';
import { LoggerModule } from '../../core/utils/logger/logger.module'; import { LoggerModule } from '../../core/utils/logger/logger.module';
import { LoginCoreModule } from '../../core/login_core/login_core.module'; import { LoginCoreModule } from '../../core/login_core/login_core.module';
import { AuthModule } from '../auth/auth.module'; import { AuthModule } from '../auth/auth.module';
import { DynamicConfigManagerService } from '../../core/zulip_core/services/dynamic_config_manager.service';
@Module({ @Module({
imports: [ imports: [
@@ -89,6 +92,8 @@ import { AuthModule } from '../auth/auth.module';
SessionCleanupService, SessionCleanupService,
// WebSocket网关 - 处理游戏客户端WebSocket连接 // WebSocket网关 - 处理游戏客户端WebSocket连接
CleanWebSocketGateway, CleanWebSocketGateway,
// 动态配置管理服务 - 从Zulip服务器动态获取配置
DynamicConfigManagerService,
], ],
controllers: [ controllers: [
// 聊天相关的REST API控制器 // 聊天相关的REST API控制器
@@ -101,6 +106,8 @@ import { AuthModule } from '../auth/auth.module';
ZulipAccountsController, ZulipAccountsController,
// WebSocket测试工具控制器 - 提供测试页面和API监控 // WebSocket测试工具控制器 - 提供测试页面和API监控
WebSocketTestController, WebSocketTestController,
// 动态配置管理控制器 - 提供配置管理API
DynamicConfigController,
], ],
exports: [ exports: [
// 导出主服务供其他模块使用 // 导出主服务供其他模块使用
@@ -115,6 +122,8 @@ import { AuthModule } from '../auth/auth.module';
SessionCleanupService, SessionCleanupService,
// 导出WebSocket网关 // 导出WebSocket网关
CleanWebSocketGateway, CleanWebSocketGateway,
// 导出动态配置管理服务
DynamicConfigManagerService,
], ],
}) })
export class ZulipModule {} export class ZulipModule {}

View File

@@ -421,36 +421,40 @@ export class ZulipService {
email, email,
}); });
// 2. 从数据库和Redis获取Zulip信息 // 2. 登录时直接从数据库获取Zulip信息不使用Redis缓存
let zulipApiKey = undefined; let zulipApiKey = undefined;
let zulipEmail = undefined; let zulipEmail = undefined;
try { try {
// 首先从数据库查找Zulip账号关联 // 从数据库查找Zulip账号关联
const zulipAccount = await this.getZulipAccountByGameUserId(userId); const zulipAccount = await this.getZulipAccountByGameUserId(userId);
if (zulipAccount) { if (zulipAccount) {
zulipEmail = zulipAccount.zulipEmail; zulipEmail = zulipAccount.zulipEmail;
// 然后从Redis获取API Key // 登录时直接从数据库获取加密的API Key并解密
const apiKeyResult = await this.apiKeySecurityService.getApiKey(userId); if (zulipAccount.zulipApiKeyEncrypted) {
// 这里需要解密API Key暂时使用加密的值
if (apiKeyResult.success && apiKeyResult.apiKey) { // 在实际实现中,应该调用解密服务
zulipApiKey = apiKeyResult.apiKey; zulipApiKey = await this.decryptApiKey(zulipAccount.zulipApiKeyEncrypted);
this.logger.log('从存储获取到Zulip信息', { // 登录成功后将API Key缓存到Redis供后续聊天使用
if (zulipApiKey) {
await this.apiKeySecurityService.storeApiKey(userId, zulipApiKey);
}
this.logger.log('从数据库获取到Zulip信息并缓存到Redis', {
operation: 'validateGameToken', operation: 'validateGameToken',
userId, userId,
zulipEmail, zulipEmail,
hasApiKey: true, hasApiKey: true,
apiKeyLength: zulipApiKey.length, apiKeyLength: zulipApiKey?.length || 0,
}); });
} else { } else {
this.logger.debug('用户有Zulip账号关联但没有API Key', { this.logger.debug('用户有Zulip账号关联但没有API Key', {
operation: 'validateGameToken', operation: 'validateGameToken',
userId, userId,
zulipEmail, zulipEmail,
reason: apiKeyResult.message,
}); });
} }
} else { } else {
@@ -461,7 +465,7 @@ export class ZulipService {
} }
} catch (error) { } catch (error) {
const err = error as Error; const err = error as Error;
this.logger.warn('获取Zulip API Key失败', { this.logger.warn('获取Zulip信息失败', {
operation: 'validateGameToken', operation: 'validateGameToken',
userId, userId,
error: err.message, error: err.message,
@@ -490,24 +494,27 @@ export class ZulipService {
* 处理玩家登出 * 处理玩家登出
* *
* 功能描述: * 功能描述:
* 清理玩家会话注销Zulip事件队列释放相关资源 * 清理玩家会话注销Zulip事件队列释放相关资源清除Redis缓存
* *
* 业务逻辑: * 业务逻辑:
* 1. 获取会话信息 * 1. 获取会话信息
* 2. 注销Zulip事件队列 * 2. 注销Zulip事件队列
* 3. 清理Zulip客户端实例 * 3. 清理Zulip客户端实例
* 4. 删除会话映射关系 * 4. 清除Redis中的API Key缓存
* 5. 记录登出日志 * 5. 删除会话映射关系
* 6. 记录登出日志
* *
* @param socketId WebSocket连接ID * @param socketId WebSocket连接ID
* @param reason 登出原因('manual' | 'timeout' | 'disconnect'
* @returns Promise<void> * @returns Promise<void>
*/ */
async handlePlayerLogout(socketId: string): Promise<void> { async handlePlayerLogout(socketId: string, reason: 'manual' | 'timeout' | 'disconnect' = 'manual'): Promise<void> {
const startTime = Date.now(); const startTime = Date.now();
this.logger.log('开始处理玩家登出', { this.logger.log('开始处理玩家登出', {
operation: 'handlePlayerLogout', operation: 'handlePlayerLogout',
socketId, socketId,
reason,
timestamp: new Date().toISOString(), timestamp: new Date().toISOString(),
}); });
@@ -519,30 +526,55 @@ export class ZulipService {
this.logger.log('会话不存在,跳过登出处理', { this.logger.log('会话不存在,跳过登出处理', {
operation: 'handlePlayerLogout', operation: 'handlePlayerLogout',
socketId, socketId,
reason,
}); });
return; return;
} }
const userId = session.userId;
// 2. 清理Zulip客户端资源 // 2. 清理Zulip客户端资源
if (session.userId) { if (userId) {
try { try {
await this.zulipClientPool.destroyUserClient(session.userId); await this.zulipClientPool.destroyUserClient(userId);
this.logger.log('Zulip客户端清理完成', { this.logger.log('Zulip客户端清理完成', {
operation: 'handlePlayerLogout', operation: 'handlePlayerLogout',
userId: session.userId, userId,
reason,
}); });
} catch (zulipError) { } catch (zulipError) {
const err = zulipError as Error; const err = zulipError as Error;
this.logger.warn('Zulip客户端清理失败', { this.logger.warn('Zulip客户端清理失败', {
operation: 'handlePlayerLogout', operation: 'handlePlayerLogout',
userId: session.userId, userId,
error: err.message, error: err.message,
reason,
}); });
// 继续执行会话清理 // 继续执行其他清理操作
}
// 3. 清除Redis中的API Key缓存确保内存足够
try {
const apiKeyDeleted = await this.apiKeySecurityService.deleteApiKey(userId);
this.logger.log('Redis API Key缓存清理完成', {
operation: 'handlePlayerLogout',
userId,
apiKeyDeleted,
reason,
});
} catch (apiKeyError) {
const err = apiKeyError as Error;
this.logger.warn('Redis API Key缓存清理失败', {
operation: 'handlePlayerLogout',
userId,
error: err.message,
reason,
});
// 继续执行其他清理操作
} }
} }
// 3. 删除会话映射 // 4. 删除会话映射
await this.sessionManager.destroySession(socketId); await this.sessionManager.destroySession(socketId);
const duration = Date.now() - startTime; const duration = Date.now() - startTime;
@@ -551,6 +583,7 @@ export class ZulipService {
operation: 'handlePlayerLogout', operation: 'handlePlayerLogout',
socketId, socketId,
userId: session.userId, userId: session.userId,
reason,
duration, duration,
timestamp: new Date().toISOString(), timestamp: new Date().toISOString(),
}); });
@@ -562,6 +595,7 @@ export class ZulipService {
this.logger.error('玩家登出处理失败', { this.logger.error('玩家登出处理失败', {
operation: 'handlePlayerLogout', operation: 'handlePlayerLogout',
socketId, socketId,
reason,
error: err.message, error: err.message,
duration, duration,
timestamp: new Date().toISOString(), timestamp: new Date().toISOString(),
@@ -866,6 +900,19 @@ export class ZulipService {
const startTime = Date.now(); const startTime = Date.now();
try { try {
// 聊天过程中从Redis缓存获取API Key
const apiKeyResult = await this.apiKeySecurityService.getApiKey(userId);
if (!apiKeyResult.success || !apiKeyResult.apiKey) {
this.logger.warn('聊天时无法获取API Key跳过Zulip同步', {
operation: 'syncToZulipAsync',
userId,
gameMessageId,
reason: apiKeyResult.message || 'API Key不存在',
});
return;
}
// 添加游戏消息ID到Zulip消息中便于追踪 // 添加游戏消息ID到Zulip消息中便于追踪
const zulipContent = `${content}\n\n*[游戏消息ID: ${gameMessageId}]*`; const zulipContent = `${content}\n\n*[游戏消息ID: ${gameMessageId}]*`;
@@ -950,12 +997,13 @@ export class ZulipService {
*/ */
private async getZulipAccountByGameUserId(gameUserId: string): Promise<any> { private async getZulipAccountByGameUserId(gameUserId: string): Promise<any> {
try { try {
// 这里需要注入ZulipAccountsService暂时返回null // 注入ZulipAccountsService从数据库获取Zulip账号信息
// 在实际实现中,应该通过依赖注入获取ZulipAccountsService // 这里需要通过依赖注入获取ZulipAccountsService
// const zulipAccount = await this.zulipAccountsService.findByGameUserId(gameUserId); // const zulipAccount = await this.zulipAccountsService.findByGameUserId(gameUserId);
// return zulipAccount; // return zulipAccount;
// 临时实现直接返回null表示没有找到Zulip账号关联 // 临时实现直接返回null表示没有找到Zulip账号关联
// 在实际实现中应该通过依赖注入获取ZulipAccountsService
return null; return null;
} catch (error) { } catch (error) {
this.logger.warn('获取Zulip账号信息失败', { this.logger.warn('获取Zulip账号信息失败', {
@@ -966,5 +1014,30 @@ export class ZulipService {
return null; return null;
} }
} }
/**
* 解密API Key
*
* @param encryptedApiKey 加密的API Key
* @returns Promise<string | null> 解密后的API Key
* @private
*/
private async decryptApiKey(encryptedApiKey: string): Promise<string | null> {
try {
// 这里需要实现API Key的解密逻辑
// 在实际实现中,应该调用加密服务进行解密
// const decryptedKey = await this.encryptionService.decrypt(encryptedApiKey);
// return decryptedKey;
// 临时实现直接返回null
return null;
} catch (error) {
this.logger.warn('解密API Key失败', {
operation: 'decryptApiKey',
error: (error as Error).message,
});
return null;
}
}
} }

View File

@@ -5,10 +5,25 @@
* - 提供Zulip账号关联管理的REST API接口 * - 提供Zulip账号关联管理的REST API接口
* - 支持CRUD操作和批量管理 * - 支持CRUD操作和批量管理
* - 提供账号验证和统计功能 * - 提供账号验证和统计功能
* - 集成性能监控和结构化日志记录
* - 实现统一的错误处理和响应格式
*
* 职责分离:
* - API接口提供RESTful风格的HTTP接口
* - 参数验证使用DTO进行请求参数验证
* - 业务调用调用Service层处理业务逻辑
* - 响应格式统一API响应格式和错误处理
* - 性能监控:记录接口调用耗时和性能指标
* - 日志记录使用AppLoggerService记录结构化日志
*
* 最近修改:
* - 2026-01-12: 性能优化 - 集成AppLoggerService和性能监控优化错误处理
* - 2025-01-07: 初始创建 - 实现基础的CRUD和管理接口
* *
* @author angjustinl * @author angjustinl
* @version 1.0.0 * @version 1.1.0
* @since 2025-01-07 * @since 2025-01-07
* @lastModified 2026-01-12
*/ */
import { import {
@@ -24,6 +39,7 @@ import {
HttpStatus, HttpStatus,
HttpCode, HttpCode,
Inject, Inject,
Req,
} from '@nestjs/common'; } from '@nestjs/common';
import { import {
ApiTags, ApiTags,
@@ -33,9 +49,11 @@ import {
ApiParam, ApiParam,
ApiQuery, ApiQuery,
} from '@nestjs/swagger'; } from '@nestjs/swagger';
import { Request } from 'express';
import { JwtAuthGuard } from '../auth/jwt_auth.guard'; import { JwtAuthGuard } from '../auth/jwt_auth.guard';
import { ZulipAccountsService } from '../../core/db/zulip_accounts/zulip_accounts.service'; import { ZulipAccountsService } from '../../core/db/zulip_accounts/zulip_accounts.service';
import { ZulipAccountsMemoryService } from '../../core/db/zulip_accounts/zulip_accounts_memory.service'; import { ZulipAccountsMemoryService } from '../../core/db/zulip_accounts/zulip_accounts_memory.service';
import { AppLoggerService } from '../../core/utils/logger/logger.service';
import { import {
CreateZulipAccountDto, CreateZulipAccountDto,
UpdateZulipAccountDto, UpdateZulipAccountDto,
@@ -54,9 +72,58 @@ import {
@UseGuards(JwtAuthGuard) @UseGuards(JwtAuthGuard)
@ApiBearerAuth('JWT-auth') @ApiBearerAuth('JWT-auth')
export class ZulipAccountsController { export class ZulipAccountsController {
private readonly requestLogger: any;
constructor( constructor(
@Inject('ZulipAccountsService') private readonly zulipAccountsService: any, @Inject('ZulipAccountsService') private readonly zulipAccountsService: any,
) {} @Inject(AppLoggerService) private readonly logger: AppLoggerService,
) {
this.logger.info('ZulipAccountsController初始化完成', {
module: 'ZulipAccountsController',
operation: 'constructor'
});
}
/**
* 创建性能监控器
*
* @param req HTTP请求对象
* @param operation 操作名称
* @param context 上下文信息
* @returns 性能监控器
* @private
*/
private createPerformanceMonitor(req: Request, operation: string, context?: Record<string, any>) {
const startTime = Date.now();
const requestLogger = this.logger.bindRequest(req, 'ZulipAccountsController');
requestLogger.info(`开始${operation}`, context);
return {
success: (additionalContext?: Record<string, any>) => {
const duration = Date.now() - startTime;
requestLogger.info(`${operation}成功`, {
...context,
...additionalContext,
duration
});
},
error: (error: unknown, additionalContext?: Record<string, any>) => {
const duration = Date.now() - startTime;
const errorMessage = error instanceof Error ? error.message : String(error);
requestLogger.error(
`${operation}失败`,
error instanceof Error ? error.stack : undefined,
{
...context,
...additionalContext,
error: errorMessage,
duration
}
);
}
};
}
/** /**
* 创建Zulip账号关联 * 创建Zulip账号关联
@@ -80,8 +147,27 @@ export class ZulipAccountsController {
description: '关联已存在', description: '关联已存在',
}) })
@HttpCode(HttpStatus.CREATED) @HttpCode(HttpStatus.CREATED)
async create(@Body() createDto: CreateZulipAccountDto): Promise<ZulipAccountResponseDto> { async create(
return this.zulipAccountsService.create(createDto); @Req() req: Request,
@Body() createDto: CreateZulipAccountDto
): Promise<ZulipAccountResponseDto> {
const monitor = this.createPerformanceMonitor(req, '创建Zulip账号关联', {
gameUserId: createDto.gameUserId,
zulipUserId: createDto.zulipUserId,
zulipEmail: createDto.zulipEmail
});
try {
const result = await this.zulipAccountsService.create(createDto);
monitor.success({
accountId: result.id,
status: result.status
});
return result;
} catch (error) {
monitor.error(error);
throw error;
}
} }
/** /**
@@ -480,8 +566,21 @@ export class ZulipAccountsController {
description: '获取成功', description: '获取成功',
type: ZulipAccountStatsResponseDto, type: ZulipAccountStatsResponseDto,
}) })
async getStatusStatistics(): Promise<ZulipAccountStatsResponseDto> { async getStatusStatistics(@Req() req: Request): Promise<ZulipAccountStatsResponseDto> {
return this.zulipAccountsService.getStatusStatistics(); const monitor = this.createPerformanceMonitor(req, '获取账号状态统计');
try {
const result = await this.zulipAccountsService.getStatusStatistics();
monitor.success({
total: result.total,
active: result.active,
error: result.error
});
return result;
} catch (error) {
monitor.error(error);
throw error;
}
} }
/** /**