create-dp-koa 1.0.1 → 1.0.2

package/template/src/entity/ytUser.entity.ts

@@ -1,96 +0,0 @@
-import { Column, Entity, OneToMany, OneToOne } from "typeorm";
-import { BaseEntity } from "@src/entity/base.entity";
-import { ShopAndUserEntity } from "@src/entity/shopUser.entity";
-import { YtGoodsUnlockerEntity } from "@src/entity/goodsUnlocker.entity";
-
-
-export enum YtUserStatusEnum {
-    NORMAL = "normal",
-    FORBIDDEN = "forbidden"
-}
-
-export enum YtUserTypeEnum {
-    CUSTOMER = "CUSTOMER", // 消费者
-    SHOP = "SHOP" // 商家
-}
-
-
-@Entity({
-    name: "yt_user"
-})
-export class YtUserEntity extends BaseEntity {
-
-
-
-    @Column({
-        default: ""
-    })
-    nickName: string
-
-    @Column({
-        default: ""
-    })
-    telnumber: string
-
-    @Column({
-        default: ""
-    })
-    email: string
-
-    @Column({
-        default: ""
-    })
-    password: string
-
-    @Column({
-        type: "varchar",
-        length: 50,
-        default: YtUserTypeEnum.CUSTOMER
-    })
-    userType: YtUserTypeEnum
-
-    @Column({
-        default: 0,
-    })
-    gender: number
-
-
-    @Column({
-        default: 0,
-    })
-    age: number
-
-
-    // 星座
-    @Column({
-        default: ""
-    })
-    constellation: string
-
-
-    @Column({
-        default: ""
-    })
-    avatar: string;
-
-    @Column({
-        default: YtUserStatusEnum.NORMAL,
-        type: "varchar",
-        length: 50
-    })
-    status: YtUserStatusEnum;
-
-    // 关系定义
-    /**
-     * 用户与店铺的关系（一个用户只能拥有一个店铺）
-     */
-    @OneToOne(() => ShopAndUserEntity, shopUser => shopUser.user)
-    shopRelation: ShopAndUserEntity;
-
-    /**
-     * 用户解锁的商品记录
-     */
-    @OneToMany(() => YtGoodsUnlockerEntity, unlocker => unlocker.user)
-    unlockedGoods: YtGoodsUnlockerEntity[];
-
-}

package/template/src/examples/SwaggerProcessorExample.ts

