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

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

@@ -1,5 +1,89 @@
 import { EntityAuditConfig, FieldDisplayOptions } from '../interfaces';
 export declare const ENTITY_AUDIT_OPTIONS: unique symbol;
 export declare const FIELD_AUDIT_OPTIONS: unique symbol;
-export declare function EntityAudit(options?: EntityAuditConfig): ClassDecorator;
+/**
+ * 实体审计装饰器
+ *
+ * @description
+ * 支持基础审计配置和多语言标签。
+ * 字段标签和值标签请使用 @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @param options 审计配置选项
+ *
+ * @example
+ * // 基础用法
+ * @AuditEntity({
+ *   enabled: true,
+ *   label: { zh: '订单', en: 'Order' },
+ *   excludeFields: ['password'],
+ *   maskFields: ['email']
+ * })
+ *
+ * @example
+ * // 指定模板键
+ * @AuditEntity({
+ *   enabled: true,
+ *   label: { zh: '用户', en: 'User' },
+ *   templateKey: 'user',
+ * })
+ */
+export declare function AuditEntity(options?: EntityAuditConfig): ClassDecorator;
+/**
+ * 字段审计装饰器
+ * @param options 字段显示选项（支持多语言 label 和 valueLabels）
+ *
+ * @example
+ * // 单语言
+ * @AuditField({ label: '姓名' })
+ *
+ * @example
+ * // 多语言
+ * @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @example
+ * // 带值标签映射
+ * @AuditField({
+ *   label: { zh: '状态', en: 'Status' },
+ *   valueLabels: {
+ *     active: { zh: '激活', en: 'Active' },
+ *     inactive: { zh: '未激活', en: 'Inactive' }
+ *   }
+ * })
+ */
 export declare function AuditField(options?: FieldDisplayOptions): PropertyDecorator;
+/**
+ * 获取实体审计配置
+ * @param target 目标类
+ * @returns 审计配置
+ */
+export declare function getEntityAuditConfig(target: any): EntityAuditConfig;
+/**
+ * 获取字段审计配置
+ * @param target 目标类
+ * @returns 字段配置映射
+ */
+export declare function getFieldAuditConfig(target: any): Record<string, FieldDisplayOptions>;
+/**
+ * 获取字段的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param language 语言代码（默认：zh）
+ * @returns 字段标签
+ */
+export declare function getFieldLabel(target: any, fieldName: string, language?: string): string;
+/**
+ * 获取字段值的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param value 值
+ * @param language 语言代码（默认：zh）
+ * @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

@@ -1,15 +1,85 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FIELD_AUDIT_OPTIONS = exports.ENTITY_AUDIT_OPTIONS = void 0;
-exports.EntityAudit = EntityAudit;
+exports.AuditEntity = AuditEntity;
 exports.AuditField = AuditField;
+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');
-function EntityAudit(options) {
+/**
+ * 实体审计装饰器
+ *
+ * @description
+ * 支持基础审计配置和多语言标签。
+ * 字段标签和值标签请使用 @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @param options 审计配置选项
+ *
+ * @example
+ * // 基础用法
+ * @AuditEntity({
+ *   enabled: true,
+ *   label: { zh: '订单', en: 'Order' },
+ *   excludeFields: ['password'],
+ *   maskFields: ['email']
+ * })
+ *
+ * @example
+ * // 指定模板键
+ * @AuditEntity({
+ *   enabled: true,
+ *   label: { zh: '用户', en: 'User' },
+ *   templateKey: 'user',
+ * })
+ */
+function AuditEntity(options) {
     return (target) => {
-        Reflect.defineMetadata(exports.ENTITY_AUDIT_OPTIONS, options || {}, target);
+        // 存储审计元数据
+        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, auditOptions, target);
+        // 如果有 templateKey，同时存储到 entity-log 元数据（兼容性）
+        if (auditOptions.templateKey) {
+            Reflect.defineMetadata('entity-log:enabled', true, target);
+            Reflect.defineMetadata('entity-log:options', {
+                templateKey: auditOptions.templateKey,
+                excludeFields: auditOptions.excludeFields,
+                sensitiveFields: auditOptions.maskFields,
+            }, target);
+        }
     };
 }
