@nest-omni/core 4.1.3-11 → 4.1.3-12

package/audit/audit.module.js

@@ -81,6 +81,13 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 },
                 inject: [(0, typeorm_1.getDataSourceToken)(auditConnectionName)],
             },
+            {
+                provide: (0, typeorm_1.getRepositoryToken)(entities_1.AuditActionSummaryEntity),
+                useFactory: (dataSource) => {
+                    return dataSource.getRepository(entities_1.AuditActionSummaryEntity);
+                },
+                inject: [(0, typeorm_1.getDataSourceToken)(auditConnectionName)],
+            },
             {
                 provide: 'AUDIT_ENTITY_MANAGER',
                 useFactory: (dataSource) => {
@@ -98,6 +105,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
                     entities_1.EntityTransactionEntity,
                     entities_1.OperationTemplateEntity,
                     entities_1.ManualOperationLogEntity,
+                    entities_1.AuditActionSummaryEntity,
                 ], auditConnectionName),
                 nestjs_cls_1.ClsModule.forRoot({
                     global: true,
@@ -125,7 +133,9 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
                 services_1.OperationDescriptionService,
+                services_1.AuditActionService,
                 interceptors_1.AuditInterceptor,
+                interceptors_1.AuditActionInterceptor,
                 ...subscriberProviders,
             ],
             exports: [
@@ -135,7 +145,10 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
                 services_1.OperationDescriptionService,
+                services_1.AuditActionService,
                 interceptors_1.AuditInterceptor,
+                interceptors_1.AuditActionInterceptor,
+                (0, typeorm_1.getRepositoryToken)(entities_1.AuditActionSummaryEntity),
             ],
         };
     }
@@ -248,7 +261,9 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
                 services_1.OperationDescriptionService,
+                services_1.AuditActionService,
                 interceptors_1.AuditInterceptor,
+                interceptors_1.AuditActionInterceptor,
             ],
             exports: [
                 services_1.AuditContextService,
@@ -257,7 +272,9 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
                 services_1.OperationDescriptionService,
+                services_1.AuditActionService,
                 interceptors_1.AuditInterceptor,
+                interceptors_1.AuditActionInterceptor,
             ],
         };
     }

package/audit/controllers/audit.controller.d.ts

@@ -41,4 +41,68 @@ export declare class AuditController {
      * 回滚审计事务
      */
     rollbackTransaction(transactionId: string): Promise<void>;
+    /**
+     * 查询审计动作汇总记录
+     */
+    getAuditActions(userId?: string, username?: string, actionName?: string, success?: string, startTime?: string, endTime?: string, page?: number, limit?: number): Promise<PageDto<import("../entities").AuditActionSummaryEntity>>;
+    /**
+     * 查询单个审计动作的详细信息
+     */
+    getAuditActionDetail(actionId: string): Promise<{
+        summary: {
+            id: string;
+            actionName: string;
+            operationTemplateKey: string;
+            description: string;
+            descriptionParams: Record<string, any>;
+            success: boolean;
+            errorMessage: string;
+            duration: number;
+            userId: string;
+            username: string;
+            requestId: string;
+            requestIp: string;
+            userAgent: string;
+            entityChangesCount: number;
+            entityTypes: string[];
+            operationStats: Record<string, number>;
+            createdAt: Date;
+            metadata: Record<string, any>;
+        };
+        entityChanges: EntityAuditLogEntity[];
+        detailedChanges: {
+            id: string;
+            entityType: string;
+            entityId: string;
+            operation: import("..").AuditOperation;
+            operationLabel: string;
+            description: string;
+            sequenceInAction: number;
+            createdAt: Date;
+            oldValue: Record<string, any>;
+            newValue: Record<string, any>;
+            fieldChanges: {
+                field: string;
+                fieldLabel: string;
+                oldValue: any;
+                newValue: any;
+                changeType: "added" | "removed" | "modified" | "unchanged";
+                displayOldValue?: string;
+                displayNewValue?: string;
+            }[];
+            changedFieldsCount: number;
+            changedFields: string[];
+        }[];
+        statistics: {
+            totalChanges: number;
+            totalFieldChanges: number;
+            byEntityType: Record<string, number>;
+            byOperation: Record<string, number>;
+            operationSequence: {
+                sequence: number;
+                entityType: string;
+                operation: import("..").AuditOperation;
+            }[];
+        };
+    }>;
 }

