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

package/audit/dto/begin-transaction.dto.js

@@ -12,6 +12,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BeginTransactionDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+/**
+ * 开始事务DTO
+ */
 class BeginTransactionDto {
 }
 exports.BeginTransactionDto = BeginTransactionDto;

package/audit/dto/compare-entities.dto.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 比较实体DTO
+ */
 export declare class CompareEntitiesDto {
     entityType: string;
     entityId: string;

package/audit/dto/compare-entities.dto.js

@@ -13,6 +13,9 @@ exports.CompareEntitiesDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
+/**
+ * 比较实体DTO
+ */
 class CompareEntitiesDto {
 }
 exports.CompareEntitiesDto = CompareEntitiesDto;

package/audit/dto/pre-check-restore.dto.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 预检查恢复DTO
+ */
 export declare class PreCheckRestoreDto {
     entityType: string;
     entityId: string;

package/audit/dto/pre-check-restore.dto.js

@@ -12,6 +12,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PreCheckRestoreDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+/**
+ * 预检查恢复DTO
+ */
 class PreCheckRestoreDto {
 }
 exports.PreCheckRestoreDto = PreCheckRestoreDto;

package/audit/dto/restore-entity.dto.d.ts

@@ -1,5 +1,8 @@
 import { RecoveryStrategy } from '../enums';
 import { RestoreOptions } from '../interfaces';
+/**
+ * 恢复实体DTO
+ */
 export declare class RestoreEntityDto {
     entityType: string;
     entityId: string;

package/audit/dto/restore-entity.dto.js

@@ -13,6 +13,9 @@ exports.RestoreEntityDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const enums_1 = require("../enums");
+/**
+ * 恢复实体DTO
+ */
 class RestoreEntityDto {
     constructor() {
         this.strategy = enums_1.RecoveryStrategy.ENTITY_ONLY;

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

@@ -1,5 +1,9 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { AuditOperation } from '../enums';
+import { ChangeDetail, RollbackAction } from '../interfaces';
+/**
+ * 实体审计日志
+ */
 export declare class EntityAuditLogEntity extends AbstractUuidPrimaryEntity {
     entityType: string;
     entityId: string;
@@ -15,4 +19,8 @@ export declare class EntityAuditLogEntity extends AbstractUuidPrimaryEntity {
     userAgent: string;
     description: string;
     hashChain: Record<string, any>;
+    operationTemplateKey: string;
+    descriptionParams: Record<string, any>;
+    changeDetails: ChangeDetail[];
+    rollbackActions: RollbackAction[];
 }

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

@@ -13,6 +13,9 @@ exports.EntityAuditLogEntity = void 0;
 const typeorm_1 = require("typeorm");
 const abstract_entity_1 = require("../../common/abstract.entity");
 const enums_1 = require("../enums");
+/**
+ * 实体审计日志
+ */
 let EntityAuditLogEntity = class EntityAuditLogEntity extends abstract_entity_1.AbstractUuidPrimaryEntity {
 };
 exports.EntityAuditLogEntity = EntityAuditLogEntity;
@@ -72,10 +75,39 @@ __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: '操作模板键，用于动态生成描述' }),
+    __metadata("design:type", String)
+], EntityAuditLogEntity.prototype, "operationTemplateKey", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'json',
+        nullable: true,
+        comment: '描述参数，用于填充模板占位符',
+    }),
+    __metadata("design:type", Object)
+], EntityAuditLogEntity.prototype, "descriptionParams", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'json',
+        nullable: true,
+        comment: '结构化变更详情列表（包含多语言支持）',
+    }),
+    __metadata("design:type", Array)
+], EntityAuditLogEntity.prototype, "changeDetails", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'json',
+        nullable: true,
+        comment: '回滚操作列表',
+    }),
+    __metadata("design:type", Array)
+], EntityAuditLogEntity.prototype, "rollbackActions", void 0);
 exports.EntityAuditLogEntity = EntityAuditLogEntity = __decorate([
     (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_created_at', ['createdAt']),
+    (0, typeorm_1.Index)('idx_template_key', ['operationTemplateKey'])
 ], EntityAuditLogEntity);

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

@@ -1,5 +1,9 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { AuditOperation, TransactionStatus } from '../enums';
+import { ManualOperationLogEntity } from './manual-operation-log.entity';
+/**
+ * 实体事务
+ */
 export declare class EntityTransactionEntity extends AbstractUuidPrimaryEntity {
     description: string;
     status: TransactionStatus;
@@ -11,4 +15,10 @@ export declare class EntityTransactionEntity extends AbstractUuidPrimaryEntity {
     userId: string;
     username: string;
     dependencyGraph: Record<string, any>;
+    operationTemplateKey: string;
+    descriptionParams: Record<string, any>;
+    requestIp: string;
+    metadata: Record<string, any>;
+    completedAt: Date;
+    manualOperations: ManualOperationLogEntity[];
 }

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;
@@ -43,9 +46,38 @@ __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', (log) => log.transaction),
+    __metadata("design:type", Array)
+], EntityTransactionEntity.prototype, "manualOperations", void 0);
 exports.EntityTransactionEntity = EntityTransactionEntity = __decorate([
     (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'])
 ], EntityTransactionEntity);

package/audit/entities/index.d.ts

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

package/audit/entities/index.js

@@ -16,3 +16,5 @@ 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);

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;

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,67 @@
+/**
+ * 操作类型（设计文档标准命名）
+ */
+export declare enum OperationType {
+    CREATE = "create",
+    UPDATE = "update",
+    DELETE = "delete"
+}
+/**
+ * 审计操作类型（兼容性别名，映射到 OperationType）
+ * @deprecated 请使用 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"
+    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,19 @@
 "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.TransactionStatus = exports.AuditOperation = exports.OperationType = void 0;
+/**
+ * 操作类型（设计文档标准命名）
+ */
+var OperationType;
+(function (OperationType) {
+    OperationType["CREATE"] = "create";
+    OperationType["UPDATE"] = "update";
+    OperationType["DELETE"] = "delete";
+})(OperationType || (exports.OperationType = OperationType = {}));
+/**
+ * 审计操作类型（兼容性别名，映射到 OperationType）
+ * @deprecated 请使用 OperationType
+ */
 var AuditOperation;
 (function (AuditOperation) {
     AuditOperation["CREATE"] = "CREATE";
@@ -8,24 +21,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["PENDING"] = "pending";
+    TransactionStatus["COMMITTED"] = "committed";
+    TransactionStatus["ROLLED_BACK"] = "rolled_back";
 })(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+/**
+ * 恢复策略
+ */
 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 +58,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,9 @@ export * from './entities';
 export * from './enums';
 export * from './interfaces';
 export * from './dto';
-export * from './decorators';
+export { AuditEntity, AuditField, getEntityAuditConfig, getFieldAuditConfig, getFieldLabel, getFieldValueLabel, 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 * from './services';
 export * from './subscribers';
 export * from './interceptors';

package/audit/index.js

@@ -14,13 +14,42 @@ 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_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.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, "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; } });
+// 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.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;
 }

package/audit/interceptors/audit.interceptor.js

@@ -24,6 +24,9 @@ const operators_1 = require("rxjs/operators");
 const crypto_1 = require("crypto");
 const audit_context_service_1 = require("../services/audit-context.service");
 const decorators_1 = require("../decorators");
+/**
+ * 审计拦截器
+ */
 let AuditInterceptor = class AuditInterceptor {
     constructor(contextService) {
         this.contextService = contextService;
@@ -32,16 +35,23 @@ let AuditInterceptor = class AuditInterceptor {
         const request = context.switchToHttp().getRequest();
         const handler = context.getHandler();
         const controller = context.getClass();
+        // 检查是否启用了审计
         if (!this.isAuditEnabled(controller, handler)) {
             return next.handle();
         }
+        // 设置请求上下文
         this.setRequestContext(request);
         return next.handle().pipe((0, operators_1.tap)(() => {
+            // 在响应后执行的操作
         }), (0, operators_1.catchError)((error) => __awaiter(this, void 0, void 0, function* () {
+            // 处理错误情况
             yield this.handleError(error, request);
             throw error;
         })));
     }
+    /**
+     * 设置请求上下文
+     */
     setRequestContext(request) {
         var _a, _b, _c;
         const user = request.user || {};
@@ -55,8 +65,12 @@ let AuditInterceptor = class AuditInterceptor {
         };
         this.contextService.setContext(auditContext);
     }
+    /**
+     * 处理错误
+     */
     handleError(error, request) {
         return __awaiter(this, void 0, void 0, function* () {
+            // 记录错误信息到上下文
             this.contextService.setContext({
                 metadata: {
                     error: {
@@ -68,12 +82,17 @@ let AuditInterceptor = class AuditInterceptor {
             });
         });
     }
+    /**
+     * 检查是否启用了审计
+     */
     isAuditEnabled(controller, handler) {
         try {
+            // 检查控制器级别设置
             const controllerMetadata = Reflect.getMetadata(decorators_1.CONTROLLER_AUDIT_OPTIONS, controller);
             if (controllerMetadata && controllerMetadata.enabled === false) {
                 return false;
             }
+            // 检查方法级别设置
             const handlerMetadata = Reflect.getMetadata(decorators_1.METHOD_AUDIT_OPTIONS, handler);
             if (handlerMetadata && handlerMetadata.enabled === false) {
                 return false;
@@ -81,9 +100,12 @@ let AuditInterceptor = class AuditInterceptor {
             return true;
         }
         catch (error) {
-            return true;
+            return true; // 默认启用
         }
     }
+    /**
+     * 生成请求ID
+     */
     generateRequestId() {
         return (0, crypto_1.randomBytes)(16).toString('hex');
     }