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

package/audit/services/entity-audit.service.d.ts

@@ -1,11 +1,35 @@
 import { Repository, EntityManager } from 'typeorm';
 import { EntityAuditLogEntity, EntityTransactionEntity, ManualOperationLogEntity, AuditActionSummaryEntity } from '../entities';
 import { AuditOperation } from '../enums';
-import { AuditConfig, IAuditStrategy, EntityDifference, RestoreOptions, RestoreResult, PreCheckResult, ManualOperationData, ChangeDetail, RollbackAction } from '../interfaces';
+import { AuditConfig, IAuditStrategy, EntityDifference, RestoreOptions, RestoreResult, PreCheckResult, ManualOperationData, ChangeDetail } from '../interfaces';
 import { AuditContextService } from './audit-context.service';
 import { MultiDatabaseService } from './multi-database.service';
+import { OperationDescriptionService } from './operation-description.service';
 import { PageDto } from '../../common/dto';
 import { AuditLogQueryDto } from '../dto';
+/**
+ * 审计配置常量
+ */
+export declare const AUDIT_CONSTANTS: {
+    /** 深度比较的最大深度限制 */
+    readonly MAX_DIFF_DEPTH: 5;
+    /** 深度比较的最大键数量限制 */
+    readonly MAX_KEYS: 100;
+    /** 描述的最大长度 */
+    readonly MAX_DESCRIPTION_LENGTH: 1000;
+    /** 哈希截断长度 */
+    readonly HASH_TRUNCATE_LENGTH: 64;
+    /** 部分掩码显示的字符数 */
+    readonly PARTIAL_MASK_CHARS: 2;
+};
+/**
+ * 注册实体类到注册表
+ */
+export declare function registerEntityClass(entityType: string, entityClass: any): void;
+/**
+ * 获取实体类
+ */
+export declare function getEntityClass(entityType: string): any | undefined;
 /**
  * 实体审计服务
  */
@@ -19,8 +43,9 @@ export declare class EntityAuditService {
     private readonly auditStrategy;
     private readonly config?;
     private readonly actionSummaryRepository?;
+    private readonly descriptionService?;
     private readonly auditConnectionName;
-    constructor(auditLogRepository: Repository<EntityAuditLogEntity>, transactionRepository: Repository<EntityTransactionEntity>, manualOperationRepository: Repository<ManualOperationLogEntity>, entityManager: EntityManager, contextService: AuditContextService, multiDbService: MultiDatabaseService, auditStrategy?: IAuditStrategy, config?: AuditConfig, auditConnectionName?: string, actionSummaryRepository?: Repository<AuditActionSummaryEntity>);
+    constructor(auditLogRepository: Repository<EntityAuditLogEntity>, transactionRepository: Repository<EntityTransactionEntity>, manualOperationRepository: Repository<ManualOperationLogEntity>, entityManager: EntityManager, contextService: AuditContextService, multiDbService: MultiDatabaseService, auditStrategy?: IAuditStrategy, config?: AuditConfig, auditConnectionName?: string, actionSummaryRepository?: Repository<AuditActionSummaryEntity>, descriptionService?: OperationDescriptionService);
     /**
      * 记录实体变更
      */
@@ -42,13 +67,13 @@ export declare class EntityAuditService {
      */
     restoreEntity(entityType: string, entityId: string, auditLogId: string, options?: RestoreOptions): Promise<RestoreResult>;
     /**
-     * 计算变更字段
+     * 计算变更字段（支持嵌套路径）
      */
     private calculateChangedFields;
     /**
-     * 计算变更字段路径
+     * 生成字段级别的变更详情（前后对比，支持嵌套路径和装饰器值映射）
      */
-    private calculateChangedFieldPaths;
+    private generateChangeDetails;
     /**
      * 深度比较对象
      */
@@ -81,10 +106,6 @@ export declare class EntityAuditService {
      * 部分掩码值
      */
     private partialMaskValue;
-    /**
-     * 生成哈希链
-     */
-    private generateHashChain;
     /**
      * 生成描述（支持多语言）
      * @param operation 操作类型
@@ -94,6 +115,10 @@ export declare class EntityAuditService {
      * @param language 语言（默认中文）
      * @param entityClass 实体类（可选，用于获取实体标签）
      */
+    /**
+     * 使用模板生成描述（优先使用 OperationDescriptionService）
+     */
+    private generateDescriptionFromTemplate;
     private generateDescription;
     /**
      * 检测冲突
@@ -114,7 +139,6 @@ export declare class EntityAuditService {
         operationTemplateKey?: string;
         descriptionParams?: Record<string, any>;
         changeDetails?: ChangeDetail[];
-        rollbackActions?: RollbackAction[];
         metadata?: Record<string, any>;
     }): Promise<EntityAuditLogEntity | null>;
     /**
@@ -179,11 +203,14 @@ export declare class EntityAuditService {
         endTime?: Date;
         page?: number;
         limit?: number;
+        keyword?: string;
     }): Promise<PageDto<AuditActionSummaryEntity>>;
     /**
      * 查询单个审计动作的详细信息（包含关联的实体变更）
+     * @param actionId 动作ID
+     * @param language 语言代码 (zh/en/ja)，默认 zh
      */
-    getAuditActionDetail(actionId: string): Promise<{
+    getAuditActionDetail(actionId: string, language?: string): Promise<{
         summary: {
             id: string;
             actionName: string;
@@ -216,15 +243,7 @@ export declare class EntityAuditService {
             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;
-            }[];
+            changeDetails: ChangeDetail[];
             changedFieldsCount: number;
             changedFields: string[];
         }[];
@@ -240,6 +259,32 @@ export declare class EntityAuditService {
             }[];
         };
     }>;
+    /**
+     * 生成本地化的描述文本
+     */
+    private generateLocalizedDescription;
+    /**
+     * 替换模板中的占位符
+     * @param template 模板字符串，如 "创建了产品 {name}，价格 ¥{price}"
+     * @param params 参数对象，如 { name: "iPhone", price: 999 }
+     * @returns 替换后的字符串
+     */
+    private replaceTemplatePlaceholders;
+    /**
+     * 获取嵌套对象的值
+     * @param obj 对象
+     * @param path 路径，如 "user.name" 或 "user.profile.age"
+     * @returns 值或 undefined
+     */
+    private getNestedValue;
+    /**
+     * 本地化 changeDetails（根据语言转换 fieldLabel 和 displayValue）
+     */
+    private localizeChangeDetails;
+    /**
+     * 获取操作标签（支持多语言）
+     */
+    private getOperationLabel;
     /**
      * 分析字段变化（支持多语言）
      * @param oldValue 旧值
@@ -253,10 +298,6 @@ export declare class EntityAuditService {
      * 格式化显示值
      */
     private formatDisplayValue;
-    /**
-     * 获取操作标签
-     */
-    private getOperationLabel;
     /**
      * 按字段分组统计
      */