@liujitcn/kratos-admin-system 0.0.31 → 0.0.32

package/dist/package/src/components/LogTable.vue

@@ -0,0 +1,190 @@
+<template>
+  <div class="table-box">
+    <ProTable ref="proTable" row-key="id" :columns="resolvedColumns" :request-api="requestTable" />
+
+    <ProDialog v-model="dialog.visible" :title="config.detailTitle" width="1280px" @close="handleCloseDialog">
+      <el-descriptions border :column="2" class="detail-container">
+        <el-descriptions-item v-for="field in config.detailFields" :key="field.key" :label="field.label" :span="field.span ?? 1">
+          <pre v-if="field.code" class="code-block">{{ formatField(field) }}</pre>
+          <span v-else>{{ formatField(field) }}</span>
+        </el-descriptions-item>
+      </el-descriptions>
+
+      <section v-if="config.trace && (traceLoading || traceItems.length > 0)" class="trace-section">
+        <h3>{{ t("system.base.log.trace.title") }}</h3>
+        <el-table v-loading="traceLoading" :data="traceItems" max-height="300" border>
+          <el-table-column :label="t('system.base.log.trace.log_type')" width="130">
+            <template #default="scope">{{ formatLogType(scope.row.log_type) }}</template>
+          </el-table-column>
+          <el-table-column prop="resource" :label="t('system.base.log.trace.resource')" min-width="280" show-overflow-tooltip />
+          <el-table-column prop="user_name" :label="t('system.base.log.field.user_name')" width="130" />
+          <el-table-column :label="t('system.base.log.field.result')" width="100">
+            <template #default="scope">{{ formatResult(scope.row.result) }}</template>
+          </el-table-column>
+          <el-table-column :label="t('system.base.log.trace.duration')" width="110" align="right">
+            <template #default="scope">{{ formatDuration(scope.row.duration_ms) }}</template>
+          </el-table-column>
+          <el-table-column prop="occurred_at" :label="t('system.base.log.field.occurred_at')" width="190" />
+        </el-table>
+      </section>
+
+      <template #footer>
+        <el-button @click="handleCloseDialog">{{ config.closeText }}</el-button>
+      </template>
+    </ProDialog>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, reactive, ref, unref } from "vue";
+import type { ColumnProps, EnumProps, ProTableInstance } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import ProTable from "@liujitcn/kratos-admin-core/components/ProTable";
+import ProDialog from "@liujitcn/kratos-admin-core/components/Dialog/ProDialog.vue";
+import { buildPageRequest } from "@liujitcn/kratos-admin-core/table";
+import { formatJson } from "@liujitcn/kratos-admin-core/format";
+import { t } from "@liujitcn/kratos-admin-core";
+import { BaseLogType, BaseLogResult } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_log";
+import type { BaseLogTraceItem } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_log";
+import { logEnumLabel } from "./log";
+
+/** 审计详情字段配置。 */
+export interface LogDetailField {
+  /** 详情对象中对应的字段名。 */
+  key: string;
+  /** 字段在详情弹窗中的显示名称。 */
+  label: string;
+  /** 字段占用的描述列数，未设置时使用一列。 */
+  span?: number;
+  /** 是否按格式化 JSON 的代码块展示。 */
+  code?: boolean;
+  /** 字段对应的枚举字典选项。 */
+  enum?: EnumProps[];
+  /** 字段自定义格式化函数。 */
+  format?: (value: unknown) => string;
+}
+
+/** 审计列表页面配置。 */
+export interface LogTableConfig {
+  /** 审计列表表格的列定义。 */
+  columns: ColumnProps[];
+  /** 详情弹窗标题。 */
+  detailTitle: string;
+  /** 详情弹窗关闭按钮文案。 */
+  closeText: string;
+  /** 详情字段和展示格式定义。 */
+  detailFields: LogDetailField[];
+  /** 分页查询函数，返回列表和总数。 */
+  request: (params: Record<string, unknown>) => Promise<{ list: Record<string, unknown>[]; total: number }>;
+  /** 按日志编号读取详情。 */
+  get: (id: string) => Promise<Record<string, unknown>>;
+  /** 按请求编号和链路编号读取关联审计时间线。 */
+  trace?: (requestID: string, traceID: string) => Promise<BaseLogTraceItem[]>;
+}
+
+const props = defineProps<{ config: LogTableConfig }>();
+const proTable = ref<ProTableInstance>();
+const detail = reactive<Record<string, unknown>>({});
+const dialog = reactive({ visible: false });
+const traceItems = ref<BaseLogTraceItem[]>([]);
+const traceLoading = ref(false);
+const resolvedColumns = computed(() => unref(props.config.columns));
+
+/** 请求审计日志分页数据。 */
+async function requestTable(params: Record<string, unknown>) {
+  const result = await props.config.request(buildPageRequest(params));
+  return { data: { list: result.list, total: result.total } };
+}
+
+/** 打开审计详情弹窗。 */
+async function handleOpenDialog(id: string) {
+  const value = await props.config.get(id);
+  Object.keys(detail).forEach(key => delete detail[key]);
+  Object.assign(detail, value);
+  dialog.visible = true;
+  traceItems.value = [];
+  const requestID = String(detail.request_id ?? "");
+  const traceID = String(detail.trace_id ?? "");
+  if (!props.config.trace || (!requestID && !traceID)) return;
+  traceLoading.value = true;
+  try {
+    traceItems.value = await props.config.trace(requestID, traceID);
+  } catch {
+    traceItems.value = [];
+  } finally {
+    traceLoading.value = false;
+  }
+}
+
+/** 关闭并清理审计详情弹窗。 */
+function handleCloseDialog() {
+  dialog.visible = false;
+  Object.keys(detail).forEach(key => delete detail[key]);
+  traceItems.value = [];
+  traceLoading.value = false;
+}
+
+/** 格式化详情字段，JSON 内容使用统一脱敏展示格式。 */
+function formatField(field: LogDetailField) {
+  const value = detail[field.key];
+  if (value === undefined || value === null || value === "") return t("common.value.none");
+  if (field.enum) return logEnumLabel(field.enum, value, t("common.value.unknown"));
+  if (field.format) return field.format(value);
+  if (field.code) return formatJson(String(value));
+  return String(value);
+}
+
+/** 格式化关联日志耗时。 */
+function formatDuration(value: unknown) {
+  const duration = Number(value);
+  return duration > 0 ? `${duration} ms` : t("common.value.none");
+}
+
+/** 格式化关联审计日志类型。 */
+function formatLogType(value: BaseLogType) {
+  const keys: Partial<Record<BaseLogType, string>> = {
+    [BaseLogType.BASE_LOG_TYPE_LOGIN]: "system.base.log.trace.type.login",
+    [BaseLogType.BASE_LOG_TYPE_API]: "system.base.log.trace.type.api",
+    [BaseLogType.BASE_LOG_TYPE_OPERATION]: "system.base.log.trace.type.operation",
+    [BaseLogType.BASE_LOG_TYPE_DATA_ACCESS]: "system.base.log.trace.type.data_access",
+    [BaseLogType.BASE_LOG_TYPE_PERMISSION]: "system.base.log.trace.type.permission",
+    [BaseLogType.BASE_LOG_TYPE_POLICY_EVALUATION]: "system.base.log.trace.type.policy"
+  };
+  return t(keys[value] ?? "system.base.log.trace.type.unknown");
+}
+
+/** 格式化关联审计结果。 */
+function formatResult(value: BaseLogResult) {
+  const keys: Partial<Record<BaseLogResult, string>> = {
+    [BaseLogResult.BASE_LOG_RESULT_SUCCESS]: "system.base.log.result.success",
+    [BaseLogResult.BASE_LOG_RESULT_FAILURE]: "system.base.log.result.failure",
+    [BaseLogResult.BASE_LOG_RESULT_ERROR]: "system.base.log.result.error"
+  };
+  return t(keys[value] ?? "system.base.log.result.unspecified");
+}
+
+defineExpose({ handleOpenDialog, proTable });
+</script>
+
+<style scoped>
+.detail-container {
+  width: 100%;
+}
+
+.code-block {
+  max-height: 360px;
+  margin: 0;
+  overflow: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+.trace-section {
+  margin-top: 20px;
+}
+
+.trace-section h3 {
+  margin: 0 0 12px;
+  font-size: 15px;
+  font-weight: 600;
+}
+</style>

package/dist/package/src/components/Notification.vue

@@ -1,5 +1,12 @@
 <template>
-  <el-popover placement="bottom-end" :width="360" trigger="click" @show="refresh">
+  <el-popover
+    v-bind="$attrs"
+    v-model:visible="popoverVisible"
+    placement="bottom-end"
+    :width="360"
+    trigger="click"
+    @show="refresh"
+  >
     <template #reference>
       <el-badge class="notification-trigger" :value="badgeValue" :hidden="unreadTotal === 0" :max="99">
         <el-icon :size="24"><Bell /></el-icon>
@@ -17,7 +24,7 @@
           class="notification-item"
           :class="{ 'is-unread': !item.read_at }"
           type="button"
-          @click="openInbox"
+          @click="openNotification(item)"
         >
           <span class="notification-category-icon" :style="{ color: item.category_color || undefined }" aria-hidden="true">
             <component :is="resolveNotificationIcon(item.category_icon)" />
@@ -31,24 +38,65 @@
       <el-button class="notification-more" text @click="openInbox">{{ t("system.notification.action.view_all") }}</el-button>
     </div>
   </el-popover>
+  <ProDialog v-model="detailVisible" :title="detail?.title" width="720px" destroy-on-close :show-footer="false">
+    <div v-if="detail" class="notification-detail">
+      <div class="notification-detail-meta">
+        <span class="notification-detail-category" :style="{ color: detail.category_color || undefined }">
+          <component :is="resolveNotificationIcon(detail.category_icon)" />
+          <span>{{ detail.category_name }}</span>
+        </span>
+        <span>{{ detail.sender_name }}</span>
+        <span>{{ detail.received_at }}</span>
+      </div>
+      <RichTextPreview
+        v-if="detail.content_format === MessageContentFormat.MESSAGE_CONTENT_FORMAT_RICH_TEXT"
+        class="notification-detail-content"
+        :model-value="detail.content"
+      />
+      <pre v-else class="notification-detail-content">{{ detail.content }}</pre>
+      <el-button
+        v-if="detail.action_type === MessageActionType.MESSAGE_ACTION_TYPE_VIEW_KEY && actionRouteName"
+        type="primary"
+        @click="openAction"
+      >
+        {{ t("common.action.view") }}
+      </el-button>
+    </div>
+  </ProDialog>
 </template>
 
 <script setup lang="ts">
 import { computed, onBeforeUnmount, onMounted, ref } from "vue";
 import { useRouter } from "vue-router";
 import { t } from "@liujitcn/kratos-admin-core";
-import { defNotificationService } from "@liujitcn/kratos-admin-system/api/base/notification";
-import { subscribeSseEvent, type SseStop } from "@liujitcn/kratos-admin-system/api/base/sse";
+import ProDialog from "@liujitcn/kratos-admin-core/components/Dialog/ProDialog.vue";
+import RichTextPreview from "@liujitcn/kratos-admin-core/components/RichTextPreview/index.vue";
+import { defNotificationService } from "@liujitcn/kratos-admin-system/api/base/v1/notification";
+import { subscribeSseEvent, type SseStop } from "@liujitcn/kratos-admin-system/api/base/v1/sse";
 import type { Notification } from "@liujitcn/kratos-admin-system/rpc/base/v1/notification";
-import { NotificationView } from "@liujitcn/kratos-admin-system/rpc/base/v1/notification";
+import {
+  MessageActionType,
+  MessageContentFormat,
+  NotificationView
+} from "@liujitcn/kratos-admin-system/rpc/base/v1/notification";
 
 const router = useRouter();
+const popoverVisible = ref(false);
 const unreadTotal = ref(0);
 const latestDeliveryID = ref(0);
 const notifications = ref<Notification[]>([]);
+const detailVisible = ref(false);
+const detail = ref<Notification>();
 let stopSse: SseStop | undefined;
 
+defineOptions({ name: "Notification", inheritAttrs: false });
+
 const badgeValue = computed(() => Math.min(unreadTotal.value, 99));
+const actionRouteName = computed(() => {
+  const viewKey = detail.value?.action_target;
+  if (!viewKey) return "";
+  return ({ MESSAGE_INBOX: "NotificationInbox", PROFILE: "Profile", AI: "AiChat" } as Record<string, string>)[viewKey] ?? "";
+});
 const notificationIcons = {
   Bell,
   Calendar,
@@ -88,7 +136,7 @@ onBeforeUnmount(() => stopSse?.());
 async function refresh() {
   const [summary, page] = await Promise.all([
     defNotificationService.GetNotificationSummary({}),
-    defNotificationService.PageNotification({ view: NotificationView.NOTIFICATION_VIEW_INBOX, category_id: undefined, priority: undefined, cursor_id: 0, page_num: 1, page_size: 5 })
+    defNotificationService.PageNotification({ view: NotificationView.NOTIFICATION_VIEW_UNREAD, category_id: undefined, priority: undefined, cursor_id: 0, page_num: 1, page_size: 5 })
   ]);
   unreadTotal.value = summary.unread_total;
   latestDeliveryID.value = summary.latest_delivery_id;
@@ -102,12 +150,34 @@ async function markAllRead() {
   await refresh();
 }
 
+/** 打开下拉消息详情并标记消息为已读。 */
+async function openNotification(row: Notification) {
+  popoverVisible.value = false;
+  const wasUnread = !row.read_at;
+  const [notification] = await Promise.all([
+    defNotificationService.GetNotification({ id: row.id }),
+    wasUnread ? defNotificationService.MarkNotificationRead({ ids: [row.id] }) : Promise.resolve()
+  ]);
+  detail.value = notification;
+  detailVisible.value = true;
+  notifications.value = notifications.value.filter(item => item.id !== row.id);
+  if (wasUnread) unreadTotal.value = Math.max(0, unreadTotal.value - 1);
+}
+
 /** 打开完整收件箱。 */
 function openInbox() {
+  popoverVisible.value = false;
   void router.push({ name: "NotificationInbox" });
 }
 
-/** 解析收件箱分类图标，兼容历史数据中的未知图标名。 */
+/** 执行通知携带的稳定 viewKey 动作。 */
+function openAction() {
+  if (!actionRouteName.value) return;
+  detailVisible.value = false;
+  void router.push({ name: actionRouteName.value });
+}
+
+/** 解析收件箱分类图标，未知图标使用默认图标。 */
 function resolveNotificationIcon(icon: string) {
   return notificationIcons[icon as keyof typeof notificationIcons] ?? CollectionTag;
 }
@@ -193,4 +263,39 @@ function resolveNotificationIcon(icon: string) {
   width: 100%;
   margin-top: 8px;
 }
+
+.notification-detail-meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 16px;
+  margin-bottom: 18px;
+  color: var(--el-text-color-secondary);
+}
+
+.notification-detail-category {
+  display: inline-flex;
+  gap: 6px;
+  align-items: center;
+  line-height: 18px;
+}
+
+.notification-detail-category > svg {
+  flex: 0 0 18px;
+  width: 18px;
+  height: 18px;
+}
+
+.notification-detail-content {
+  min-height: 180px;
+  margin: 0 0 16px;
+  color: var(--el-text-color-primary);
+  font-family: inherit;
+  line-height: 1.7;
+  overflow-wrap: anywhere;
+  white-space: pre-wrap;
+}
+
+.notification-detail-content.core-rich-text-preview {
+  white-space: normal;
+}
 </style>

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

@@ -1,4 +1,4 @@
-import { getEnabledBaseLanguages } from "@liujitcn/kratos-admin-system/api/system/base_language";
+import { getEnabledBaseLanguages } from "@liujitcn/kratos-admin-system/api/system/admin/v1/base_language";
 import type { I18nTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
 
 /** DynamicI18nValue 动态资源单语言翻译编辑状态。 */
@@ -11,12 +11,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 动态翻译编辑器显示的语言选项。 */
@@ -43,7 +40,6 @@ export function getLanguageLabel(locale: string): string {
 /** normalizeDynamicI18ns 将后端翻译记录补齐为全部非主语言编辑状态。 */
 export function normalizeDynamicI18ns(
   records: DynamicI18nRecord[] | undefined,
-  _textField: "title" | "name" | "label",
   locales: string[] = getEditableLanguageOptions().map(item => item.value)
 ): DynamicI18nValue[] {
   return locales.map(locale => {
@@ -51,7 +47,7 @@ export function normalizeDynamicI18ns(
     return {
       id: record?.id ?? 0,
       locale,
-      text: String(record?.name ?? record?.[_textField] ?? "")
+      text: String(record?.name ?? "")
     };
   });
 }

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

@@ -0,0 +1,87 @@
+import type { ColumnProps, EnumProps, SearchProps } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import { defBaseLogService } from "@liujitcn/kratos-admin-system/api/system/admin/v1/base_log";
+import type { BaseLogTraceItem } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_log";
+
+/** 根据枚举值生成表格筛选项。 */
+export function createLogEnumOptions(items: Array<[number, string]>): EnumProps[] {
+  return items.map(([value, label]) => ({ value, label }));
+}
+
+/** 根据枚举值查找展示文案。 */
+export function logEnumLabel(options: EnumProps[], value: unknown, fallback = ""): string {
+  return options.find(item => item.value === value)?.label ?? (fallback || String(value ?? ""));
+}
+
+/** 格式化日志 HTTP 状态码并补充状态语义。 */
+export function formatLogStatusCode(value: unknown, t: (key: string) => string): string {
+  const code = Number(value);
+  if (!Number.isInteger(code)) return t("common.value.unknown");
+
+  let statusKey = "system.base.log.status.other";
+  if (code >= 200 && code < 300) statusKey = "system.base.log.status.success";
+  else if (code >= 400 && code < 500) statusKey = "system.base.log.status.client_error";
+  else if (code >= 500 && code < 600) statusKey = "system.base.log.status.server_error";
+  return `${code} (${t(statusKey)})`;
+}
+
+/** 格式化日志耗时，零值表示未采集。 */
+export function formatLogDuration(value: unknown, t: (key: string) => string): string {
+  const duration = Number(value);
+  if (!Number.isFinite(duration) || duration <= 0) return t("common.value.none");
+  return `${duration} ms`;
+}
+
+/** 格式化日志字节数，保留零字节结果。 */
+export function formatLogBytes(value: unknown, t: (key: string) => string): string {
+  const size = Number(value);
+  if (!Number.isFinite(size) || size < 0) return t("common.value.none");
+  return `${size} B`;
+}
+
+/** 格式化日志数量并补充记录单位。 */
+export function formatLogCount(value: unknown, t: (key: string) => string): string {
+  const count = Number(value);
+  if (!Number.isFinite(count) || count < 0) return t("common.value.none");
+  return `${count} ${t("system.base.log.unit.records")}`;
+}
+
+/** 创建审计日志时间范围筛选项。 */
+export function logDateSearch(t: (key: string) => string): SearchProps {
+  return {
+    el: "date-picker",
+    props: {
+      type: "daterange",
+      editable: false,
+      class: "!w-[240px]",
+      rangeSeparator: "~",
+      startPlaceholder: t("common.placeholder.start_date"),
+      endPlaceholder: t("common.placeholder.end_date"),
+      valueFormat: "YYYY-MM-DD"
+    }
+  };
+}
+
+/** 创建审计日志详情按钮列。 */
+export function logDetailColumn(label: string, onClick: (id: string) => void): ColumnProps {
+  return {
+    prop: "detailAction",
+    label,
+    width: 100,
+    fixed: "right",
+    cellType: "actions",
+    actions: [
+      {
+        label,
+        type: "primary",
+        link: true,
+        onClick: scope => onClick(String(scope.row.id))
+      }
+    ]
+  };
+}
+
+/** 查询同一请求或链路关联的审计时间线。 */
+export async function requestLogTrace(requestID: string, traceID: string): Promise<BaseLogTraceItem[]> {
+  const response = await defBaseLogService.GetBaseLogTrace({ request_id: requestID, trace_id: traceID });
+  return response.items;
+}

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

@@ -0,0 +1,26 @@
+import { Document } from "@element-plus/icons-vue";
+import type { RuntimeConfigDefinition } from "./types";
+
+/** 日志入库回退配置模型。 */
+export interface BaseLogFallbackConfig {
+  file_path: string;
+}
+
+/** 日志入库回退配置定义。 */
+export const baseLogFallbackConfig: RuntimeConfigDefinition<BaseLogFallbackConfig> = {
+  key: "baseLogFallback",
+  titleKey: "system.base.runtime_config.base_log_fallback.title",
+  descriptionKey: "system.base.runtime_config.base_log_fallback.description",
+  icon: Document,
+  createModel: () => ({
+    file_path: "./logs/base-log-fallback"
+  }),
+  fields: [
+    {
+      prop: "file_path",
+      labelKey: "system.base.runtime_config.base_log_fallback.field.file_path",
+      component: "input",
+      rules: [{ required: true, messageKey: "system.base.runtime_config.base_log_fallback.validation.file_path", trigger: "blur" }]
+    }
+  ]
+};

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

@@ -0,0 +1,57 @@
+import { Coin } from "@element-plus/icons-vue";
+import type { RuntimeConfigDefinition } from "./types";
+
+/** 数据库备份配置模型。 */
+export interface DatabaseBackupConfig {
+  enabled: boolean;
+  integrity_key: string;
+  encryption_key: string;
+  directory: string;
+  gzip: boolean;
+  retention_count: number;
+}
+
+/** 数据库备份配置定义。 */
+export const databaseBackupConfig: RuntimeConfigDefinition<DatabaseBackupConfig> = {
+  key: "databaseBackup",
+  titleKey: "system.base.runtime_config.backup.title",
+  descriptionKey: "system.base.runtime_config.backup.description",
+  icon: Coin,
+  createModel: () => ({
+    enabled: false,
+    integrity_key: "",
+    encryption_key: "",
+    directory: "./backups",
+    gzip: true,
+    retention_count: 7
+  }),
+  fields: [
+    { prop: "enabled", labelKey: "system.base.runtime_config.field.enabled", component: "switch" },
+    {
+      prop: "integrity_key",
+      labelKey: "system.base.runtime_config.field.integrity_key",
+      component: "password",
+      props: { showPassword: true, autocomplete: "new-password" }
+    },
+    {
+      prop: "encryption_key",
+      labelKey: "system.base.runtime_config.field.encryption_key",
+      component: "password",
+      props: { showPassword: true, autocomplete: "new-password" }
+    },
+    {
+      prop: "directory",
+      labelKey: "system.base.runtime_config.field.directory",
+      component: "input",
+      rules: [{ required: true, messageKey: "system.base.runtime_config.validation.directory", trigger: "blur" }]
+    },
+    { prop: "gzip", labelKey: "system.base.runtime_config.field.gzip", component: "switch" },
+    {
+      prop: "retention_count",
+      labelKey: "system.base.runtime_config.field.retention_count",
+      component: "input-number",
+      props: { min: 1, max: 1000, controls: true },
+      rules: [{ type: "number", min: 1, messageKey: "system.base.runtime_config.validation.retention_count", trigger: "blur" }]
+    }
+  ]
+};

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

@@ -0,0 +1,26 @@
+import { shallowReactive } from "vue";
+import type { RuntimeConfigDefinition } from "./types";
+
+import { baseLogFallbackConfig } from "./base-log-fallback";
+
+export { baseLogFallbackConfig } from "./base-log-fallback";
+export type {
+  RuntimeConfigDefinition,
+  RuntimeConfigField,
+  RuntimeConfigMessageArg,
+  RuntimeConfigModel,
+  RuntimeConfigRule
+} from "./types";
+
+/** Admin 内置运行配置定义集合。 */
+export const runtimeConfigDefinitions = shallowReactive<RuntimeConfigDefinition[]>([
+  baseLogFallbackConfig
+]);
+
+/** 注册外部业务模块提供的运行配置定义。 */
+export function registerRuntimeConfig(definition: RuntimeConfigDefinition) {
+  if (runtimeConfigDefinitions.some(item => item.key === definition.key)) {
+    throw new Error(`Runtime config key already registered: ${definition.key}`);
+  }
+  runtimeConfigDefinitions.push(definition);
+}

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

@@ -0,0 +1,59 @@
+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[];
+}

package/dist/package/src/locales/README.md

@@ -14,11 +14,12 @@
 | 命名空间 | 文案范围 | 主要使用位置 |
 | --- | --- | --- |
 | `common.*` | 跨页面复用的操作、字段、弹窗、状态和校验文案。 | `src/views/**` 下的列表页、表单和确认弹窗。 |
-| `system.ai.*` | AI 会话、消息流、重试和错误提示。 | `src/views/ai/**`、`src/api/base/ai_message.ts`。 |
+| `system.ai.*` | AI 会话、消息流、重试和错误提示。 | `src/views/ai/**`、`src/api/base/v1/ai_message.ts`。 |
 | `system.profile.*` | 个人资料、安全设置和用户中心导航。 | `src/views/profile/**`、`src/module.ts` 的用户菜单。 |
 | `system.base.*` | 区域、配置、部门、字典、岗位、角色、租户、用户等基础管理页面。 | `src/views/base/**`。 |
 | `system.base.oauth_client.*` | 开放授权客户端字段、凭据和 API 选择。 | `src/views/base/oauth-client/**`。 |
 | `system.code.gen.*` | 代码生成配置、预览、列配置和多语言编辑。 | `src/views/tool/code-gen/**`。 |
+| `system.cache.*` | 运行时缓存查询、分页结果和条目详情。 | `src/views/tool/cache/**`。 |
 | `system.i18n.*` | 动态翻译编辑、草稿生成和语言包状态。 | `src/components/DynamicI18nEditor.vue`、代码生成语言编辑组件。 |
 
 语言包由生成的 `generated.ts` 传入 `systemAdminModule.messages`，由 core 的 `registerLocaleMessages` 校验语言键集合、命名空间和占位符后注册到 Vue I18n；业务代码统一使用 `t('system....')` 或 `useLocaleStore()` 读取。