@@ -1,169 +0,0 @@
-/**
- * Swagger处理器使用示例
- * 展示如何使用SwaggerProcessor来处理Swagger注解
- */
-
-import { swaggerProcessor } from '@src/annotations/processors/SwaggerProcessor';
-import { SwaggerExampleController } from '@src/controllers/example/SwaggerExampleController';
-import { logger } from '@src/framework/utils/logger';
-
-/**
- * Swagger处理器使用示例
- */
-export class SwaggerProcessorExample {
-    
-    /**
-     * 示例1：处理单个控制器的Swagger注解
-     */
-    static async processSingleController() {
-        try {
-            logger.info('=== Swagger处理器示例：处理单个控制器 ===');
-            
-            // 处理SwaggerExampleController
-            const controllerMetadata = swaggerProcessor.processController(SwaggerExampleController);
-            
-            logger.info('控制器标签:', controllerMetadata.tags);
-            logger.info('方法数量:', controllerMetadata.methods.size);
-            
-            // 遍历所有方法
-            controllerMetadata.methods.forEach((methodMetadata, methodName) => {
-                logger.info(`方法 ${methodName}:`);
-                logger.info(`  - 操作ID: ${methodMetadata.operationId}`);
-                logger.info(`  - 摘要: ${methodMetadata.summary}`);
-                logger.info(`  - 描述: ${methodMetadata.description}`);
-                logger.info(`  - 标签: ${methodMetadata.tags.join(', ')}`);
-                logger.info(`  - 参数数量: ${methodMetadata.parameters.length}`);
-                logger.info(`  - 响应数量: ${methodMetadata.responses.length}`);
-                
-                if (methodMetadata.requestBody) {
-                    logger.info(`  - 请求体: ${methodMetadata.requestBody.description}`);
-                }
-            });
-            
-        } catch (error) {
-            logger.error('处理单个控制器失败:', error as Error);
-        }
-    }
-    
-    /**
-     * 示例2：验证Swagger注解的完整性
-     */
-    static async validateSwaggerAnnotations() {
-        try {
-            logger.info('=== Swagger处理器示例：验证注解完整性 ===');
-            
-            const validationResult = swaggerProcessor.validateSwaggerAnnotations(SwaggerExampleController);
-            
-            logger.info('验证结果:', {
-                isValid: validationResult.isValid,
-                errors: validationResult.errors,
-                warnings: validationResult.warnings
-            });
-            
-            if (validationResult.errors.length > 0) {
-                logger.error('验证错误:', new Error(validationResult.errors.join(', ')));
-            }
-            
-            if (validationResult.warnings.length > 0) {
-                logger.warn('验证警告:', validationResult.warnings.join(', '));
-            }
-            
-        } catch (error) {
-            logger.error('验证Swagger注解失败:', error as Error);
-        }
-    }
-    
-    /**
-     * 示例3：生成OpenAPI规范
-     */
-    static async generateOpenAPISpec() {
-        try {
-            logger.info('=== Swagger处理器示例：生成OpenAPI规范 ===');
-            
-            const controllers = [SwaggerExampleController];
-            const openAPISpec = swaggerProcessor.generateOpenAPISpec(controllers);
-            
-            logger.info('OpenAPI规范生成成功:');
-            logger.info(`  - OpenAPI版本: ${openAPISpec.openapi}`);
-            logger.info(`  - API标题: ${openAPISpec.info.title}`);
-            logger.info(`  - API版本: ${openAPISpec.info.version}`);
-            logger.info(`  - 服务器数量: ${openAPISpec.servers.length}`);
-            logger.info(`  - 路径数量: ${Object.keys(openAPISpec.paths).length}`);
-            
-            // 输出路径信息
-            Object.keys(openAPISpec.paths).forEach(path => {
-                const pathInfo = openAPISpec.paths[path];
-                const methods = Object.keys(pathInfo);
-                logger.info(`  - 路径 ${path}: ${methods.join(', ')}`);
-            });
-            
-            return openAPISpec;
-            
-        } catch (error) {
-            logger.error('生成OpenAPI规范失败:', error as Error);
-            throw error;
-        }
-    }
-    
-    /**
-     * 示例4：处理方法级别的Swagger注解
-     */
-    static async processMethodAnnotations() {
-        try {
-            logger.info('=== Swagger处理器示例：处理方法级别注解 ===');
-            
-            const methodName = 'updateUser';
-            const methodMetadata = swaggerProcessor.processMethod(SwaggerExampleController, methodName);
-            
-            logger.info(`方法 ${methodName} 的Swagger元数据:`);
-            logger.info(`  - 操作ID: ${methodMetadata.operationId}`);
-            logger.info(`  - 摘要: ${methodMetadata.summary}`);
-            logger.info(`  - 描述: ${methodMetadata.description}`);
-            logger.info(`  - 标签: ${methodMetadata.tags.join(', ')}`);
-            
-            // 输出参数信息
-            if (methodMetadata.parameters.length > 0) {
-                logger.info('  - 参数:');
-                methodMetadata.parameters.forEach(param => {
-                    logger.info(`    * ${param.name} (${param.in}): ${param.description || '无描述'}`);
-                });
-            }
-            
-            // 输出请求体信息
-            if (methodMetadata.requestBody) {
-                logger.info(`  - 请求体: ${methodMetadata.requestBody.description || '无描述'}`);
-                logger.info(`    * 必需: ${methodMetadata.requestBody.required}`);
-            }
-            
-            // 输出响应信息
-            if (methodMetadata.responses.length > 0) {
-                logger.info('  - 响应:');
-                methodMetadata.responses.forEach(response => {
-                    logger.info(`    * ${response.status}: ${response.description}`);
-                });
-            }
-            
-        } catch (error) {
-            logger.error('处理方法级别注解失败:', error as Error);
-        }
-    }
-    
-    /**
-     * 运行所有示例
-     */
-    static async runAllExamples() {
-        try {
-            logger.info('开始运行Swagger处理器示例...');
-            
-            await this.processSingleController();
-            await this.validateSwaggerAnnotations();
-            await this.processMethodAnnotations();
-            await this.generateOpenAPISpec();
-            
-            logger.info('所有Swagger处理器示例运行完成！');
-            
-        } catch (error) {
-            logger.error('运行Swagger处理器示例失败:', error as Error);
-        }
-    }
-}

