feat: 完成 NestJS 后端核心底座开发 (M1-M6) 和 Ant Design Vue 前端迁移
主要更新： 1. 后端核心底座完成 (M1-M6)： - 健康检查、指标监控、分布式锁 - 事件总线、队列系统、事务管理 - 安全守卫、多租户隔离、存储适配器 - 审计日志、配置管理、多语言支持 2. 前端迁移到 Ant Design Vue： - 从 Element Plus 迁移到 Ant Design Vue - 完善 system 模块 (role/menu/dept) - 修复依赖和配置问题 3. 文档完善： - AI 开发工作流文档 - 架构约束和开发规范 - 项目进度跟踪 4. 其他改进： - 修复编译错误和类型问题 - 完善测试用例 - 优化项目结构
This commit is contained in:
万物街
245
wwjcloud/docs/queue-usage.example.ts
Normal file
245
wwjcloud/docs/queue-usage.example.ts
Normal file
@@ -0,0 +1,245 @@
|
||||
import { Injectable } from '@nestjs/common';
|
||||
import { UnifiedQueueService } from '../src/core/queue/unified-queue.service';
|
||||
import { TaskJobOptions, EventPublishOptions } from '../src/core/interfaces/queue.interface';
|
||||
|
||||
/**
|
||||
* 队列使用示例
|
||||
* 演示如何使用新的队列系统
|
||||
*/
|
||||
@Injectable()
|
||||
export class QueueUsageExample {
|
||||
constructor(
|
||||
private readonly queueService: UnifiedQueueService,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 示例：用户注册流程
|
||||
*/
|
||||
async handleUserRegistration(userData: {
|
||||
id: number;
|
||||
email: string;
|
||||
phone: string;
|
||||
name: string;
|
||||
}) {
|
||||
// 1. 发布用户注册事件（事件总线）
|
||||
await this.queueService.publishUserEvent('registered', userData.id, {
|
||||
email: userData.email,
|
||||
phone: userData.phone,
|
||||
name: userData.name,
|
||||
registeredAt: new Date().toISOString(),
|
||||
});
|
||||
|
||||
// 2. 添加发送欢迎邮件任务（任务队列）
|
||||
await this.queueService.sendEmail(
|
||||
userData.email,
|
||||
'欢迎注册',
|
||||
`欢迎 ${userData.name} 注册我们的平台！`,
|
||||
{
|
||||
delay: 5000, // 5秒后发送
|
||||
attempts: 3,
|
||||
priority: 1,
|
||||
}
|
||||
);
|
||||
|
||||
// 3. 添加发送短信验证码任务（任务队列）
|
||||
await this.queueService.sendSms(
|
||||
userData.phone,
|
||||
'您的验证码是：123456',
|
||||
{
|
||||
attempts: 2,
|
||||
priority: 1,
|
||||
}
|
||||
);
|
||||
|
||||
// 4. 添加数据同步任务（任务队列）
|
||||
await this.queueService.syncData('user-profile', {
|
||||
userId: userData.id,
|
||||
action: 'create',
|
||||
data: userData,
|
||||
}, {
|
||||
delay: 10000, // 10秒后同步
|
||||
priority: 3,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 示例：订单处理流程
|
||||
*/
|
||||
async handleOrderCreated(orderData: {
|
||||
id: number;
|
||||
userId: number;
|
||||
amount: number;
|
||||
items: any[];
|
||||
}) {
|
||||
// 1. 发布订单创建事件（事件总线）
|
||||
await this.queueService.publishOrderEvent('created', orderData.id, {
|
||||
userId: orderData.userId,
|
||||
amount: orderData.amount,
|
||||
itemCount: orderData.items.length,
|
||||
createdAt: new Date().toISOString(),
|
||||
});
|
||||
|
||||
// 2. 添加库存扣减任务（任务队列）
|
||||
await this.queueService.addTask('inventory', 'reduce', {
|
||||
orderId: orderData.id,
|
||||
items: orderData.items,
|
||||
}, {
|
||||
priority: 1,
|
||||
attempts: 5,
|
||||
});
|
||||
|
||||
// 3. 添加支付处理任务（任务队列）
|
||||
await this.queueService.addTask('payment', 'process', {
|
||||
orderId: orderData.id,
|
||||
amount: orderData.amount,
|
||||
userId: orderData.userId,
|
||||
}, {
|
||||
delay: 1000, // 1秒后处理
|
||||
priority: 1,
|
||||
attempts: 3,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 示例：批量事件发布
|
||||
*/
|
||||
async handleBatchUserUpdate(users: Array<{ id: number; changes: any }>) {
|
||||
const events = users.map(user => ({
|
||||
eventType: 'user.updated',
|
||||
aggregateId: user.id.toString(),
|
||||
tenantId: 'default',
|
||||
idempotencyKey: `user-update-${user.id}-${Date.now()}`,
|
||||
traceId: `trace-${Date.now()}`,
|
||||
data: user.changes,
|
||||
version: '1',
|
||||
occurredAt: new Date().toISOString(),
|
||||
}));
|
||||
|
||||
// 批量发布事件
|
||||
await this.queueService.publishEvents(events);
|
||||
}
|
||||
|
||||
/**
|
||||
* 示例：注册任务处理器
|
||||
*/
|
||||
async registerTaskProcessors() {
|
||||
// 注册邮件发送处理器
|
||||
await this.queueService.processTask('email', async (job: any) => {
|
||||
console.log('处理邮件发送任务:', job.data);
|
||||
// 实际的邮件发送逻辑
|
||||
await this.sendEmailImplementation(job.data);
|
||||
});
|
||||
|
||||
// 注册短信发送处理器
|
||||
await this.queueService.processTask('sms', async (job: any) => {
|
||||
console.log('处理短信发送任务:', job.data);
|
||||
// 实际的短信发送逻辑
|
||||
await this.sendSmsImplementation(job.data);
|
||||
});
|
||||
|
||||
// 注册库存扣减处理器
|
||||
await this.queueService.processTask('inventory', async (job: any) => {
|
||||
console.log('处理库存扣减任务:', job.data);
|
||||
// 实际的库存扣减逻辑
|
||||
await this.reduceInventoryImplementation(job.data);
|
||||
});
|
||||
|
||||
// 注册支付处理器
|
||||
await this.queueService.processTask('payment', async (job: any) => {
|
||||
console.log('处理支付任务:', job.data);
|
||||
// 实际的支付处理逻辑
|
||||
await this.processPaymentImplementation(job.data);
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 示例：注册事件处理器
|
||||
*/
|
||||
async registerEventHandlers() {
|
||||
// 注册用户注册事件处理器
|
||||
await this.queueService.subscribeEvent('user.registered', async (event: any) => {
|
||||
console.log('处理用户注册事件:', event);
|
||||
// 可以触发其他业务逻辑，如发送通知、更新统计等
|
||||
await this.handleUserRegisteredEvent(event);
|
||||
});
|
||||
|
||||
// 注册订单创建事件处理器
|
||||
await this.queueService.subscribeEvent('order.created', async (event: any) => {
|
||||
console.log('处理订单创建事件:', event);
|
||||
// 可以触发其他业务逻辑，如发送通知、更新报表等
|
||||
await this.handleOrderCreatedEvent(event);
|
||||
});
|
||||
|
||||
// 注册用户更新事件处理器
|
||||
await this.queueService.subscribeEvent('user.updated', async (event: any) => {
|
||||
console.log('处理用户更新事件:', event);
|
||||
// 可以触发缓存更新、搜索索引更新等
|
||||
await this.handleUserUpdatedEvent(event);
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 示例：监控和管理
|
||||
*/
|
||||
async monitorQueues() {
|
||||
// 获取任务队列统计
|
||||
const emailStats = await this.queueService.getTaskQueueStats('email');
|
||||
const smsStats = await this.queueService.getTaskQueueStats('sms');
|
||||
|
||||
console.log('邮件队列统计:', emailStats);
|
||||
console.log('短信队列统计:', smsStats);
|
||||
|
||||
// 健康检查
|
||||
const health = await this.queueService.healthCheck();
|
||||
console.log('队列健康状态:', health);
|
||||
|
||||
// 清理已完成的任务（保留最近1小时的）
|
||||
await this.queueService.cleanTaskQueue('email', 3600000);
|
||||
await this.queueService.cleanTaskQueue('sms', 3600000);
|
||||
}
|
||||
|
||||
// ==================== 私有实现方法 ====================
|
||||
|
||||
private async sendEmailImplementation(data: any) {
|
||||
// 实际的邮件发送实现
|
||||
console.log('发送邮件:', data);
|
||||
// 模拟异步操作
|
||||
await new Promise(resolve => setTimeout(resolve, 1000));
|
||||
}
|
||||
|
||||
private async sendSmsImplementation(data: any) {
|
||||
// 实际的短信发送实现
|
||||
console.log('发送短信:', data);
|
||||
// 模拟异步操作
|
||||
await new Promise(resolve => setTimeout(resolve, 500));
|
||||
}
|
||||
|
||||
private async reduceInventoryImplementation(data: any) {
|
||||
// 实际的库存扣减实现
|
||||
console.log('扣减库存:', data);
|
||||
// 模拟异步操作
|
||||
await new Promise(resolve => setTimeout(resolve, 2000));
|
||||
}
|
||||
|
||||
private async processPaymentImplementation(data: any) {
|
||||
// 实际的支付处理实现
|
||||
console.log('处理支付:', data);
|
||||
// 模拟异步操作
|
||||
await new Promise(resolve => setTimeout(resolve, 3000));
|
||||
}
|
||||
|
||||
private async handleUserRegisteredEvent(event: any) {
|
||||
// 处理用户注册事件的业务逻辑
|
||||
console.log('用户注册事件处理:', event);
|
||||
}
|
||||
|
||||
private async handleOrderCreatedEvent(event: any) {
|
||||
// 处理订单创建事件的业务逻辑
|
||||
console.log('订单创建事件处理:', event);
|
||||
}
|
||||
|
||||
private async handleUserUpdatedEvent(event: any) {
|
||||
// 处理用户更新事件的业务逻辑
|
||||
console.log('用户更新事件处理:', event);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user