package/audit/controllers/audit.controller.js

@@ -93,6 +93,31 @@ let AuditController = class AuditController {
             return this.transactionAuditService.rollbackTransaction(transactionId);
         });
     }
+    /**
+     * 查询审计动作汇总记录
+     */
+    getAuditActions(userId_1, username_1, actionName_1, success_1, startTime_1, endTime_1) {
+        return __awaiter(this, arguments, void 0, function* (userId, username, actionName, success, startTime, endTime, page = 1, limit = 20) {
+            return this.entityAuditService.getAuditActions({
+                userId,
+                username,
+                actionName,
+                success: success ? success === 'true' : undefined,
+                startTime: startTime ? new Date(startTime) : undefined,
+                endTime: endTime ? new Date(endTime) : undefined,
+                page,
+                limit,
+            });
+        });
+    }
+    /**
+     * 查询单个审计动作的详细信息
+     */
+    getAuditActionDetail(actionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.entityAuditService.getAuditActionDetail(actionId);
+        });
+    }
 };
 exports.AuditController = AuditController;
 __decorate([
@@ -158,6 +183,31 @@ __decorate([
     __metadata("design:paramtypes", [String]),
     __metadata("design:returntype", Promise)
 ], AuditController.prototype, "rollbackTransaction", null);
+__decorate([
+    (0, common_1.Get)('actions'),
+    (0, swagger_1.ApiOperation)({ summary: '查询审计动作汇总记录' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: '返回审计动作汇总列表' }),
+    __param(0, (0, common_1.Query)('userId')),
+    __param(1, (0, common_1.Query)('username')),
+    __param(2, (0, common_1.Query)('actionName')),
+    __param(3, (0, common_1.Query)('success')),
+    __param(4, (0, common_1.Query)('startTime')),
+    __param(5, (0, common_1.Query)('endTime')),
+    __param(6, (0, common_1.Query)('page')),
+    __param(7, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String, String, String, String, Number, Number]),
+    __metadata("design:returntype", Promise)
+], AuditController.prototype, "getAuditActions", null);
+__decorate([
+    (0, common_1.Get)('actions/:actionId'),
+    (0, swagger_1.ApiOperation)({ summary: '查询审计动作详细信息' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: '返回审计动作详细信息' }),
+    __param(0, (0, common_1.Param)('actionId')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AuditController.prototype, "getAuditActionDetail", null);
 exports.AuditController = AuditController = __decorate([
     (0, common_1.Controller)('audit'),
     (0, swagger_1.ApiTags)('audit'),

package/audit/decorators/audit-action.decorator.d.ts

@@ -0,0 +1,74 @@
+import { AuditParamsContext } from '../services/audit-context.service';
+export declare const AUDIT_ACTION_METADATA = "AUDIT_ACTION_METADATA";
+/**
+ * 审计动作选项
+ */
+export interface AuditActionOptions {
+    /**
+     * 操作模板键（可选）
+     * @example 'order.create'
+     */
+    templateKey?: string;
+    /**
+     * 参数构建器，用于从请求和实体变更中提取描述参数
+     * @param context - 包含 req, result, error, entityChanges 的上下文
+     * @returns 描述参数对象
+     *
+     * @example
+     * paramsBuilder: (context) => {
+     *   const order = context.findEntity('Order', 'CREATE');
+     *   const items = context.findEntities('OrderItem', 'CREATE');
+     *   return {
+     *     'order.sn': order?.newValue.orderSn,
+     *     'product.count': items.length,
+     *     'receiver': order?.newValue.receiverName,
+     *   };
+     * }
+     */
+    paramsBuilder?: (context: AuditParamsContext) => Record<string, any>;
+    /**
+     * 是否启用审计（默认 true）
+     */
+    enabled?: boolean;
+    /**
+     * 扩展元数据
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * 审计动作装饰器元数据
+ */
+export interface AuditActionMetadata {
+    actionName: string;
+    options: AuditActionOptions;
+}
+/**
+ * 审计动作装饰器
+ * 用于在控制器方法上标记审计动作，自动收集该请求中的所有实体变更
+ *
+ * @param actionName - 操作名称，如 'createOrder', 'cancelOrder'
+ * @param options - 审计动作选项
+ *
+ * @example
+ * ```typescript
+ * @Post()
+ * @AuditAction('createOrder', {
+ *   templateKey: 'order.create',
+ *   paramsBuilder: (context) => {
+ *     const order = context.findEntity('Order', 'CREATE');
+ *     const items = context.findEntities('OrderItem', 'CREATE');
+ *     return {
+ *       'order.sn': order?.newValue.orderSn,
+ *       'product.count': items.length,
+ *       'product.names': items.map(i => i.metadata?.productName).join('、'),
+ *       'receiver': order?.newValue.receiverName,
+ *       'totalAmount': order?.newValue.totalAmount,
+ *     };
+ *   }
+ * })
+ * async createOrder(@Body() dto: CreateOrderDto) {
+ *   return await this.orderService.create(dto);
+ * }
+ * ```
+ */
+export declare function AuditAction(actionName: string, options?: AuditActionOptions): MethodDecorator;

package/audit/decorators/audit-action.decorator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIT_ACTION_METADATA = void 0;
+exports.AuditAction = AuditAction;
+const common_1 = require("@nestjs/common");
+exports.AUDIT_ACTION_METADATA = 'AUDIT_ACTION_METADATA';
+/**
+ * 审计动作装饰器
+ * 用于在控制器方法上标记审计动作，自动收集该请求中的所有实体变更
+ *
+ * @param actionName - 操作名称，如 'createOrder', 'cancelOrder'
+ * @param options - 审计动作选项
+ *
+ * @example
+ * ```typescript
+ * @Post()
+ * @AuditAction('createOrder', {
+ *   templateKey: 'order.create',
+ *   paramsBuilder: (context) => {
+ *     const order = context.findEntity('Order', 'CREATE');
+ *     const items = context.findEntities('OrderItem', 'CREATE');
+ *     return {
+ *       'order.sn': order?.newValue.orderSn,
+ *       'product.count': items.length,
+ *       'product.names': items.map(i => i.metadata?.productName).join('、'),
+ *       'receiver': order?.newValue.receiverName,
+ *       'totalAmount': order?.newValue.totalAmount,
+ *     };
+ *   }
+ * })
+ * async createOrder(@Body() dto: CreateOrderDto) {
+ *   return await this.orderService.create(dto);
+ * }
+ * ```
+ */
+function AuditAction(actionName, options = {}) {
+    const metadata = {
+        actionName,
+        options: Object.assign({ enabled: true }, options),
+    };
+    return (0, common_1.SetMetadata)(exports.AUDIT_ACTION_METADATA, metadata);
+}

package/audit/decorators/entity-audit.decorator.d.ts

@@ -5,7 +5,7 @@ export declare const FIELD_AUDIT_OPTIONS: unique symbol;
  * 实体审计装饰器
  *
  * @description
- * 支持基础审计配置。
+ * 支持基础审计配置和多语言标签。
  * 字段标签和值标签请使用 @AuditField({ label: { zh: '姓名', en: 'Name' } })
  *
  * @param options 审计配置选项
@@ -14,6 +14,7 @@ export declare const FIELD_AUDIT_OPTIONS: unique symbol;
  * // 基础用法
  * @AuditEntity({
  *   enabled: true,
+ *   label: { zh: '订单', en: 'Order' },
  *   excludeFields: ['password'],
  *   maskFields: ['email']
  * })
@@ -22,6 +23,7 @@ export declare const FIELD_AUDIT_OPTIONS: unique symbol;
  * // 指定模板键
  * @AuditEntity({
  *   enabled: true,
+ *   label: { zh: '用户', en: 'User' },
  *   templateKey: 'user',
  * })
  */
@@ -78,3 +80,10 @@ export declare function getFieldLabel(target: any, fieldName: string, language?:
  * @returns 值的标签
  */
 export declare function getFieldValueLabel(target: any, fieldName: string, value: any, language?: string): string;
+/**
+ * 获取实体的标签（支持多语言）
+ * @param target 目标类
+ * @param language 语言代码（默认：zh）
+ * @returns 实体标签
+ */
+export declare function getEntityLabel(target: any, language?: string): string;

package/audit/decorators/entity-audit.decorator.js

@@ -7,6 +7,7 @@ exports.getEntityAuditConfig = getEntityAuditConfig;
 exports.getFieldAuditConfig = getFieldAuditConfig;
 exports.getFieldLabel = getFieldLabel;
 exports.getFieldValueLabel = getFieldValueLabel;
+exports.getEntityLabel = getEntityLabel;
 // 元数据键
 exports.ENTITY_AUDIT_OPTIONS = Symbol('ENTITY_AUDIT_OPTIONS');
 exports.FIELD_AUDIT_OPTIONS = Symbol('FIELD_AUDIT_OPTIONS');
@@ -14,7 +15,7 @@ exports.FIELD_AUDIT_OPTIONS = Symbol('FIELD_AUDIT_OPTIONS');
  * 实体审计装饰器
  *
  * @description
- * 支持基础审计配置。
+ * 支持基础审计配置和多语言标签。
  * 字段标签和值标签请使用 @AuditField({ label: { zh: '姓名', en: 'Name' } })
  *
  * @param options 审计配置选项
@@ -23,6 +24,7 @@ exports.FIELD_AUDIT_OPTIONS = Symbol('FIELD_AUDIT_OPTIONS');
  * // 基础用法
  * @AuditEntity({
  *   enabled: true,
+ *   label: { zh: '订单', en: 'Order' },
  *   excludeFields: ['password'],
  *   maskFields: ['email']
  * })
@@ -31,31 +33,27 @@ exports.FIELD_AUDIT_OPTIONS = Symbol('FIELD_AUDIT_OPTIONS');
  * // 指定模板键
  * @AuditEntity({
  *   enabled: true,
+ *   label: { zh: '用户', en: 'User' },
  *   templateKey: 'user',
  * })
  */
 function AuditEntity(options) {
     return (target) => {
-        // 处理兼容性：sensitiveFields 别名
-        const mergedOptions = Object.assign(Object.assign({}, options), { 
-            // 合并 sensitiveFields 到 maskFields
-            maskFields: [
-                ...((options === null || options === void 0 ? void 0 : options.maskFields) || []),
-                ...((options === null || options === void 0 ? void 0 : options.sensitiveFields) || []),
-            ] });
-        // 去重
-        if (mergedOptions.maskFields && mergedOptions.maskFields.length > 0) {
-            mergedOptions.maskFields = [...new Set(mergedOptions.maskFields)];
+        // 存储审计元数据
+        const auditOptions = Object.assign({}, options);
+        // 去重 maskFields
+        if (auditOptions.maskFields && auditOptions.maskFields.length > 0) {
+            auditOptions.maskFields = [...new Set(auditOptions.maskFields)];
         }
         // 存储基础审计元数据
-        Reflect.defineMetadata(exports.ENTITY_AUDIT_OPTIONS, mergedOptions, target);
+        Reflect.defineMetadata(exports.ENTITY_AUDIT_OPTIONS, auditOptions, target);
         // 如果有 templateKey，同时存储到 entity-log 元数据（兼容性）
-        if (mergedOptions.templateKey) {
+        if (auditOptions.templateKey) {
             Reflect.defineMetadata('entity-log:enabled', true, target);
             Reflect.defineMetadata('entity-log:options', {
-                templateKey: mergedOptions.templateKey,
-                excludeFields: mergedOptions.excludeFields,
-                sensitiveFields: mergedOptions.maskFields,
+                templateKey: auditOptions.templateKey,
+                excludeFields: auditOptions.excludeFields,
+                sensitiveFields: auditOptions.maskFields,
             }, target);
         }
     };
@@ -149,3 +147,23 @@ function getFieldValueLabel(target, fieldName, value, language = 'zh') {
     // 如果是对象，返回指定语言的值
     return labelMap[language] || labelMap['zh'] || value;
 }
+/**
+ * 获取实体的标签（支持多语言）
+ * @param target 目标类
+ * @param language 语言代码（默认：zh）
+ * @returns 实体标签
+ */
+function getEntityLabel(target, language = 'zh') {
+    const config = getEntityAuditConfig(target);
+    const label = config.label;
+    if (!label) {
+        // 如果没有配置标签，返回类名
+        return target.name || 'Entity';
+    }
+    // 如果是字符串，直接返回
+    if (typeof label === 'string') {
+        return label;
+    }
+    // 如果是对象，返回指定语言的值
+    return label[language] || label['zh'] || target.name || 'Entity';
+}

package/audit/decorators/index.d.ts

@@ -1,3 +1,4 @@
 export * from './entity-audit.decorator';
 export * from './audit-controller.decorator';
 export * from './audit-operation.decorator';
+export * from './audit-action.decorator';

package/audit/decorators/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./entity-audit.decorator"), exports);
 __exportStar(require("./audit-controller.decorator"), exports);
 __exportStar(require("./audit-operation.decorator"), exports);
+__exportStar(require("./audit-action.decorator"), exports);

package/audit/entities/audit-action-summary.entity.d.ts

@@ -0,0 +1,23 @@
+import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
+/**
+ * 审计动作汇总实体
+ * 记录一次 API 调用的审计摘要信息
+ */
+export declare class AuditActionSummaryEntity extends AbstractUuidPrimaryEntity {
+    actionName: string;
+    operationTemplateKey: string;
+    descriptionParams: Record<string, any>;
+    description: string;
+    requestId: string;
+    userId: string;
+    username: string;
+    requestIp: string;
+    userAgent: string;
+    entityChangesCount: number;
+    entityTypes: string[];
+    operationStats: Record<string, number>;
+    success: boolean;
+    errorMessage: string;
+    duration: number;
+    metadata: Record<string, any>;
+}

package/audit/entities/audit-action-summary.entity.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditActionSummaryEntity = void 0;
+const typeorm_1 = require("typeorm");
+const abstract_entity_1 = require("../../common/abstract.entity");
+/**
+ * 审计动作汇总实体
+ * 记录一次 API 调用的审计摘要信息
+ */
+let AuditActionSummaryEntity = class AuditActionSummaryEntity extends abstract_entity_1.AbstractUuidPrimaryEntity {
+};
+exports.AuditActionSummaryEntity = AuditActionSummaryEntity;
+__decorate([
+    (0, typeorm_1.Column)({ comment: '操作名称，如 createOrder, cancelOrder' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "actionName", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '操作模板键，用于多语言支持' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "operationTemplateKey", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '描述参数，用于填充模板' }),
+    __metadata("design:type", Object)
+], AuditActionSummaryEntity.prototype, "descriptionParams", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true, comment: '操作描述文本（根据模板生成）' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "description", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ comment: '请求ID' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "requestId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '用户ID' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "userId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '用户名' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "username", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '请求IP' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "requestIp", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true, comment: '用户代理' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "userAgent", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', default: 0, comment: '涉及的实体变更数量' }),
+    __metadata("design:type", Number)
+], AuditActionSummaryEntity.prototype, "entityChangesCount", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '涉及的实体类型列表' }),
+    __metadata("design:type", Array)
+], AuditActionSummaryEntity.prototype, "entityTypes", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '操作统计: {CREATE: 3, UPDATE: 2}' }),
+    __metadata("design:type", Object)
+], AuditActionSummaryEntity.prototype, "operationStats", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'boolean', default: true, comment: '操作是否成功' }),
+    __metadata("design:type", Boolean)
+], AuditActionSummaryEntity.prototype, "success", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true, comment: '错误信息（如果失败）' }),
+    __metadata("design:type", String)
+], AuditActionSummaryEntity.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', default: 0, comment: '操作耗时（毫秒）' }),
+    __metadata("design:type", Number)
+], AuditActionSummaryEntity.prototype, "duration", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '扩展元数据' }),
+    __metadata("design:type", Object)
+], AuditActionSummaryEntity.prototype, "metadata", void 0);
+exports.AuditActionSummaryEntity = AuditActionSummaryEntity = __decorate([
+    (0, typeorm_1.Entity)('audit_action_summary')
+    // 单字段索引
+    ,
+    (0, typeorm_1.Index)('idx_action_name', ['actionName']),
+    (0, typeorm_1.Index)('idx_request_id', ['requestId']),
+    (0, typeorm_1.Index)('idx_user', ['userId']),
+    (0, typeorm_1.Index)('idx_created_at', ['createdAt']),
+    (0, typeorm_1.Index)('idx_success', ['success'])
+    // 复合索引 - 优化常见查询
+    ,
+    (0, typeorm_1.Index)('idx_action_user', ['actionName', 'userId']),
+    (0, typeorm_1.Index)('idx_user_time', ['userId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_success_time', ['success', 'createdAt']),
+    (0, typeorm_1.Index)('idx_action_success_time', ['actionName', 'success', 'createdAt'])
+], AuditActionSummaryEntity);

package/audit/entities/entity-audit-log.entity.d.ts

@@ -19,6 +19,9 @@ export declare class EntityAuditLogEntity extends AbstractUuidPrimaryEntity {
     userAgent: string;
     description: string;
     hashChain: Record<string, any>;
+    auditActionId: string;
+    auditActionName: string;
+    sequenceInAction: number;
     operationTemplateKey: string;
     descriptionParams: Record<string, any>;
     changeDetails: ChangeDetail[];

package/audit/entities/entity-audit-log.entity.js

@@ -75,6 +75,18 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '哈希链' }),
     __metadata("design:type", Object)
 ], EntityAuditLogEntity.prototype, "hashChain", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '审计动作ID，用于关联同一业务操作的多个实体变化' }),
