@liujitcn/kratos-admin-system 0.0.20 → 0.0.23

package/dist/package/src/api/system/ops_monitoring.ts

@@ -0,0 +1,88 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import type {
+  GetOpsAlertsRequest,
+  GetOpsEndpointsRequest,
+  GetOpsNodesRequest,
+  GetOpsRuntimeRequest,
+  GetOpsServicesRequest,
+  GetOpsStorageRequest,
+  GetOpsTrafficRequest,
+  OpsAlertsResponse,
+  OpsEndpointsResponse,
+  OpsNodesResponse,
+  OpsRuntime,
+  OpsServicesResponse,
+  OpsStorageResponse,
+  OpsTrafficResponse,
+  OpsMonitoringService
+} from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/ops_monitoring";
+
+const OPS_MONITORING_URL = "/v1/admin/ops-monitoring";
+
+/** Admin运维监控服务。 */
+export class OpsMonitoringServiceImpl implements OpsMonitoringService {
+  /** 查询当前进程运行信息。 */
+  GetOpsRuntime(request: GetOpsRuntimeRequest): Promise<OpsRuntime> {
+    return service<GetOpsRuntimeRequest, OpsRuntime>({
+      url: `${OPS_MONITORING_URL}/runtime`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询请求流量与延迟趋势。 */
+  GetOpsTraffic(request: GetOpsTrafficRequest): Promise<OpsTrafficResponse> {
+    return service<GetOpsTrafficRequest, OpsTrafficResponse>({
+      url: `${OPS_MONITORING_URL}/traffic`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询服务和外部依赖状态。 */
+  GetOpsServices(request: GetOpsServicesRequest): Promise<OpsServicesResponse> {
+    return service<GetOpsServicesRequest, OpsServicesResponse>({
+      url: `${OPS_MONITORING_URL}/services`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询数据库和缓存状态。 */
+  GetOpsStorage(request: GetOpsStorageRequest): Promise<OpsStorageResponse> {
+    return service<GetOpsStorageRequest, OpsStorageResponse>({
+      url: `${OPS_MONITORING_URL}/storage`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询接口请求摘要。 */
+  GetOpsEndpoints(request: GetOpsEndpointsRequest): Promise<OpsEndpointsResponse> {
+    return service<GetOpsEndpointsRequest, OpsEndpointsResponse>({
+      url: `${OPS_MONITORING_URL}/endpoints`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询实例资源状态。 */
+  GetOpsNodes(request: GetOpsNodesRequest): Promise<OpsNodesResponse> {
+    return service<GetOpsNodesRequest, OpsNodesResponse>({
+      url: `${OPS_MONITORING_URL}/nodes`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 查询窗口内告警事件。 */
+  GetOpsAlerts(request: GetOpsAlertsRequest): Promise<OpsAlertsResponse> {
+    return service<GetOpsAlertsRequest, OpsAlertsResponse>({
+      url: `${OPS_MONITORING_URL}/alerts`,
+      method: "get",
+      params: request
+    });
+  }
+}
+
+export const defOpsMonitoringService = new OpsMonitoringServiceImpl();

package/dist/package/src/api/system/ops_monitoring_sse.ts

@@ -0,0 +1,49 @@
+import { subscribeSseEvent, type SseStop } from "../base/sse";
+import type {
+  OpsNodesResponse,
+  OpsServicesResponse,
+  OpsStorageResponse,
+  OpsTrafficResponse
+} from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/ops_monitoring";
+
+const OPS_MONITORING_SSE_STREAM = "system.admin.ops-monitoring";
+const OPS_MONITORING_SSE_TRAFFIC = "ops.traffic";
+const OPS_MONITORING_SSE_SERVICES = "ops.services";
+const OPS_MONITORING_SSE_STORAGE = "ops.storage";
+const OPS_MONITORING_SSE_NODES = "ops.nodes";
+
+/** 运维监控 SSE 取消订阅函数。 */
+export type OpsMonitoringSseStop = SseStop;
+
+/** 订阅运维监控流量实时事件。 */
+export function subscribeOpsMonitoringTraffic(handler: (payload: OpsTrafficResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_TRAFFIC, parsePayload<OpsTrafficResponse>, handler);
+}
+
+/** 订阅运维监控服务实时事件。 */
+export function subscribeOpsMonitoringServices(handler: (payload: OpsServicesResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_SERVICES, parsePayload<OpsServicesResponse>, handler);
+}
+
+/** 订阅运维监控存储实时事件。 */
+export function subscribeOpsMonitoringStorage(handler: (payload: OpsStorageResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_STORAGE, parsePayload<OpsStorageResponse>, handler);
+}
+
+/** 订阅运维监控实例实时事件。 */
+export function subscribeOpsMonitoringNodes(handler: (payload: OpsNodesResponse) => void): SseStop {
+  return subscribeOpsMonitoringEvent(OPS_MONITORING_SSE_NODES, parsePayload<OpsNodesResponse>, handler);
+}
+
+function subscribeOpsMonitoringEvent<T>(event: string, parser: (raw: string) => T | null, handler: (payload: T) => void): SseStop {
+  return subscribeSseEvent({ stream: OPS_MONITORING_SSE_STREAM }, event, parser, handler);
+}
+
+function parsePayload<T>(raw: string): T | null {
+  if (!raw) return null;
+  try {
+    return JSON.parse(raw) as T;
+  } catch {
+    return null;
+  }
+}

package/dist/package/src/components/DynamicTranslationCell.vue

@@ -0,0 +1,249 @@
+<template>
+  <el-link class="dynamic-translation-cell" type="primary" underline="never" @click="openDialog">
+    <span class="dynamic-translation-cell__source">{{ displaySource || "--" }}</span>
+  </el-link>
+
+  <ProDialog
+    v-model="dialogVisible"
+    :title="displaySource"
+    width="760px"
+    append-to-body
+    :destroy-on-close="true"
+    @closed="handleDialogClosed"
+  >
+    <el-table v-loading="loading" :data="translationRows" border>
+      <el-table-column :label="t('common.field.language')" width="150">
+        <template #default="{ row }">
+          {{ getLanguageLabel(row.locale) }}
+        </template>
+      </el-table-column>
+      <el-table-column :label="t('system.base.translation.field.translations')" min-width="360">
+        <template #default="{ row }">
+          <el-input
+            v-if="row.editing"
+            v-model="row.text"
+            :placeholder="t('system.base.translation.placeholder.text', { language: getLanguageLabel(row.locale) })"
+          />
+          <span v-else class="dynamic-translation-dialog__text">
+            {{ row.text || t("common.value.none") }}
+          </span>
+        </template>
+      </el-table-column>
+      <el-table-column :label="t('common.field.operation')" width="150" fixed="right">
+        <template #default="{ row }">
+          <el-button v-if="!row.editing" link type="primary" :icon="EditPen" @click="startEdit(row)">
+            {{ t("common.action.edit") }}
+          </el-button>
+          <template v-else>
+            <el-button link type="primary" :icon="Check" :loading="row.saving" @click="saveTranslation(row)">
+              {{ t("common.action.save") }}
+            </el-button>
+            <el-button link :icon="Close" :disabled="row.saving" @click="cancelEdit(row)">
+              {{ t("common.action.cancel") }}
+            </el-button>
+          </template>
+        </template>
+      </el-table-column>
+    </el-table>
+  </ProDialog>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch } from "vue";
+import { ElMessage } from "element-plus";
+import { Check, Close, EditPen } from "@element-plus/icons-vue";
+import ProDialog from "@liujitcn/kratos-admin-core/components/Dialog/ProDialog.vue";
+import { t, useLocaleStore } from "@liujitcn/kratos-admin-core";
+import { loadEnabledBaseLanguages, useEnabledBaseLanguages } from "@liujitcn/kratos-admin-system/api/system/base_language";
+import { defBaseTranslationService } from "@liujitcn/kratos-admin-system/api/system/base_translation";
+import type { BaseTranslation } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_translation";
+import { TranslationTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_translation";
+import { getLanguageLabel } from "./dynamicTranslation";
+
+/** DynamicTranslationCellProps 动态翻译列表单元格属性。 */
+interface DynamicTranslationCellProps {
+  /** 资源源文。 */
+  source: string;
+  /** 统一翻译表目标类型。 */
+  targetType?: TranslationTargetType;
+  /** 目标资源编号。 */
+  targetId?: number;
+  /** 资源列表返回的非主语言翻译。 */
+  translations?: BaseTranslation[];
+}
+
+const props = defineProps<DynamicTranslationCellProps>();
+
+const { languages } = useEnabledBaseLanguages();
+const { locale } = useLocaleStore();
+const dialogVisible = ref(false);
+const loading = ref(false);
+const translationRows = ref<DynamicTranslationRow[]>([]);
+const translationOverrides = ref(new Map<string, string>());
+
+const displaySource = computed(() => {
+  const override = translationOverrides.value.get(locale.value);
+  if (override) return override;
+  const translation = props.translations?.find(item => item.locale === locale.value && item.name);
+  return translation?.name || props.source;
+});
+
+watch(
+  () => [props.targetType, props.targetId],
+  () => {
+    translationRows.value = [];
+    translationOverrides.value.clear();
+    dialogVisible.value = false;
+  }
+);
+
+/** DynamicTranslationRow 描述弹窗内可编辑的单语言翻译行。 */
+interface DynamicTranslationRow {
+  /** 翻译记录主键，新增翻译时为空。 */
+  id: number;
+  /** 语言区域。 */
+  locale: string;
+  /** 翻译文本。 */
+  text: string;
+  /** 是否处于编辑状态。 */
+  editing: boolean;
+  /** 是否正在保存。 */
+  saving: boolean;
+  /** 编辑前的文本，用于取消编辑。 */
+  originalText: string;
+}
+
+/** openDialog 打开翻译编辑弹窗并加载当前资源译文。 */
+async function openDialog() {
+  dialogVisible.value = true;
+  await loadTranslations();
+}
+
+/** loadTranslations 查询当前资源的翻译并补齐启用语言行。 */
+async function loadTranslations() {
+  const targetType = props.targetType;
+  const targetId = props.targetId;
+  if (!targetType || !targetId) return;
+  loading.value = true;
+  try {
+    await loadEnabledBaseLanguages();
+    const rows = await queryTranslationRows();
+    translationRows.value = rows;
+    const missingRows = rows.filter(row => !row.text);
+    if (missingRows.length === 0) return;
+    if (!props.source) return;
+    const draft = await defBaseTranslationService.DraftBaseTranslation({ source: props.source });
+    const translations = new Map(draft.translations.map(item => [item.locale, item.translation]));
+    const results = await Promise.allSettled(
+      missingRows.map(async row => {
+        const translation = translations.get(row.locale);
+        if (!translation) throw new Error("translation not found");
+        await defBaseTranslationService.UpdateBaseTranslation({
+          id: row.id,
+          target_type: targetType,
+          target_id: targetId,
+          locale: row.locale,
+          name: translation
+        });
+        return { row, text: translation };
+      })
+    );
+    for (const result of results) {
+      if (result.status !== "fulfilled") continue;
+      result.value.row.text = result.value.text;
+      result.value.row.originalText = result.value.text;
+      translationOverrides.value.set(result.value.row.locale, result.value.text);
+    }
+  } catch {
+    ElMessage.error(t("common.message.system_error"));
+  } finally {
+    loading.value = false;
+  }
+}
+
+/** queryTranslationRows 将列表返回的翻译记录补齐为可编辑语言行。 */
+async function queryTranslationRows(): Promise<DynamicTranslationRow[]> {
+  const records = new Map((props.translations ?? []).map(item => [item.locale, item]));
+  return languages.value
+    .filter(item => !item.is_primary)
+    .map(item => {
+      const record = records.get(item.language_code);
+      const text = translationOverrides.value.get(item.language_code) ?? record?.name ?? "";
+      return {
+        id: record?.id ?? 0,
+        locale: item.language_code,
+        text,
+        editing: false,
+        saving: false,
+        originalText: text
+      };
+    });
+}
+
+/** startEdit 开启指定语言的编辑状态。 */
+function startEdit(row: DynamicTranslationRow) {
+  row.originalText = row.text;
+  row.editing = true;
+}
+
+/** cancelEdit 恢复编辑前的内容。 */
+function cancelEdit(row: DynamicTranslationRow) {
+  row.text = row.originalText;
+  row.editing = false;
+}
+
+/** saveTranslation 使用统一更新接口保存指定语言译文。 */
+async function saveTranslation(row: DynamicTranslationRow) {
+  const targetType = props.targetType;
+  const targetId = props.targetId;
+  if (row.saving || !targetType || !targetId) return;
+  if (row.id === 0 && !row.text) {
+    row.editing = false;
+    return;
+  }
+  row.saving = true;
+  try {
+    await defBaseTranslationService.UpdateBaseTranslation({
+      id: row.id,
+      target_type: targetType,
+      target_id: targetId,
+      locale: row.locale,
+      name: row.text
+    });
+    ElMessage.success(t("common.message.operation_success"));
+    row.editing = false;
+    row.originalText = row.text;
+    translationOverrides.value.set(row.locale, row.text);
+  } catch {
+    ElMessage.error(t("common.message.system_error"));
+  } finally {
+    row.saving = false;
+  }
+}
+
+/** handleDialogClosed 清理弹窗状态，避免复用旧资源译文。 */
+function handleDialogClosed() {
+  translationRows.value = [];
+  loading.value = false;
+}
+</script>
+
+<style scoped>
+.dynamic-translation-cell {
+  display: inline-flex;
+  align-items: center;
+  min-width: 0;
+  max-width: 100%;
+}
+
+.dynamic-translation-cell__source {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.dynamic-translation-dialog__text {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+</style>

package/dist/package/src/components/DynamicTranslationEditor.vue

@@ -0,0 +1,197 @@
+<template>
+  <div class="translation-editor">
+    <div class="translation-editor__toolbar">
+      <el-button
+        type="primary"
+        size="small"
+        :icon="Promotion"
+        :loading="translating"
+        :disabled="!canTranslate"
+        @click="handleBatchTranslate"
+      >
+        {{ t("system.base.translation.action.batch_translate") }}
+      </el-button>
+    </div>
+    <div v-for="item in localValues" :key="item.locale" class="translation-editor__row">
+      <div class="translation-editor__heading">
+        <span>{{ getLanguageLabel(item.locale) }}</span>
+      </div>
+      <div class="translation-editor__control" :class="{ 'translation-editor__control--multiline': multiline }">
+        <el-input
+          :model-value="item.text"
+          :maxlength="maxlength"
+          :type="multiline ? 'textarea' : 'text'"
+          :rows="multiline ? 6 : undefined"
+          :disabled="translating || translatingLocale === item.locale"
+          show-word-limit
+          :placeholder="t('system.base.translation.placeholder.text', { language: getLanguageLabel(item.locale) })"
+          @update:model-value="value => updateText(item.locale, value)"
+        />
+        <el-button
+          class="translation-editor__translate"
+          link
+          type="primary"
+          size="small"
+          :icon="Promotion"
+          :loading="translatingLocale === item.locale"
+          :disabled="!props.source || Boolean(item.text) || translating || Boolean(translatingLocale)"
+          @click="handleTranslate(item.locale)"
+        >
+          {{ t("system.base.translation.action.translate") }}
+        </el-button>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch } from "vue";
+import { ElMessage } from "element-plus";
+import { Promotion } from "@element-plus/icons-vue";
+import { t, useLocaleStore } from "@liujitcn/kratos-admin-core";
+import { defBaseTranslationService } from "@liujitcn/kratos-admin-system/api/system/base_translation";
+import { getLanguageLabel, type DynamicTranslationValue } from "./dynamicTranslation";
+
+/** DynamicTranslationEditorProps 动态翻译编辑器属性。 */
+interface DynamicTranslationEditorProps {
+  modelValue: DynamicTranslationValue[];
+  /** 当前语言源文本。 */
+  source?: string;
+  maxlength?: number;
+  multiline?: boolean;
+}
+
+const props = withDefaults(defineProps<DynamicTranslationEditorProps>(), {
+  source: "",
+  maxlength: 100,
+  multiline: false
+});
+
+const { locale: currentLocale } = useLocaleStore();
+const emit = defineEmits<{ "update:modelValue": [value: DynamicTranslationValue[]] }>();
+const localValues = ref<DynamicTranslationValue[]>([]);
+const translating = ref(false);
+const translatingLocale = ref("");
+const canTranslate = computed(() => Boolean(props.source) && localValues.value.some(item => !item.text && item.locale !== currentLocale.value));
+
+watch(
+  () => props.modelValue,
+  value => {
+    localValues.value = value.map(item => ({ ...item }));
+  },
+  { immediate: true, deep: true }
+);
+
+/** updateText 更新指定语言的人工译文。 */
+function updateText(locale: DynamicTranslationValue["locale"], text: string) {
+  const values = localValues.value.map(item => (item.locale === locale ? { ...item, text } : item));
+  localValues.value = values;
+  emit("update:modelValue", values);
+}
+
+/** handleBatchTranslate 批量翻译当前仍为空的语言输入框。 */
+async function handleBatchTranslate() {
+  if (!canTranslate.value || translating.value) return;
+  translating.value = true;
+  try {
+    const pending = localValues.value.filter(item => !item.text && item.locale !== currentLocale.value);
+    const response = await defBaseTranslationService.DraftBaseTranslation({ source: props.source });
+    const translations = new Map(response.translations.map(item => [item.locale, item.translation]));
+    const failed = pending.filter(item => !translations.has(item.locale)).length;
+    if (translations.size) {
+      const values = localValues.value.map(item => {
+        const translation = translations.get(item.locale);
+        return translation === undefined ? item : { ...item, text: translation };
+      });
+      localValues.value = values;
+      emit("update:modelValue", values);
+    }
+    if (failed) {
+      ElMessage.warning(
+        t("system.base.translation.message.batch_translate_partial", {
+          success: translations.size,
+          failed
+        })
+      );
+    } else {
+      ElMessage.success(t("system.base.translation.message.batch_translate_success", { count: translations.size }));
+    }
+  } catch {
+    ElMessage.error(t("system.base.translation.message.batch_translate_failed"));
+  } finally {
+    translating.value = false;
+  }
+}
+
+/** handleTranslate 翻译指定语言的单个输入框。 */
+async function handleTranslate(locale: string) {
+  const item = localValues.value.find(value => value.locale === locale);
+  if (!item || item.text || item.locale === currentLocale.value || !props.source || translating.value || translatingLocale.value) return;
+  translatingLocale.value = locale;
+  try {
+    const response = await defBaseTranslationService.DraftBaseTranslation({ source: props.source, locale });
+    const translation = response.translations.find(item => item.locale === locale)?.translation;
+    if (!translation) throw new Error("translation not found");
+    const values = localValues.value.map(value => (value.locale === locale ? { ...value, text: translation } : value));
+    localValues.value = values;
+    emit("update:modelValue", values);
+    ElMessage.success(t("system.base.translation.message.translate_success", { language: getLanguageLabel(locale) }));
+  } catch {
+    ElMessage.error(t("system.base.translation.message.translate_failed", { language: getLanguageLabel(locale) }));
+  } finally {
+    translatingLocale.value = "";
+  }
+}
+
+</script>
+
+<style scoped>
+.translation-editor {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  width: 100%;
+}
+.translation-editor__toolbar {
+  display: flex;
+  justify-content: flex-end;
+}
+.translation-editor__row {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.translation-editor__heading,
+.translation-editor__control {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+.translation-editor__heading {
+  color: var(--el-text-color-regular);
+}
+.translation-editor__control {
+  position: relative;
+  width: 100%;
+}
+.translation-editor__control :deep(.el-input) {
+  flex: 1;
+}
+.translation-editor__control--multiline :deep(.el-textarea__inner) {
+  padding-right: 78px;
+}
+.translation-editor__control:not(.translation-editor__control--multiline) :deep(.el-input__suffix) {
+  padding-right: 78px;
+}
+.translation-editor__translate {
+  position: absolute;
+  z-index: 1;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+}
+.translation-editor__control--multiline .translation-editor__translate {
+  top: 8px;
+  transform: none;
+}
+</style>

package/dist/package/src/components/dynamicTranslation.ts

@@ -0,0 +1,66 @@
+import { getEnabledBaseLanguages } from "@liujitcn/kratos-admin-system/api/system/base_language";
+import type { TranslationTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_translation";
+
+/** DynamicTranslationValue 动态资源单语言翻译编辑状态。 */
+export interface DynamicTranslationValue {
+  /** 语言代码。 */
+  locale: string;
+  text: string;
+  id: number;
+}
+
+/** DynamicTranslationRecord 描述三类动态资源翻译共有字段。 */
+export interface DynamicTranslationRecord extends Omit<DynamicTranslationValue, "text"> {
+  target_type?: TranslationTargetType;
+  target_id?: number;
+  name?: string;
+  /** 兼容旧接口缓存中的字段名。 */
+  title?: string;
+  label?: string;
+}
+
+/** DynamicLanguageOption 动态翻译编辑器显示的语言选项。 */
+export interface DynamicLanguageOption {
+  /** 语言代码。 */
+  value: string;
+  /** 语言显示名称。 */
+  label: string;
+}
+
+/** 返回语言管理中启用且非主语言的翻译语言选项。 */
+export function getEditableLanguageOptions(): DynamicLanguageOption[] {
+  return getEnabledBaseLanguages()
+    .filter(item => !item.is_primary)
+    .map(item => ({ value: item.language_code, label: item.native_name || item.language_name || item.language_code }));
+}
+
+/** 返回语言管理中的语言显示名称。 */
+export function getLanguageLabel(locale: string): string {
+  const language = getEnabledBaseLanguages().find(item => item.language_code === locale);
+  return language?.native_name || language?.language_name || locale;
+}
+
+/** normalizeDynamicTranslations 将后端翻译记录补齐为全部非主语言编辑状态。 */
+export function normalizeDynamicTranslations(
+  records: DynamicTranslationRecord[] | undefined,
+  _textField: "title" | "name" | "label",
+  locales: string[] = getEditableLanguageOptions().map(item => item.value)
+): DynamicTranslationValue[] {
+  return locales.map(locale => {
+    const record = records?.find(item => item.locale === locale);
+    return {
+      id: record?.id ?? 0,
+      locale,
+      text: String(record?.name ?? record?.[_textField] ?? "")
+    };
+  });
+}
+
+/** serializeDynamicTranslations 将编辑状态转换回后端资源翻译结构。 */
+export function serializeDynamicTranslations(
+  values: DynamicTranslationValue[],
+  targetType: TranslationTargetType,
+  targetId: number
+): Array<{ id: number; target_type: TranslationTargetType; target_id: number; locale: string; name: string }> {
+  return values.map(({ id, locale, text }) => ({ id, target_type: targetType, target_id: targetId, locale, name: text }));
+}

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

@@ -0,0 +1,30 @@
+# 管理端 System 语言包
+
+本目录提供 System 管理业务模块的页面、AI、个人中心、基础资料和代码生成等业务文案。语言包由同级 `../module.ts` 导入，随 `systemAdminModule` 注册；管理端启动时由 core 的 `registerLocaleMessages` 合并，System 页面和组件通过 `t()` 或 `useLocaleStore()` 使用 `system.*` 键。
+
+| 文件 | 用途 | 使用位置 |
+| --- | --- | --- |
+| `zh-CN.json` | System 模块简体中文固定 UI 默认语言包，也是所有语言键集合和占位符校验基准。 | 管理端固定文案默认语言及缺失翻译回退。 |
+| `zh-TW.json` | System 模块繁体中文语言包。 | 管理端切换为繁体中文时由 Vue I18n 使用。 |
+| `en-US.json` | System 模块英文语言包。 | 管理端切换为英文时由 Vue I18n 使用。 |
+| `ja-JP.json` | System 模块日文语言包。 | 管理端切换为日文时由 Vue I18n 使用。 |
+| `ko-KR.json` | System 模块韩语语言包。 | 管理端切换为韩语时由 Vue I18n 使用。 |
+| `fr-FR.json` | System 模块法语语言包。 | 管理端切换为法语时由 Vue I18n 使用。 |
+| `es-ES.json` | System 模块西班牙语语言包。 | 管理端切换为西班牙语时由 Vue I18n 使用。 |
+
+## 命名空间与使用位置
+
+| 命名空间 | 文案范围 | 主要使用位置 |
+| --- | --- | --- |
+| `common.*` | 跨页面复用的操作、字段、弹窗、状态和校验文案。 | `src/views/**` 下的列表页、表单和确认弹窗。 |
+| `system.ai.*` | AI 会话、消息流、重试和错误提示。 | `src/views/ai/**`、`src/api/base/ai_message.ts`。 |
+| `system.profile.*` | 个人资料、安全设置和用户中心导航。 | `src/views/profile/**`、`src/module.ts` 的用户菜单。 |
+| `system.base.*` | 区域、配置、部门、字典、岗位、角色、租户、用户等基础管理页面。 | `src/views/base/**`。 |
+| `system.code.gen.*` | 代码生成配置、预览、列配置和多语言编辑。 | `src/views/tool/code-gen/**`。 |
+| `system.translation.*` | 动态翻译编辑、草稿生成和语言包状态。 | `src/components/DynamicTranslationEditor.vue`、代码生成语言编辑组件。 |
+
+语言包由生成的 `generated.ts` 传入 `systemAdminModule.messages`，由 core 的 `registerLocaleMessages` 校验语言键集合、命名空间和占位符后注册到 Vue I18n；业务代码统一使用 `t('system....')` 或 `useLocaleStore()` 读取。
+
+语言键按文案归属使用 `common.` 或 `system.` 命名空间；语言包保持标准 JSON，不在文件内写注释。
+
+新增语言的完整文件清单和迁移流程见[国际化语言扩展指南](../../../../../../docs/国际化语言扩展指南.md)。