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

package/{audit → dist/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/dist/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/dist/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 → dist/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 → dist/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 → dist/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 → dist/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/dist/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/dist/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 → dist/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 → dist/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 → dist/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[];
 }

package/{audit → dist/audit}/entities/entity-transaction.entity.js

@@ -24,7 +24,7 @@ __decorate([
     __metadata("design:type", String)
 ], EntityTransactionEntity.prototype, "description", void 0);
 __decorate([
-    (0, typeorm_1.Column)({ type: 'enum', enum: enums_1.TransactionStatus, comment: '事务状态' }),
+    (0, typeorm_1.Column)({ type: 'enum', enum: enums_1.AuditTransactionStatus, comment: '事务状态' }),
     __metadata("design:type", String)
 ], EntityTransactionEntity.prototype, "status", void 0);
 __decorate([
@@ -71,13 +71,20 @@ __decorate([
     __metadata("design:type", Date)
 ], EntityTransactionEntity.prototype, "completedAt", void 0);
 __decorate([
-    (0, typeorm_1.OneToMany)('ManualOperationLogEntity', (log) => log.transaction),
+    (0, typeorm_1.OneToMany)('ManualOperationLogEntity', 'transaction'),
     __metadata("design:type", Array)
 ], EntityTransactionEntity.prototype, "manualOperations", void 0);
 exports.EntityTransactionEntity = EntityTransactionEntity = __decorate([
-    (0, typeorm_1.Entity)('entity_transaction'),
+    (0, typeorm_1.Entity)('entity_transaction')
+    // 单字段索引
+    ,
     (0, typeorm_1.Index)('idx_status', ['status']),
     (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_user_status', ['userId', 'status']),
+    (0, typeorm_1.Index)('idx_user_time', ['userId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_status_time', ['status', 'createdAt'])
 ], EntityTransactionEntity);

package/{audit → dist/audit}/entities/index.d.ts

@@ -2,3 +2,4 @@ export * from './entity-audit-log.entity';
 export * from './entity-transaction.entity';
 export * from './operation-template.entity';
 export * from './manual-operation-log.entity';
+export * from './audit-action-summary.entity';

package/{audit → dist/audit}/entities/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./entity-audit-log.entity"), exports);
 __exportStar(require("./entity-transaction.entity"), exports);
 __exportStar(require("./operation-template.entity"), exports);
 __exportStar(require("./manual-operation-log.entity"), exports);
+__exportStar(require("./audit-action-summary.entity"), exports);

package/{audit → dist/audit}/entities/manual-operation-log.entity.js

@@ -78,9 +78,16 @@ __decorate([
     __metadata("design:type", entity_transaction_entity_1.EntityTransactionEntity)
 ], ManualOperationLogEntity.prototype, "transaction", void 0);
 exports.ManualOperationLogEntity = ManualOperationLogEntity = __decorate([
-    (0, typeorm_1.Entity)('manual_operation_log'),
+    (0, typeorm_1.Entity)('manual_operation_log')
+    // 单字段索引
+    ,
     (0, typeorm_1.Index)('idx_transaction', ['transactionId']),
     (0, typeorm_1.Index)('idx_template_key', ['operationTemplateKey']),
     (0, typeorm_1.Index)('idx_user', ['userId']),
     (0, typeorm_1.Index)('idx_created_at', ['createdAt'])
+    // 复合索引 - 优化常见查询
+    ,
+    (0, typeorm_1.Index)('idx_transaction_time', ['transactionId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_user_time', ['userId', 'createdAt']),
+    (0, typeorm_1.Index)('idx_template_user', ['operationTemplateKey', 'userId'])
 ], ManualOperationLogEntity);

package/{audit → dist/audit}/enums/audit.enums.d.ts

@@ -1,14 +1,5 @@
-/**
- * 操作类型（设计文档标准命名）
- */
-export declare enum OperationType {
-    CREATE = "create",
-    UPDATE = "update",
-    DELETE = "delete"
-}
 /**
  * 审计操作类型（兼容性别名，映射到 OperationType）
- * @deprecated 请使用 OperationType
  */
 export declare enum AuditOperation {
     CREATE = "CREATE",
@@ -19,7 +10,7 @@ export declare enum AuditOperation {
 /**
  * 事务状态（设计文档标准命名）
  */
-export declare enum TransactionStatus {
+export declare enum AuditTransactionStatus {
     PENDING = "pending",
     COMMITTED = "committed",
     ROLLED_BACK = "rolled_back"

package/{audit → dist/audit}/enums/audit.enums.js

@@ -1,18 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChangeType = exports.RollbackActionType = exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.TransactionStatus = exports.AuditOperation = exports.OperationType = void 0;
-/**
- * 操作类型（设计文档标准命名）
- */
-var OperationType;
-(function (OperationType) {
-    OperationType["CREATE"] = "create";
-    OperationType["UPDATE"] = "update";
-    OperationType["DELETE"] = "delete";
-})(OperationType || (exports.OperationType = OperationType = {}));
+exports.ChangeType = exports.RollbackActionType = exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.AuditTransactionStatus = exports.AuditOperation = void 0;
 /**
  * 审计操作类型（兼容性别名，映射到 OperationType）
- * @deprecated 请使用 OperationType
  */
 var AuditOperation;
 (function (AuditOperation) {
@@ -24,12 +14,12 @@ var AuditOperation;
 /**
  * 事务状态（设计文档标准命名）
  */
-var TransactionStatus;
-(function (TransactionStatus) {
-    TransactionStatus["PENDING"] = "pending";
-    TransactionStatus["COMMITTED"] = "committed";
-    TransactionStatus["ROLLED_BACK"] = "rolled_back";
-})(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+var AuditTransactionStatus;
+(function (AuditTransactionStatus) {
+    AuditTransactionStatus["PENDING"] = "pending";
+    AuditTransactionStatus["COMMITTED"] = "committed";
+    AuditTransactionStatus["ROLLED_BACK"] = "rolled_back";
+})(AuditTransactionStatus || (exports.AuditTransactionStatus = AuditTransactionStatus = {}));
 /**
  * 恢复策略
  */