@nest-omni/core 4.1.3-2 → 4.1.3-20

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

@@ -13,6 +13,9 @@ exports.EntityTransactionEntity = void 0;
 const typeorm_1 = require("typeorm");
 const abstract_entity_1 = require("../../common/abstract.entity");
 const enums_1 = require("../enums");
+/**
+ * 实体事务
+ */
 let EntityTransactionEntity = class EntityTransactionEntity extends abstract_entity_1.AbstractUuidPrimaryEntity {
 };
 exports.EntityTransactionEntity = EntityTransactionEntity;
@@ -21,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([
@@ -43,9 +46,45 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '依赖图' }),
     __metadata("design:type", Object)
 ], EntityTransactionEntity.prototype, "dependencyGraph", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '操作模板键（事务级别）' }),
+    __metadata("design:type", String)
+], EntityTransactionEntity.prototype, "operationTemplateKey", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'json',
+        nullable: true,
+        comment: '描述参数，用于填充事务级别的模板占位符',
+    }),
+    __metadata("design:type", Object)
+], EntityTransactionEntity.prototype, "descriptionParams", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, comment: '请求IP' }),
+    __metadata("design:type", String)
+], EntityTransactionEntity.prototype, "requestIp", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '事务元数据' }),
+    __metadata("design:type", Object)
+], EntityTransactionEntity.prototype, "metadata", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'timestamp', nullable: true, comment: '完成时间' }),
+    __metadata("design:type", Date)
+], EntityTransactionEntity.prototype, "completedAt", void 0);
+__decorate([
+    (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_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/entities/index.d.ts

@@ -1,2 +1,5 @@
 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/entities/index.js

@@ -16,3 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __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/entities/manual-operation-log.entity.d.ts

@@ -1,6 +1,10 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { EntityTransactionEntity } from './entity-transaction.entity';
 import { RollbackAction } from '../interfaces';
+/**
+ * 手动操作记录表
+ * 用于记录跨实体的复杂业务操作
+ */
 export declare class ManualOperationLogEntity extends AbstractUuidPrimaryEntity {
     transactionId: string;
     operationTemplateKey: string;

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

@@ -13,6 +13,10 @@ exports.ManualOperationLogEntity = void 0;
 const typeorm_1 = require("typeorm");
 const abstract_entity_1 = require("../../common/abstract.entity");
 const entity_transaction_entity_1 = require("./entity-transaction.entity");
+/**
+ * 手动操作记录表
+ * 用于记录跨实体的复杂业务操作
+ */
 let ManualOperationLogEntity = class ManualOperationLogEntity extends abstract_entity_1.AbstractUuidPrimaryEntity {
 };
 exports.ManualOperationLogEntity = ManualOperationLogEntity;
@@ -74,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/entities/operation-template.entity.d.ts

@@ -1,5 +1,9 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { AuditOperation } from '../enums';
+/**
+ * 操作模板配置表
+ * 用于存储多语言操作描述模板
+ */
 export declare class OperationTemplateEntity extends AbstractUuidPrimaryEntity {
     key: string;
     entityName: string;

package/audit/entities/operation-template.entity.js

@@ -13,6 +13,10 @@ exports.OperationTemplateEntity = void 0;
 const typeorm_1 = require("typeorm");
 const abstract_entity_1 = require("../../common/abstract.entity");
 const enums_1 = require("../enums");
+/**
+ * 操作模板配置表
+ * 用于存储多语言操作描述模板
+ */
 let OperationTemplateEntity = class OperationTemplateEntity extends abstract_entity_1.AbstractUuidPrimaryEntity {
 };
 exports.OperationTemplateEntity = OperationTemplateEntity;

package/audit/enums/audit.enums.d.ts

@@ -1,27 +1,58 @@
+/**
+ * 审计操作类型（兼容性别名，映射到 OperationType）
+ */
 export declare enum AuditOperation {
     CREATE = "CREATE",
     UPDATE = "UPDATE",
     DELETE = "DELETE",
     RESTORE = "RESTORE"
 }
-export declare enum TransactionStatus {
-    PENDING = "PENDING",
-    COMMITTED = "COMMITTED",
-    ROLLED_BACK = "ROLLED_BACK"
+/**
+ * 事务状态（设计文档标准命名）
+ */
+export declare enum AuditTransactionStatus {
+    PENDING = "pending",
+    COMMITTED = "committed",
+    ROLLED_BACK = "rolled_back"
 }
+/**
+ * 恢复策略
+ */
 export declare enum RecoveryStrategy {
     ENTITY_ONLY = "ENTITY_ONLY",
     TRANSACTION_RESTORE = "TRANSACTION_RESTORE",
     DEPENDENCY_GRAPH = "DEPENDENCY_GRAPH"
 }
+/**
+ * 记录策略
+ */
 export declare enum RecordStrategy {
-    FULL = "FULL",
-    DIFF_ONLY = "DIFF_ONLY",
+    FULL = "FULL",// 记录完整变更
+    DIFF_ONLY = "DIFF_ONLY",// 仅记录差异
     DISABLED = "DISABLED"
 }
+/**
+ * 脱敏策略
+ */
 export declare enum MaskingStrategy {
     NONE = "NONE",
     HASH = "HASH",
     MASK = "MASK",
     PARTIAL = "PARTIAL"
 }
+/**
+ * 回滚操作类型（设计文档标准命名）
+ */
+export declare enum RollbackActionType {
+    ENTITY = "entity",// 实体回滚（删除/恢复）
+    FILE = "file",// 文件回滚（删除上传的文件）
+    CUSTOM = "custom"
+}
+/**
+ * 变更类型（设计文档标准命名）
+ */
+export declare enum ChangeType {
+    ADDED = "added",// 新增字段
+    REMOVED = "removed",// 删除字段
+    MODIFIED = "modified"
+}

package/audit/enums/audit.enums.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.TransactionStatus = exports.AuditOperation = void 0;
+exports.ChangeType = exports.RollbackActionType = exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.AuditTransactionStatus = exports.AuditOperation = void 0;
+/**
+ * 审计操作类型（兼容性别名，映射到 OperationType）
+ */
 var AuditOperation;
 (function (AuditOperation) {
     AuditOperation["CREATE"] = "CREATE";
@@ -8,24 +11,36 @@ var AuditOperation;
     AuditOperation["DELETE"] = "DELETE";
     AuditOperation["RESTORE"] = "RESTORE";
 })(AuditOperation || (exports.AuditOperation = 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 = {}));
+/**
+ * 恢复策略
+ */
 var RecoveryStrategy;
 (function (RecoveryStrategy) {
     RecoveryStrategy["ENTITY_ONLY"] = "ENTITY_ONLY";
     RecoveryStrategy["TRANSACTION_RESTORE"] = "TRANSACTION_RESTORE";
     RecoveryStrategy["DEPENDENCY_GRAPH"] = "DEPENDENCY_GRAPH";
 })(RecoveryStrategy || (exports.RecoveryStrategy = RecoveryStrategy = {}));
+/**
+ * 记录策略
+ */
 var RecordStrategy;
 (function (RecordStrategy) {
     RecordStrategy["FULL"] = "FULL";
     RecordStrategy["DIFF_ONLY"] = "DIFF_ONLY";
     RecordStrategy["DISABLED"] = "DISABLED";
 })(RecordStrategy || (exports.RecordStrategy = RecordStrategy = {}));
+/**
+ * 脱敏策略
+ */
 var MaskingStrategy;
 (function (MaskingStrategy) {
     MaskingStrategy["NONE"] = "NONE";
@@ -33,3 +48,21 @@ var MaskingStrategy;
     MaskingStrategy["MASK"] = "MASK";
     MaskingStrategy["PARTIAL"] = "PARTIAL";
 })(MaskingStrategy || (exports.MaskingStrategy = MaskingStrategy = {}));
+/**
+ * 回滚操作类型（设计文档标准命名）
+ */
+var RollbackActionType;
+(function (RollbackActionType) {
+    RollbackActionType["ENTITY"] = "entity";
+    RollbackActionType["FILE"] = "file";
+    RollbackActionType["CUSTOM"] = "custom";
+})(RollbackActionType || (exports.RollbackActionType = RollbackActionType = {}));
+/**
+ * 变更类型（设计文档标准命名）
+ */
+var ChangeType;
+(function (ChangeType) {
+    ChangeType["ADDED"] = "added";
+    ChangeType["REMOVED"] = "removed";
+    ChangeType["MODIFIED"] = "modified";
+})(ChangeType || (exports.ChangeType = ChangeType = {}));

package/audit/index.d.ts

@@ -2,7 +2,10 @@ export * from './entities';
 export * from './enums';
 export * from './interfaces';
 export * from './dto';
-export * from './decorators';
+export { AuditEntity, AuditField, getEntityAuditConfig, getFieldAuditConfig, getFieldLabel, getFieldValueLabel, getEntityLabel, ENTITY_AUDIT_OPTIONS, FIELD_AUDIT_OPTIONS, } from './decorators/entity-audit.decorator';
+export { AuditController, AuditMethod, CONTROLLER_AUDIT_OPTIONS, METHOD_AUDIT_OPTIONS, } from './decorators/audit-controller.decorator';
+export { AuditLog, getAuditOperationConfig, hasAuditOperation, AUDIT_OPERATION_OPTIONS, } from './decorators/audit-operation.decorator';
+export { AuditAction, AuditActionOptions, AuditActionMetadata, AUDIT_ACTION_METADATA, } from './decorators/audit-action.decorator';
 export * from './services';
 export * from './subscribers';
 export * from './interceptors';

package/audit/index.js

@@ -14,13 +14,46 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIT_ACTION_METADATA = exports.AuditAction = exports.AUDIT_OPERATION_OPTIONS = exports.hasAuditOperation = exports.getAuditOperationConfig = exports.AuditLog = exports.METHOD_AUDIT_OPTIONS = exports.CONTROLLER_AUDIT_OPTIONS = exports.AuditMethod = exports.AuditController = exports.FIELD_AUDIT_OPTIONS = exports.ENTITY_AUDIT_OPTIONS = exports.getEntityLabel = exports.getFieldValueLabel = exports.getFieldLabel = exports.getFieldAuditConfig = exports.getEntityAuditConfig = exports.AuditField = exports.AuditEntity = void 0;
+// Entities
 __exportStar(require("./entities"), exports);
+// Enums
 __exportStar(require("./enums"), exports);
+// Interfaces
 __exportStar(require("./interfaces"), exports);
+// DTO
 __exportStar(require("./dto"), exports);
-__exportStar(require("./decorators"), exports);
+// Decorators - explicit exports
+var entity_audit_decorator_1 = require("./decorators/entity-audit.decorator");
+Object.defineProperty(exports, "AuditEntity", { enumerable: true, get: function () { return entity_audit_decorator_1.AuditEntity; } });
+Object.defineProperty(exports, "AuditField", { enumerable: true, get: function () { return entity_audit_decorator_1.AuditField; } });
+Object.defineProperty(exports, "getEntityAuditConfig", { enumerable: true, get: function () { return entity_audit_decorator_1.getEntityAuditConfig; } });
+Object.defineProperty(exports, "getFieldAuditConfig", { enumerable: true, get: function () { return entity_audit_decorator_1.getFieldAuditConfig; } });
+Object.defineProperty(exports, "getFieldLabel", { enumerable: true, get: function () { return entity_audit_decorator_1.getFieldLabel; } });
+Object.defineProperty(exports, "getFieldValueLabel", { enumerable: true, get: function () { return entity_audit_decorator_1.getFieldValueLabel; } });
+Object.defineProperty(exports, "getEntityLabel", { enumerable: true, get: function () { return entity_audit_decorator_1.getEntityLabel; } });
+Object.defineProperty(exports, "ENTITY_AUDIT_OPTIONS", { enumerable: true, get: function () { return entity_audit_decorator_1.ENTITY_AUDIT_OPTIONS; } });
+Object.defineProperty(exports, "FIELD_AUDIT_OPTIONS", { enumerable: true, get: function () { return entity_audit_decorator_1.FIELD_AUDIT_OPTIONS; } });
+var audit_controller_decorator_1 = require("./decorators/audit-controller.decorator");
+Object.defineProperty(exports, "AuditController", { enumerable: true, get: function () { return audit_controller_decorator_1.AuditController; } });
+Object.defineProperty(exports, "AuditMethod", { enumerable: true, get: function () { return audit_controller_decorator_1.AuditMethod; } });
+Object.defineProperty(exports, "CONTROLLER_AUDIT_OPTIONS", { enumerable: true, get: function () { return audit_controller_decorator_1.CONTROLLER_AUDIT_OPTIONS; } });
+Object.defineProperty(exports, "METHOD_AUDIT_OPTIONS", { enumerable: true, get: function () { return audit_controller_decorator_1.METHOD_AUDIT_OPTIONS; } });
+var audit_operation_decorator_1 = require("./decorators/audit-operation.decorator");
+Object.defineProperty(exports, "AuditLog", { enumerable: true, get: function () { return audit_operation_decorator_1.AuditLog; } });
+Object.defineProperty(exports, "getAuditOperationConfig", { enumerable: true, get: function () { return audit_operation_decorator_1.getAuditOperationConfig; } });
+Object.defineProperty(exports, "hasAuditOperation", { enumerable: true, get: function () { return audit_operation_decorator_1.hasAuditOperation; } });
+Object.defineProperty(exports, "AUDIT_OPERATION_OPTIONS", { enumerable: true, get: function () { return audit_operation_decorator_1.AUDIT_OPERATION_OPTIONS; } });
+var audit_action_decorator_1 = require("./decorators/audit-action.decorator");
+Object.defineProperty(exports, "AuditAction", { enumerable: true, get: function () { return audit_action_decorator_1.AuditAction; } });
+Object.defineProperty(exports, "AUDIT_ACTION_METADATA", { enumerable: true, get: function () { return audit_action_decorator_1.AUDIT_ACTION_METADATA; } });
+// Services
 __exportStar(require("./services"), exports);
+// Subscribers
 __exportStar(require("./subscribers"), exports);
+// Interceptors
 __exportStar(require("./interceptors"), exports);
+// Controllers
 __exportStar(require("./controllers"), exports);
+// Module
 __exportStar(require("./audit.module"), exports);

package/audit/interceptors/audit-action.interceptor.d.ts

@@ -0,0 +1,38 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { Repository } from 'typeorm';
+import { AuditContextService } from '../services/audit-context.service';
+import { OperationDescriptionService } from '../services/operation-description.service';
+import { AuditActionSummaryEntity } from '../entities';
+/**
+ * 审计动作拦截器
+ * 在请求开始时创建审计动作上下文，在请求结束时生成汇总记录
+ */
+export declare class AuditActionInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly contextService;
+    private readonly summaryRepository;
+    private readonly descriptionService?;
+    constructor(reflector: Reflector, contextService: AuditContextService, summaryRepository: Repository<AuditActionSummaryEntity>, descriptionService?: OperationDescriptionService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * 生成审计汇总记录
+     */
+    private generateSummary;
+    /**
+     * 生成操作描述文本
+     * 优先从 OperationDescriptionService 获取多语言模板
+     * 如果没有，则使用默认格式
+     */
+    private generateDescription;
+    /**
+     * 替换模板中的占位符
+     * 支持格式：{key} 或 {key:format}
+     */
+    private replaceTemplatePlaceholders;
+    /**
+     * 格式化值为字符串
+     */
+    private formatValue;
+}

package/audit/interceptors/audit-action.interceptor.js

@@ -0,0 +1,215 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditActionInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const audit_context_service_1 = require("../services/audit-context.service");
+const operation_description_service_1 = require("../services/operation-description.service");
+const entities_1 = require("../entities");
+const audit_action_decorator_1 = require("../decorators/audit-action.decorator");
+/**
+ * 审计动作拦截器
+ * 在请求开始时创建审计动作上下文，在请求结束时生成汇总记录
+ */
+let AuditActionInterceptor = class AuditActionInterceptor {
+    constructor(reflector, contextService, summaryRepository, descriptionService) {
+        this.reflector = reflector;
+        this.contextService = contextService;
+        this.summaryRepository = summaryRepository;
+        this.descriptionService = descriptionService;
+    }
+    intercept(context, next) {
+        // 获取装饰器元数据
+        const metadata = this.reflector.get(audit_action_decorator_1.AUDIT_ACTION_METADATA, context.getHandler());
+        // 如果没有 @AuditAction 装饰器或已禁用，直接放行
+        if (!metadata || metadata.options.enabled === false) {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const actionId = this.contextService.generateActionId();
+        const startTime = new Date();
+        // 创建审计动作上下文
+        const actionContext = {
+            actionId,
+            actionName: metadata.actionName,
+            operationTemplateKey: metadata.options.templateKey,
+            paramsBuilder: metadata.options.paramsBuilder,
+            startTime,
+            entityChanges: [],
+            detailedChanges: [],
+            req: request,
+        };
+        // 设置到 CLS
+        this.contextService.setActionContext(actionContext);
+        return next.handle().pipe((0, operators_1.tap)((result) => __awaiter(this, void 0, void 0, function* () {
+            // 请求成功，记录结果
+            actionContext.result = result;
+            yield this.generateSummary(actionContext, metadata, false);
+        })), (0, operators_1.catchError)((error) => __awaiter(this, void 0, void 0, function* () {
+            // 请求失败，记录错误
+            actionContext.error = error;
+            yield this.generateSummary(actionContext, metadata, true, error);
+            return (0, rxjs_1.throwError)(() => error);
+        })));
+    }
+    /**
+     * 生成审计汇总记录
+     */
+    generateSummary(actionContext, metadata, hasError, error) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const duration = Date.now() - actionContext.startTime.getTime();
+                const auditContext = yield this.contextService.getCurrentContext();
+                // 构建描述参数
+                let descriptionParams = {};
+                if (metadata.options.paramsBuilder) {
+                    const paramsContext = this.contextService.buildParamsContext();
+                    if (paramsContext) {
+                        descriptionParams = metadata.options.paramsBuilder(paramsContext);
+                    }
+                }
+                // 生成描述文本
+                const description = yield this.generateDescription(actionContext.operationTemplateKey, actionContext.actionName, descriptionParams, !hasError);
+                // 统计实体类型和操作
+                const entityTypes = Array.from(new Set(actionContext.detailedChanges.map((c) => c.entityType)));
+                const operationStats = {};
+                actionContext.detailedChanges.forEach((change) => {
+                    const op = change.operation;
+                    operationStats[op] = (operationStats[op] || 0) + 1;
+                });
+                // 创建汇总记录
+                const summary = this.summaryRepository.create({
+                    id: actionContext.actionId,
+                    actionName: actionContext.actionName,
+                    operationTemplateKey: actionContext.operationTemplateKey,
+                    descriptionParams,
+                    description,
+                    requestId: auditContext.requestId || '',
+                    userId: auditContext.userId || '',
+                    username: auditContext.username || '',
+                    requestIp: auditContext.requestIp || '',
+                    userAgent: auditContext.userAgent || '',
+                    entityChangesCount: actionContext.detailedChanges.length,
+                    entityTypes,
+                    operationStats,
+                    success: !hasError,
+                    errorMessage: error === null || error === void 0 ? void 0 : error.message,
+                    duration,
+                    metadata: metadata.options.metadata,
+                });
+                yield this.summaryRepository.save(summary);
+            }
+            catch (err) {
+                console.error('Failed to generate audit action summary:', err);
+            }
+            finally {
+                // 清除审计动作上下文
+                this.contextService.clearActionContext();
+            }
+        });
+    }
+    /**
+     * 生成操作描述文本
+     * 优先从 OperationDescriptionService 获取多语言模板
+     * 如果没有，则使用默认格式
+     */
+    generateDescription(templateKey, actionName, params, success) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let template;
+            // 1. 尝试从模板服务获取模板
+            if (templateKey && this.descriptionService) {
+                try {
+                    template = yield this.descriptionService.getTemplate(templateKey);
+                }
+                catch (error) {
+                    // 如果获取模板失败，继续使用默认逻辑
+                }
+            }
+            // 2. 如果没有模板，使用默认格式
+            if (!template) {
+                template = success
+                    ? `执行操作: ${actionName}`
+                    : `执行操作失败: ${actionName}`;
+            }
+            // 3. 执行模板替换
+            return this.replaceTemplatePlaceholders(template, params);
+        });
+    }
+    /**
+     * 替换模板中的占位符
+     * 支持格式：{key} 或 {key:format}
+     */
+    replaceTemplatePlaceholders(template, params) {
+        let result = template;
+        // 遍历所有参数，替换占位符
+        Object.entries(params).forEach(([key, value]) => {
+            const placeholder = `{${key}}`;
+            const valueStr = this.formatValue(value);
+            // 替换所有匹配的占位符
+            const regex = new RegExp(placeholder.replace(/[{}]/g, '\\$&'), 'g');
+            result = result.replace(regex, valueStr);
+        });
+        // 清理未替换的占位符
+        result = result.replace(/\{[^}]+\}/g, '');
+        return result;
+    }
+    /**
+     * 格式化值为字符串
+     */
+    formatValue(value) {
+        if (value === null || value === undefined) {
+            return '';
+        }
+        if (Array.isArray(value)) {
+            // 处理数组
+            if (value.length === 0) {
+                return '';
+            }
+            // 如果是对象数组，序列化
+            if (typeof value[0] === 'object') {
+                return JSON.stringify(value);
+            }
+            // 否则用顿号连接
+            return value.join('、');
+        }
+        if (typeof value === 'object') {
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+};
+exports.AuditActionInterceptor = AuditActionInterceptor;
+exports.AuditActionInterceptor = AuditActionInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)((0, typeorm_1.getRepositoryToken)(entities_1.AuditActionSummaryEntity))),
+    __param(3, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [core_1.Reflector,
+        audit_context_service_1.AuditContextService,
+        typeorm_2.Repository,
+        operation_description_service_1.OperationDescriptionService])
+], AuditActionInterceptor);

package/audit/interceptors/audit.interceptor.d.ts

@@ -1,12 +1,27 @@
 import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { Observable } from 'rxjs';
 import { AuditContextService } from '../services/audit-context.service';
+/**
+ * 审计拦截器
+ */
 export declare class AuditInterceptor implements NestInterceptor {
     private readonly contextService;
     constructor(contextService: AuditContextService);
     intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * 设置请求上下文
+     */
     private setRequestContext;
+    /**
+     * 处理错误
+     */
     private handleError;
+    /**
+     * 检查是否启用了审计
+     */
     private isAuditEnabled;
+    /**
+     * 生成请求ID
+     */
     private generateRequestId;
 }