package/template/src/examples/TransactionManagerDemo.ts

@@ -1,377 +0,0 @@
-/**
- * TransactionManager 使用示例
- * 演示如何使用事务管理器处理各种数据库操作场景
- */
-
-import { transactionManager } from '@src/framework/utils/TransactionManager';
-import { logger } from '@src/framework/utils/logger';
-import { YtUserEntity } from '@src/entity/ytUser.entity';
-import { getDataSource } from '@src/framework/utils/db';
-import * as bcrypt from 'bcryptjs';
-
-/**
- * 示例 1: 基本事务使用
- * 创建用户并确保所有操作要么全部成功，要么全部失败
- */
-export async function example1_basicTransaction() {
-    try {
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            // 在这个事务中，所有操作都会在同一个事务上下文中执行
-            
-            // 操作 1: 创建用户
-            const user = new YtUserEntity();
-            user.email = 'demo@example.com';
-            user.telnumber = '13800138000';
-            user.password = await bcrypt.hash('password123', 10);
-            
-            const savedUser = await manager.save(user);
-            
-            // 操作 2: 更新用户信息
-            savedUser.email = 'updated@example.com';
-            const updatedUser = await manager.save(savedUser);
-            
-            return updatedUser;
-        });
-        
-        logger.info('事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 2: 使用隔离级别
- * 使用 SERIALIZABLE 隔离级别确保最高的数据一致性
- */
-export async function example2_transactionWithIsolationLevel() {
-    try {
-        const result = await transactionManager.executeInTransaction(
-            async (manager) => {
-                // 在 SERIALIZABLE 隔离级别下执行操作
-                // 这会锁定相关数据，防止并发问题
-                
-                const users = await manager.find(YtUserEntity, {
-                    where: { email: 'demo@example.com' }
-                });
-                
-                // 执行一些需要高度一致性的操作
-                for (const user of users) {
-                    user.updateDate = new Date();
-                    await manager.save(user);
-                }
-                
-                return users;
-            },
-            'SERIALIZABLE' // 指定隔离级别
-        );
-        
-        logger.info('隔离事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('隔离事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 3: 只读事务
- * 用于优化只读操作的性能
- */
-export async function example3_readOnlyTransaction() {
-    try {
-        const result = await transactionManager.executeInReadOnlyTransaction(async (manager) => {
-            // 只读事务，不会对数据产生任何修改
-            // 适合报表查询、统计分析等操作
-            
-            const totalUsers = await manager.count(YtUserEntity);
-            const activeUsers = await manager.count(YtUserEntity, {
-                where: { status: 'normal' } as any
-            });
-            
-            return {
-                total: totalUsers,
-                active: activeUsers,
-                inactive: totalUsers - activeUsers
-            };
-        });
-        
-        logger.info('只读事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('只读事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 4: 批量操作事务
- * 一次性处理多个操作，确保原子性
- */
-export async function example4_batchTransaction() {
-    try {
-        const operations = [
-            // 操作 1: 创建用户 1
-            async (manager: any) => {
-                const user1 = new YtUserEntity();
-                user1.email = 'user1@example.com';
-                user1.telnumber = '13800138001';
-                user1.password = await bcrypt.hash('pass123', 10);
-                return await manager.save(user1);
-            },
-            
-            // 操作 2: 创建用户 2
-            async (manager: any) => {
-                const user2 = new YtUserEntity();
-                user2.email = 'user2@example.com';
-                user2.telnumber = '13800138002';
-                user2.password = await bcrypt.hash('pass123', 10);
-                return await manager.save(user2);
-            },
-            
-            // 操作 3: 更新用户 1
-            async (manager: any) => {
-                const user = await manager.findOne(YtUserEntity, {
-                    where: { email: 'user1@example.com' }
-                });
-                if (user) {
-                    user.updateDate = new Date();
-                    return await manager.save(user);
-                }
-                return null;
-            }
-        ];
-        
-        const results = await transactionManager.executeBatchTransaction(operations);
-        
-        logger.info('批量事务执行成功，创建了', results.length, '个操作');
-        return results;
-        
-    } catch (error) {
-        logger.error('批量事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 5: 嵌套事务
- * 当需要在已经存在的事务中执行额外操作时使用
- */
-export async function example5_nestedTransaction() {
-    try {
-        // 外层事务
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            // 创建主用户
-            const mainUser = new YtUserEntity();
-            mainUser.email = 'main@example.com';
-            mainUser.telnumber = '13800138000';
-            mainUser.password = await bcrypt.hash('pass123', 10);
-            const savedMainUser = await manager.save(mainUser);
-            
-            // 使用嵌套事务创建相关数据
-            await transactionManager.executeNestedTransaction(async (nestedManager) => {
-                // 这些操作会使用现有的事务（如果有）
-                const relatedUser = new YtUserEntity();
-                relatedUser.email = 'related@example.com';
-                relatedUser.telnumber = '13800138001';
-                relatedUser.password = await bcrypt.hash('pass123', 10);
-                await nestedManager.save(relatedUser);
-            });
-            
-            return savedMainUser;
-        });
-        
-        logger.info('嵌套事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('嵌套事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 6: 错误处理和回滚
- * 演示当事务出错时如何自动回滚
- */
-export async function example6_errorHandlingAndRollback() {
-    try {
-        await transactionManager.executeInTransaction(async (manager) => {
-            // 操作 1: 创建用户
-            const user = new YtUserEntity();
-            user.email = 'test@example.com';
-            user.telnumber = '13800138000';
-            user.password = await bcrypt.hash('pass123', 10);
-            await manager.save(user);
-            
-            // 操作 2: 故意引发错误（模拟业务逻辑错误）
-            if (user.email === 'test@example.com') {
-                throw new Error('模拟业务错误：测试用户不允许');
-            }
-            
-            // 这段代码不会被执行，因为上面抛出了错误
-            user.email = 'updated@example.com';
-            await manager.save(user);
-        });
-        
-    } catch (error) {
-        // 所有操作都会被回滚
-        logger.error('事务已回滚，所有更改已撤销');
-        
-        // 验证：检查用户是否真的被回滚了
-        const dataSource = getDataSource();
-        if (dataSource) {
-            const user = await dataSource.manager.findOne(YtUserEntity, {
-                where: { email: 'test@example.com' }
-            });
-            
-            if (!user) {
-                logger.info('✅ 回滚验证通过：用户未被创建');
-            } else {
-                logger.warn('❌ 回滚验证失败：用户仍然存在');
-            }
-        }
-        
-        throw error;
-    }
-}
-
-/**
- * 示例 7: 复杂业务场景
- * 用户注册时需要同时创建多个相关记录
- */
-export async function example7_complexBusinessScenario(
-    userData: any,
-    profileData: any,
-    preferences: any
-) {
-    try {
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            // 步骤 1: 创建用户
-            const user = new YtUserEntity();
-            user.email = userData.email;
-            user.telnumber = userData.telnumber;
-            user.password = userData.password;
-            const savedUser = await manager.save(user);
-            
-            // 步骤 2: 创建用户配置（假设有配置表）
-            // const profile = await manager.save(ProfileEntity, profileData);
-            
-            // 步骤 3: 创建用户偏好（假设有偏好表）
-            // const preferences = await manager.save(PreferencesEntity, preferencesData);
-            
-            // 步骤 4: 发送欢迎通知（假设有通知表）
-            // const notification = await manager.save(NotificationEntity, {
-            //     userId: savedUser.id,
-            //     message: '欢迎注册！'
-            // });
-            
-            return {
-                user: savedUser,
-                // profile,
-                // preferences
-            };
-        });
-        
-        logger.info('复杂业务场景执行成功');
-        return result;
-        
-    } catch (error) {
-        logger.error('复杂业务场景执行失败，所有更改已回滚');
-        throw error;
-    }
-}
-
-/**
- * 示例 8: 条件事务
- * 根据条件决定是否提交事务
- */
-export async function example8_conditionalTransaction(userData: any, shouldCommit: boolean) {
-    try {
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            const user = new YtUserEntity();
-            user.email = userData.email;
-            user.telnumber = userData.telnumber;
-            user.password = userData.password;
-            const savedUser = await manager.save(user);
-            
-            // 模拟一些业务逻辑
-            if (!shouldCommit) {
-                // 即使在 try-catch 中不抛出错误，也可以通过返回值控制
-                logger.warn('业务逻辑决定不提交事务');
-                // 如果抛出自定义错误，事务会回滚
-                throw new Error('Business logic error: 不符合提交条件');
-            }
-            
-            return savedUser;
-        });
-        
-        logger.info('条件事务执行成功');
-        return result;
-        
-    } catch (error) {
-        logger.error('条件事务被回滚');
-        throw error;
-    }
-}
-
-// 使用示例函数
-export async function runAllExamples() {
-    console.log('=== TransactionManager 使用示例 ===\n');
-    
-    try {
-        // 示例 1: 基本事务
-        console.log('\n1. 基本事务示例');
-        // await example1_basicTransaction();
-        
-        // 示例 2: 隔离级别
-        console.log('\n2. 带隔离级别的事务示例');
-        // await example2_transactionWithIsolationLevel();
-        
-        // 示例 3: 只读事务
-        console.log('\n3. 只读事务示例');
-        // await example3_readOnlyTransaction();
-        
-        // 示例 4: 批量操作
-        console.log('\n4. 批量操作事务示例');
-        // await example4_batchTransaction();
-        
-        // 示例 5: 嵌套事务
-        console.log('\n5. 嵌套事务示例');
-        // await example5_nestedTransaction();
-        
-        // 示例 6: 错误处理
-        console.log('\n6. 错误处理和回滚示例');
-        // await example6_errorHandlingAndRollback();
-        
-        // 示例 7: 复杂业务场景
-        console.log('\n7. 复杂业务场景示例');
-        // await example7_complexBusinessScenario({}, {}, {});
-        
-        // 示例 8: 条件事务
-        console.log('\n8. 条件事务示例');
-        // await example8_conditionalTransaction({}, true);
-        
-        console.log('\n=== 所有示例运行完成 ===');
-        
-    } catch (error) {
-        logger.error('运行示例时发生错误:', error as Error);
-    }
-}
-
-// 导出所有示例
-export const transactionManagerExamples = {
-    basic: example1_basicTransaction,
-    withIsolation: example2_transactionWithIsolationLevel,
-    readOnly: example3_readOnlyTransaction,
-    batch: example4_batchTransaction,
-    nested: example5_nestedTransaction,
-    errorHandling: example6_errorHandlingAndRollback,
-    complex: example7_complexBusinessScenario,
-    conditional: example8_conditionalTransaction,
-    runAll: runAllExamples
-};