@liujitcn/kratos-admin-system 0.0.31 → 0.0.32

package/dist/package/declarations/src/components/{AuditLogTable.vue.d.ts → LogTable.vue.d.ts}

@@ -1,6 +1,7 @@
-import type { ColumnProps, ProTableInstance } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import type { ColumnProps, EnumProps, ProTableInstance } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import type { BaseLogTraceItem } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_log";
 /** 审计详情字段配置。 */
-export interface AuditLogDetailField {
+export interface LogDetailField {
     /** 详情对象中对应的字段名。 */
     key: string;
     /** 字段在详情弹窗中的显示名称。 */
@@ -9,9 +10,13 @@ export interface AuditLogDetailField {
     span?: number;
     /** 是否按格式化 JSON 的代码块展示。 */
     code?: boolean;
+    /** 字段对应的枚举字典选项。 */
+    enum?: EnumProps[];
+    /** 字段自定义格式化函数。 */
+    format?: (value: unknown) => string;
 }
 /** 审计列表页面配置。 */
-export interface AuditLogTableConfig {
+export interface LogTableConfig {
     /** 审计列表表格的列定义。 */
     columns: ColumnProps[];
     /** 详情弹窗标题。 */
@@ -19,20 +24,22 @@ export interface AuditLogTableConfig {
     /** 详情弹窗关闭按钮文案。 */
     closeText: string;
     /** 详情字段和展示格式定义。 */
-    detailFields: AuditLogDetailField[];
+    detailFields: LogDetailField[];
     /** 分页查询函数，返回列表和总数。 */
     request: (params: Record<string, unknown>) => Promise<{
         list: Record<string, unknown>[];
         total: number;
     }>;
     /** 按日志编号读取详情。 */
-    get: (id: number) => Promise<Record<string, unknown>>;
+    get: (id: string) => Promise<Record<string, unknown>>;
+    /** 按请求编号和链路编号读取关联审计时间线。 */
+    trace?: (requestID: string, traceID: string) => Promise<BaseLogTraceItem[]>;
 }
 type __VLS_Props = {
-    config: AuditLogTableConfig;
+    config: LogTableConfig;
 };
 /** 打开审计详情弹窗。 */
-declare function handleOpenDialog(id: number): Promise<void>;
+declare function handleOpenDialog(id: string): Promise<void>;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     handleOpenDialog: typeof handleOpenDialog;
     proTable: globalThis.Ref<ProTableInstance<{

package/dist/package/declarations/src/components/dynamicI18n.d.ts

@@ -8,12 +8,9 @@ export interface DynamicI18nValue {
 }
 /** DynamicI18nRecord 描述三类动态资源翻译共有字段。 */
 export interface DynamicI18nRecord extends Omit<DynamicI18nValue, "text"> {
-    target_type?: I18nTargetType;
-    target_id?: number;
-    name?: string;
-    /** 兼容旧接口缓存中的字段名。 */
-    title?: string;
-    label?: string;
+    target_type: I18nTargetType;
+    target_id: number;
+    name: string;
 }
 /** DynamicLanguageOption 动态翻译编辑器显示的语言选项。 */
 export interface DynamicLanguageOption {
@@ -27,7 +24,7 @@ export declare function getEditableLanguageOptions(): DynamicLanguageOption[];
 /** 返回语言管理中的语言显示名称。 */
 export declare function getLanguageLabel(locale: string): string;
 /** normalizeDynamicI18ns 将后端翻译记录补齐为全部非主语言编辑状态。 */
-export declare function normalizeDynamicI18ns(records: DynamicI18nRecord[] | undefined, _textField: "title" | "name" | "label", locales?: string[]): DynamicI18nValue[];
+export declare function normalizeDynamicI18ns(records: DynamicI18nRecord[] | undefined, locales?: string[]): DynamicI18nValue[];
 /** serializeDynamicI18ns 将编辑状态转换回后端资源翻译结构。 */
 export declare function serializeDynamicI18ns(values: DynamicI18nValue[], targetType: I18nTargetType, targetId: number): Array<{
     id: number;

package/dist/package/declarations/src/components/log.d.ts

@@ -0,0 +1,20 @@
+import type { ColumnProps, EnumProps, SearchProps } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import type { BaseLogTraceItem } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_log";
+/** 根据枚举值生成表格筛选项。 */
+export declare function createLogEnumOptions(items: Array<[number, string]>): EnumProps[];
+/** 根据枚举值查找展示文案。 */
+export declare function logEnumLabel(options: EnumProps[], value: unknown, fallback?: string): string;
+/** 格式化日志 HTTP 状态码并补充状态语义。 */
+export declare function formatLogStatusCode(value: unknown, t: (key: string) => string): string;
+/** 格式化日志耗时，零值表示未采集。 */
+export declare function formatLogDuration(value: unknown, t: (key: string) => string): string;
+/** 格式化日志字节数，保留零字节结果。 */
+export declare function formatLogBytes(value: unknown, t: (key: string) => string): string;
+/** 格式化日志数量并补充记录单位。 */
+export declare function formatLogCount(value: unknown, t: (key: string) => string): string;
+/** 创建审计日志时间范围筛选项。 */
+export declare function logDateSearch(t: (key: string) => string): SearchProps;
+/** 创建审计日志详情按钮列。 */
+export declare function logDetailColumn(label: string, onClick: (id: string) => void): ColumnProps;
+/** 查询同一请求或链路关联的审计时间线。 */
+export declare function requestLogTrace(requestID: string, traceID: string): Promise<BaseLogTraceItem[]>;

package/dist/package/declarations/src/config/base-log-fallback.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimeConfigDefinition } from "./types";
+/** 日志入库回退配置模型。 */
+export interface BaseLogFallbackConfig {
+    file_path: string;
+}
+/** 日志入库回退配置定义。 */
+export declare const baseLogFallbackConfig: RuntimeConfigDefinition<BaseLogFallbackConfig>;

package/dist/package/declarations/src/config/database-backup.d.ts

@@ -0,0 +1,12 @@
+import type { RuntimeConfigDefinition } from "./types";
+/** 数据库备份配置模型。 */
+export interface DatabaseBackupConfig {
+    enabled: boolean;
+    integrity_key: string;
+    encryption_key: string;
+    directory: string;
+    gzip: boolean;
+    retention_count: number;
+}
+/** 数据库备份配置定义。 */
+export declare const databaseBackupConfig: RuntimeConfigDefinition<DatabaseBackupConfig>;

package/dist/package/declarations/src/config/index.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimeConfigDefinition } from "./types";
+export { baseLogFallbackConfig } from "./base-log-fallback";
+export type { RuntimeConfigDefinition, RuntimeConfigField, RuntimeConfigMessageArg, RuntimeConfigModel, RuntimeConfigRule } from "./types";
+/** Admin 内置运行配置定义集合。 */
+export declare const runtimeConfigDefinitions: import("vue").ShallowReactive<RuntimeConfigDefinition<import("./types").RuntimeConfigModel>[]>;
+/** 注册外部业务模块提供的运行配置定义。 */
+export declare function registerRuntimeConfig(definition: RuntimeConfigDefinition): void;

package/dist/package/declarations/src/config/types.d.ts

@@ -0,0 +1,56 @@
+import type { FormItemRule } from "element-plus";
+import type { Component } from "vue";
+import type { ProFormComponentType, ProFormField } from "@liujitcn/kratos-admin-core/components/ProForm/interface";
+/** 运行配置表单模型。 */
+export type RuntimeConfigModel = Record<string, any>;
+/** 运行配置国际化参数值。 */
+export type RuntimeConfigMessageArg = string | number | boolean | {
+    key: string;
+};
+/** 运行配置字段校验规则。 */
+export interface RuntimeConfigRule {
+    /** 国际化消息键。 */
+    messageKey: string;
+    /** 国际化消息参数。 */
+    messageArgs?: Record<string, RuntimeConfigMessageArg>;
+    /** Element Plus 校验触发方式。 */
+    trigger?: FormItemRule["trigger"];
+    /** 其他 Element Plus 校验参数。 */
+    [key: string]: unknown;
+}
+/** 运行配置字段定义。 */
+export interface RuntimeConfigField {
+    /** 字段路径。 */
+    prop: string;
+    /** 字段标题国际化消息键。 */
+    labelKey: string;
+    /** ProForm 控件类型。 */
+    component: ProFormComponentType;
+    /** 控件参数。 */
+    props?: ProFormField["props"];
+    /** 表单项参数。 */
+    itemProps?: ProFormField["itemProps"];
+    /** 选择项。 */
+    options?: ProFormField["options"];
+    /** 字段提示国际化消息键。 */
+    labelTooltipKey?: string;
+    /** 字段是否可见。 */
+    visible?: ProFormField["visible"];
+    /** 字段校验规则。 */
+    rules?: RuntimeConfigRule[];
+}
+/** 管理端运行配置定义。 */
+export interface RuntimeConfigDefinition<T extends RuntimeConfigModel = RuntimeConfigModel> {
+    /** 配置稳定键。 */
+    key: string;
+    /** 配置名称国际化消息键。 */
+    titleKey: string;
+    /** 配置说明国际化消息键。 */
+    descriptionKey: string;
+    /** 配置项导航图标。 */
+    icon: Component;
+    /** 创建表单默认模型。 */
+    createModel: () => T;
+    /** 配置字段集合。 */
+    fields: RuntimeConfigField[];
+}