+/**
+ * 字段审计装饰器
+ * @param options 字段显示选项（支持多语言 label 和 valueLabels）
+ *
+ * @example
+ * // 单语言
+ * @AuditField({ label: '姓名' })
+ *
+ * @example
+ * // 多语言
+ * @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @example
+ * // 带值标签映射
+ * @AuditField({
+ *   label: { zh: '状态', en: 'Status' },
+ *   valueLabels: {
+ *     active: { zh: '激活', en: 'Active' },
+ *     inactive: { zh: '未激活', en: 'Inactive' }
+ *   }
+ * })
+ */
 function AuditField(options) {
     return (target, propertyKey) => {
         const existingOptions = Reflect.getMetadata(exports.FIELD_AUDIT_OPTIONS, target.constructor) || {};
@@ -17,3 +87,83 @@ function AuditField(options) {
         Reflect.defineMetadata(exports.FIELD_AUDIT_OPTIONS, existingOptions, target.constructor);
     };
 }
+/**
+ * 获取实体审计配置
+ * @param target 目标类
+ * @returns 审计配置
+ */
+function getEntityAuditConfig(target) {
+    return Reflect.getMetadata(exports.ENTITY_AUDIT_OPTIONS, target) || {};
+}
+/**
+ * 获取字段审计配置
+ * @param target 目标类
+ * @returns 字段配置映射
+ */
+function getFieldAuditConfig(target) {
+    return Reflect.getMetadata(exports.FIELD_AUDIT_OPTIONS, target) || {};
+}
+/**
+ * 获取字段的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param language 语言代码（默认：zh）
+ * @returns 字段标签
+ */
+function getFieldLabel(target, fieldName, language = 'zh') {
+    var _a;
+    const fieldConfig = getFieldAuditConfig(target);
+    const label = (_a = fieldConfig[fieldName]) === null || _a === void 0 ? void 0 : _a.label;
+    if (!label) {
+        return fieldName;
+    }
+    // 如果是字符串，直接返回
+    if (typeof label === 'string') {
+        return label;
+    }
+    // 如果是对象，返回指定语言的值
+    return label[language] || label['zh'] || fieldName;
+}
+/**
+ * 获取字段值的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param value 值
+ * @param language 语言代码（默认：zh）
+ * @returns 值的标签
+ */
+function getFieldValueLabel(target, fieldName, value, language = 'zh') {
+    var _a;
+    const fieldConfig = getFieldAuditConfig(target);
+    const valueLabels = (_a = fieldConfig[fieldName]) === null || _a === void 0 ? void 0 : _a.valueLabels;
+    if (!valueLabels || !valueLabels[value]) {
+        return value;
+    }
+    const labelMap = valueLabels[value];
+    // 如果是字符串，直接返回
+    if (typeof labelMap === 'string') {
+        return labelMap;
+    }
+    // 如果是对象，返回指定语言的值
+    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,2 +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

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 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/dto/audit-action-query.dto.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 审计动作查询 DTO
+ */
+export declare class AuditActionQueryDto {
+    page?: number;
+    limit?: number;
+    userId?: string;
+    username?: string;
+    actionName?: string;
+    success?: boolean;
+    startTime?: string;
+    endTime?: string;
+}

package/audit/dto/audit-action-query.dto.js

@@ -0,0 +1,77 @@
+"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.AuditActionQueryDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * 审计动作查询 DTO
+ */
+class AuditActionQueryDto {
+    constructor() {
+        this.page = 1;
+        this.limit = 20;
+    }
+}
+exports.AuditActionQueryDto = AuditActionQueryDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '页码', default: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AuditActionQueryDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '每页数量', default: 20 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], AuditActionQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '用户ID' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "userId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '用户名' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "username", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '动作名称' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "actionName", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '是否成功' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Boolean),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], AuditActionQueryDto.prototype, "success", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '开始时间' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "startTime", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '结束时间' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "endTime", void 0);

package/audit/dto/audit-log-query.dto.d.ts

@@ -1,4 +1,7 @@
 import { AuditOperation } from '../enums';
+/**
+ * 审计日志查询DTO
+ */
 export declare class AuditLogQueryDto {
     page?: number;
     limit?: number;

package/audit/dto/audit-log-query.dto.js

@@ -14,6 +14,9 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const enums_1 = require("../enums");
+/**
+ * 审计日志查询DTO
+ */
 class AuditLogQueryDto {
     constructor() {
         this.page = 1;

package/audit/dto/begin-transaction.dto.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 开始事务DTO
+ */
 export declare class BeginTransactionDto {
     description: string;
 }

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/index.d.ts

@@ -1,4 +1,5 @@
 export * from './audit-log-query.dto';
+export * from './audit-action-query.dto';
 export * from './compare-entities.dto';
 export * from './restore-entity.dto';
 export * from './pre-check-restore.dto';

package/audit/dto/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./audit-log-query.dto"), exports);
+__exportStar(require("./audit-action-query.dto"), exports);
 __exportStar(require("./compare-entities.dto"), exports);
 __exportStar(require("./restore-entity.dto"), exports);
 __exportStar(require("./pre-check-restore.dto"), exports);

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/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

@@ -1,5 +1,9 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { AuditOperation } from '../enums';
+import { ChangeDetail } from '../interfaces';
+/**
+ * 实体审计日志
+ */
 export declare class EntityAuditLogEntity extends AbstractUuidPrimaryEntity {
     entityType: string;
     entityId: string;
@@ -7,12 +11,16 @@ export declare class EntityAuditLogEntity extends AbstractUuidPrimaryEntity {
     oldValue: Record<string, any>;
     newValue: Record<string, any>;
     changedFields: string[];
-    changedFieldPaths: string;
     userId: string;
     username: string;
     requestId: string;
     requestIp: string;
     userAgent: string;
     description: string;
-    hashChain: Record<string, any>;
+    auditActionId: string;
+    auditActionName: string;
+    sequenceInAction: number;
+    operationTemplateKey: string;
+    descriptionParams: Record<string, any>;
+    changeDetails: ChangeDetail[];
 }