@liujitcn/kratos-admin-system 0.0.21 → 0.0.24

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

@@ -1,30 +1,21 @@
-import { TranslationStatus } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_translation";
 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;
-  translation_status: TranslationStatus;
-  source_changed: boolean;
-  source_hash: string;
-  translation_provider: string;
-  translated_at: string;
   id: number;
-  reviewed_by: number;
-  reviewed_at: string;
-  created_by: number;
-  updated_by: number;
-  created_at: string;
-  updated_at: string;
-  deleted_at: number;
 }
 
 /** DynamicTranslationRecord 描述三类动态资源翻译共有字段。 */
 export interface DynamicTranslationRecord extends Omit<DynamicTranslationValue, "text"> {
-  title?: string;
+  target_type?: TranslationTargetType;
+  target_id?: number;
   name?: string;
+  /** 兼容旧接口缓存中的字段名。 */
+  title?: string;
   label?: string;
 }
 
@@ -52,7 +43,7 @@ export function getLanguageLabel(locale: string): string {
 /** normalizeDynamicTranslations 将后端翻译记录补齐为全部非主语言编辑状态。 */
 export function normalizeDynamicTranslations(
   records: DynamicTranslationRecord[] | undefined,
-  textField: "title" | "name" | "label",
+  _textField: "title" | "name" | "label",
   locales: string[] = getEditableLanguageOptions().map(item => item.value)
 ): DynamicTranslationValue[] {
   return locales.map(locale => {
@@ -60,19 +51,7 @@ export function normalizeDynamicTranslations(
     return {
       id: record?.id ?? 0,
       locale,
-      text: String(record?.[textField] ?? ""),
-      translation_status: record?.translation_status ?? TranslationStatus.TRANSLATION_STATUS_PENDING,
-      source_changed: record?.source_changed ?? false,
-      source_hash: record?.source_hash ?? "",
-      translation_provider: record?.translation_provider ?? "",
-      translated_at: record?.translated_at ?? "",
-      reviewed_by: record?.reviewed_by ?? 0,
-      reviewed_at: record?.reviewed_at ?? "",
-      created_by: record?.created_by ?? 0,
-      updated_by: record?.updated_by ?? 0,
-      created_at: record?.created_at ?? "",
-      updated_at: record?.updated_at ?? "",
-      deleted_at: record?.deleted_at ?? 0
+      text: String(record?.name ?? record?.[_textField] ?? "")
     };
   });
 }
@@ -80,7 +59,8 @@ export function normalizeDynamicTranslations(
 /** serializeDynamicTranslations 将编辑状态转换回后端资源翻译结构。 */
 export function serializeDynamicTranslations(
   values: DynamicTranslationValue[],
-  textField: "title" | "name" | "label"
-): Array<{ locale: string; [key: string]: string }> {
-  return values.map(({ locale, text }) => ({ locale, [textField]: text }));
+  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

@@ -4,7 +4,7 @@
 
 | 文件 | 用途 | 使用位置 |
 | --- | --- | --- |
-| `zh-CN.json` | System 模块简体中文固定 UI 默认语言包，也是七语键集合和占位符校验基准。 | 管理端固定文案默认语言及缺失翻译回退。 |
+| `zh-CN.json` | System 模块简体中文固定 UI 默认语言包，也是所有语言键集合和占位符校验基准。 | 管理端固定文案默认语言及缺失翻译回退。 |
 | `zh-TW.json` | System 模块繁体中文语言包。 | 管理端切换为繁体中文时由 Vue I18n 使用。 |
 | `en-US.json` | System 模块英文语言包。 | 管理端切换为英文时由 Vue I18n 使用。 |
 | `ja-JP.json` | System 模块日文语言包。 | 管理端切换为日文时由 Vue I18n 使用。 |
@@ -16,13 +16,15 @@
 
 | 命名空间 | 文案范围 | 主要使用位置 |
 | --- | --- | --- |
-| `system.common.*` | System 页面共用的操作、字段、弹窗、状态和校验文案。 | `src/views/**` 下的列表页、表单和确认弹窗。 |
+| `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.codegen.*` | 代码生成配置、预览、列配置和多语言编辑。 | `src/views/tool/code-gen/**`。 |
+| `system.code.gen.*` | 代码生成配置、预览、列配置和多语言编辑。 | `src/views/tool/code-gen/**`。 |
 | `system.translation.*` | 动态翻译编辑、草稿生成和语言包状态。 | `src/components/DynamicTranslationEditor.vue`、代码生成语言编辑组件。 |
 
-语言包由 `module.ts` 传入 `systemAdminModule.messages`，由 core 的 `registerLocaleMessages` 校验七语键集合、命名空间和占位符后注册到 Vue I18n；业务代码统一使用 `t('system....')` 或 `useLocaleStore()` 读取。
+语言包由生成的 `generated.ts` 传入 `systemAdminModule.messages`，由 core 的 `registerLocaleMessages` 校验语言键集合、命名空间和占位符后注册到 Vue I18n；业务代码统一使用 `t('system....')` 或 `useLocaleStore()` 读取。
 
-语言键必须使用 `system.` 命名空间；语言包保持标准 JSON，不在文件内写注释。
+语言键按文案归属使用 `common.` 或 `system.` 命名空间；语言包保持标准 JSON，不在文件内写注释。
+
+新增语言的完整文件清单和迁移流程见[国际化语言扩展指南](../../../../../../docs/国际化语言扩展指南.md)。