+    __metadata("design:type", String)
+], EntityAuditLogEntity.prototype, "auditActionId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '审计动作名称，如 createOrder、updateUser' }),
+    __metadata("design:type", String)
+], EntityAuditLogEntity.prototype, "auditActionName", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', default: 0, comment: '在审计动作内的序号' }),
+    __metadata("design:type", Number)
+], EntityAuditLogEntity.prototype, "sequenceInAction", void 0);
 __decorate([
     (0, typeorm_1.Column)({ nullable: true, comment: '操作模板键，用于动态生成描述' }),
     __metadata("design:type", String)
@@ -104,10 +116,21 @@ __decorate([
     __metadata("design:type", Array)
 ], EntityAuditLogEntity.prototype, "rollbackActions", void 0);
 exports.EntityAuditLogEntity = EntityAuditLogEntity = __decorate([
-    (0, typeorm_1.Entity)('entity_audit_log'),
+    (0, typeorm_1.Entity)('entity_audit_log')
+    // 单字段索引
+    ,
     (0, typeorm_1.Index)('idx_entity_relation', ['entityType', 'entityId']),
     (0, typeorm_1.Index)('idx_operation', ['operation']),
     (0, typeorm_1.Index)('idx_user', ['userId']),
     (0, typeorm_1.Index)('idx_created_at', ['createdAt']),
-    (0, typeorm_1.Index)('idx_template_key', ['operationTemplateKey'])
+    (0, typeorm_1.Index)('idx_template_key', ['operationTemplateKey']),
+    (0, typeorm_1.Index)('idx_request_id', ['requestId']),
+    (0, typeorm_1.Index)('idx_audit_action', ['auditActionId'])
+    // 复合索引 - 优化常见查询
+    ,
+    (0, typeorm_1.Index)('idx_entity_operation', ['entityType', 'entityId', 'operation']),
+    (0, typeorm_1.Index)('idx_entity_time', ['entityType', 'entityId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_user_time', ['userId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_request_time', ['requestId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_action_sequence', ['auditActionId', 'sequenceInAction'])
 ], EntityAuditLogEntity);

package/audit/entities/entity-transaction.entity.d.ts

@@ -1,12 +1,11 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
-import { AuditOperation, TransactionStatus } from '../enums';
-import { ManualOperationLogEntity } from './manual-operation-log.entity';
+import { AuditOperation, AuditTransactionStatus } from '../enums';
 /**
  * 实体事务
  */
 export declare class EntityTransactionEntity extends AbstractUuidPrimaryEntity {
     description: string;
-    status: TransactionStatus;
+    status: AuditTransactionStatus;
     entities: Array<{
         entityType: string;
         entityId: string;
@@ -20,5 +19,5 @@ export declare class EntityTransactionEntity extends AbstractUuidPrimaryEntity {
     requestIp: string;
     metadata: Record<string, any>;
     completedAt: Date;
-    manualOperations: ManualOperationLogEntity[];
+    manualOperations: any[];
 }