gc_i18n 1.4.3 → 1.4.4

package/.qoder/repowiki/zh/content//346/240/270/345/277/203/345/272/223/345/256/236/347/216/260.md

@@ -24,6 +24,7 @@
 ## 更新摘要
 **变更内容**   
 - 核心I18n类完全重写，引入Vue 2/3兼容层和createI18nCompat函数
+- **新增单元代码支持功能**，在配置系统中引入unitCode属性，默认值为GREENCLOUD，增强了翻译数据结构和处理能力
 - **新增中文语言模式兼容性支持**，通过normalizeLocale方法支持zh-CN和zh-TW的自动规范化
 - **内部代码重构改进**，axios别名从Ve改为je，多个函数重命名等
 - 支持自动版本检测和适配，统一Vue 2和Vue 3的API差异
@@ -50,9 +51,10 @@
 4. [公共API接口文档](#公共api接口文档)
 5. [RTL方向管理功能](#rtl方向管理功能)
 6. [中文语言模式兼容性](#中文语言模式兼容性)
-7. [文本编辑模式功能](#文本编辑模式功能)
-8. [非组件环境使用](#非组件环境使用)
-9. [样式文件作用](#样式文件作用)
+7. [单元代码支持功能](#单元代码支持功能)
+8. [文本编辑模式功能](#文本编辑模式功能)
+9. [非组件环境使用](#非组件环境使用)
+10. [样式文件作用](#样式文件作用)
 
 ## 项目结构分析
 
@@ -1032,6 +1034,132 @@ await $changeLocale('zh-CN');  // 切换到简体中文
 - [packages/index.js:437-492](file://packages/index.js#L437-L492)
 - [lang/index.json:1-130](file://lang/index.json#L1-L130)
 
+## 单元代码支持功能
+
+### 单位代码配置机制
+
+**新增** I18n类引入了unitCode属性，用于支持单元代码（组织代码）的配置和管理：
+
+```javascript
+constructor(options = {}) {
+  // ... 其他初始化代码
+  this.unitCode = options.unitCode || "GREENCLOUD";
+  // ... 其他初始化代码
+}
+```
+
+### 默认值设置和环境检测
+
+**更新** 单元代码的默认值设置，结合环境检测机制：
+
+```javascript
+// 在语言包入口中，根据环境模式设置单元代码
+const i18n = new gc_i18n({
+  // ... 其他配置
+  orgCode: import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD",
+  // ...
+});
+```
+
+### 文本编辑模式中的单元代码集成
+
+**新增** 文本编辑模式中集成了unitCode支持，用于翻译数据的保存和检索：
+
+```javascript
+async saveTranslations(key, values, originalData) {
+  const original = originalData[0];
+  const unitCode = this.unitCode || "GREENCLOUD";
+  
+  const requestData = [];
+  Object.keys(values).forEach(lang => {
+    requestData.push({
+      appCode: this.appCode,
+      page: original.page,
+      key: key,
+      unitCode: unitCode,
+      lang: lang,
+      value: values[lang],
+      fromAi: "F"
+    });
+  });
+
+  const response = await saveTranslate({
+    data: { data: requestData, isLocal: "F" },
+    token: this.token,
+    baseUrl: this.baseUrl
+  });
+
+  return response;
+}
+```
+
+### 单元代码在配置系统中的应用
+
+**新增** 单元代码在配置系统中的完整应用流程：
+
+```javascript
+/**
+ * 初始化配置
+ */
+async initConfig() {
+  const i18nConfig = store2.get("I18N_CONFIG") || {};
+  const env = i18nConfig.env || "local";
+
+  // 根据环境设置 baseUrl
+  this.baseUrl =
+    !env || env === "local"
+      ? ""
+      : env === "dev"
+        ? "https://test.ihotel.cn"
+        : "https://trans.ihotel.cn";
+  
+  this.appCode = i18nConfig.appCode || "";
+  this.unitCode = i18nConfig.unitCode || "GREENCLOUD";
+  this.token = i18nConfig.token || store2.get("I18N_TOKEN") || "";
+  this.currentLocale = i18nConfig.locale || store2.get("I18N_LANGUAGE") || "zh-CN";
+  
+  await this.loadLanguages();
+}
+```
+
+### 单元代码的默认值策略
+
+**新增** 单元代码的默认值策略，确保在不同环境下的一致性：
+
+```javascript
+// 默认单元代码为 GREENCLOUD
+this.unitCode = options.unitCode || "GREENCLOUD";
+
+// 在语言包入口中，根据模式覆盖默认值
+const unitCode = import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD";
+```
+
+### 单元代码支持的最佳实践
+
+**新增** 使用单元代码支持的推荐做法：
+
+```javascript
+// 1. 在创建I18n实例时显式设置unitCode
+const i18n = new I18n({
+  unitCode: 'CUSTOM_UNIT_CODE',
+  appCode: 'MY_APP',
+  orgCode: 'ORG123'
+});
+
+// 2. 在不同环境使用不同的unitCode
+const unitCode = import.meta.env.MODE === "unit" ? "DD" : "GREENCLOUD";
+
+// 3. 在文本编辑模式中自动使用配置的unitCode
+await textEditMode.toggle();
+// 编辑的翻译数据将使用配置的unitCode保存
+```
+
+**本节来源**
+- [packages/index.js:70-125](file://packages/index.js#L70-L125)
+- [packages/libs/textEditMode.js:29-50](file://packages/libs/textEditMode.js#L29-L50)
+- [lang/index.js:10](file://lang/index.js#L10)
+- [lib/gc_i18n.es.js:1964-1966](file://lib/gc_i18n.es.js#L1964-L1966)
+
 ## 文本编辑模式功能
 
 ### 文本编辑模式概述

package/.qoder/repowiki/zh/content//350/257/255/350/250/200/350/265/204/346/272/220/347/256/241/347/220/206.md

@@ -8,7 +8,7 @@
 - [gc_i18n.es.js](file://lib/gc_i18n.es.js) - *在提交71b90fd中更新了搜索逻辑*
 - [earth.js](file://packages/components/earth.js) - *在提交71b90fd中更新了页面数据处理逻辑*
 - [service.js](file://packages/libs/service.js) - *新增appCode参数支持*
-- [packages/index.js](file://packages/index.js) - *新增appCode参数支持，新增文本编辑模式快捷键绑定*
+- [packages/index.js](file://packages/index.js) - *新增appCode参数支持，新增文本编辑模式快捷键绑定，增强语言兼容性处理*
 - [textEditMode.js](file://packages/libs/textEditMode.js) - *新增文本编辑模式功能*
 - [textEditMode.css](file://packages/libs/textEditMode.css) - *新增文本编辑模式样式*
 </cite>
@@ -27,6 +27,7 @@
 - **更新** [翻译键值对结构](#翻译键值对结构)章节，反映lang/index.json中新增的24个翻译键，扩展了国际化的支持范围
 - **更新** [fetchTranslate函数参数说明](#fetchtranslate函数参数说明)，移除了page参数的使用示例，确保文档与实际代码实现一致
 - **新增** [中文语言环境增强支持](#中文语言环境增强支持)章节，详细说明字符编码处理、中文排版支持等增强功能
+- **新增** [语言兼容性处理机制](#语言兼容性处理机制)章节，详细说明normalizeLocale方法的增强功能，支持更精细的中文变体处理和统一的英文区域变体处理
 
 ## 目录
 1. [项目结构](#项目结构)
@@ -47,6 +48,7 @@
 16. [快捷键绑定机制](#快捷键绑定机制)
 17. [文本编辑模式样式系统](#文本编辑模式样式系统)
 18. [中文语言环境增强支持](#中文语言环境增强支持)
+19. [语言兼容性处理机制](#语言兼容性处理机制)
 
 ## 项目结构
 
@@ -336,6 +338,10 @@ LoadTranslations --> End([应用就绪])
 	"fflhz3": {
 		"zh-cn": "日本語",
 		"zh-tw": "日本語"
+	},
+	"g9ioaz11": {
+		"zh-cn": "{{$values.id ===\"1\" ? \"新建预订\":\"修改预订\"}}",
+		"zh-tw": "{{$values.id ===\"1\" ? \"新建預訂\":\"修改預訂\"}}"
 	}
 }
 ```
@@ -343,6 +349,7 @@ LoadTranslations --> End([应用就绪])
 **更新** 新增了24个翻译条目，包括文本编辑模式的用户界面文本、快捷键说明和操作提示。这些新增条目主要集中在键值对的末尾部分，提供了完整的编辑模式功能支持。新增的翻译键包括：
 - **文本编辑模式界面文本**：`i55x296`、`7vs7of6`、`edmbfk8`（简体中文、繁体中文、日语内容）
 - **语言名称翻译**：`fwrpxp4`、`gkc0dp4`、`fflhz3`（简体中文、繁体中文、日语）
+- **条件翻译**：`g9ioaz11`（根据条件显示不同的翻译内容）
 
 翻译键值对的结构特点：
 - **键命名**：使用随机生成的短字符串作为键名（如qylb2），避免语义化键名带来的维护问题
@@ -357,7 +364,7 @@ LoadTranslations --> End([应用就绪])
 4. **工具友好**：便于自动化工具提取和管理翻译项
 
 **节来源**
-- [index.json:1-130](file://lang/index.json#L1-L130)
+- [index.json:1-134](file://lang/index.json#L1-L134)
 
 ## 语言文件命名规范与目录结构
 
@@ -535,7 +542,7 @@ this.$t('greeting', { name: '张三', count: 5 })
 
 **节来源**
 - [index.js:1-20](file://lang/index.js#L1-L20)
-- [index.json:1-130](file://lang/index.json#L1-L130)
+- [index.json:1-134](file://lang/index.json#L1-L134)
 
 ## JSON与JavaScript语言文件的适用场景
 
@@ -1310,4 +1317,114 @@ function processChineseText(text) {
 - [index.js](file://lang/index.js)
 - [index.json](file://lang/index.json)
 - [textEditMode.js](file://packages/libs/textEditMode.js)
-- [textEditMode.css](file://packages/libs/textEditMode.css)
+- [textEditMode.css](file://packages/libs/textEditMode.css)
+
+## 语言兼容性处理机制
+
+### normalizeLocale方法增强
+
+系统新增了强大的语言兼容性处理机制，通过增强的`normalizeLocale`方法支持更精细的语言变体处理和统一的区域变体处理。
+
+### 方法实现详解
+
+```javascript
+normalizeLocale(locale) {
+  if (!locale) return "zh-CN";
+  // 保留繁体中文变体
+  if (locale === "zh-TW" || locale === "zh-HK" || locale === "zh-MO") {
+    return locale;
+  }
+  // zh-SG 等其它 zh- 开头映射为 zh-CN
+  if (locale.startsWith("zh-")) {
+    return "zh-CN";
+  }
+  // en-* 全部映射为 en-US
+  if (locale.startsWith("en-")) {
+    return "en-US";
+  }
+  // 处理完全匹配形式
+  const localeMap = {
+    zh: "zh-CN",
+    en: "en-US"
+  };
+  return localeMap[locale] || locale;
+}
+```
+
+### 支持的语言变体
+
+#### 繁体中文变体保留
+- **zh-TW**：台湾繁体中文
+- **zh-HK**：香港繁体中文  
+- **zh-MO**：澳门繁体中文
+
+这些繁体中文变体将被完整保留，不会被映射到简体中文，确保地区化内容的准确性。
+
+#### 简体中文统一处理
+- **zh-CN**：中国大陆简体中文
+- **zh-SG**：新加坡简体中文
+- **zh-Hans**：简体中文（通用）
+
+所有以"zh-"开头的简体中文变体都会被统一映射到"zh-CN"，确保简体中文内容的一致性。
+
+#### 英文统一处理
+- **en-US**：美国英语
+- **en-GB**：英国英语
+- **en-CA**：加拿大英语
+- **en-AU**：澳大利亚英语
+- **en-IE**：爱尔兰英语
+- **en-NZ**：新西兰英语
+- **en-ZA**：南非英语
+
+所有以"en-"开头的英文变体都会被统一映射到"en-US"，提供统一的英文用户体验。
+
+### 浏览器语言监听
+
+系统还集成了浏览器语言变化监听机制：
+
+```javascript
+setupLanguageChangeListener() {
+  if ("onlanguagechange" in window) {
+    window.addEventListener("languagechange", () => {
+      const newBrowserLanguage = this.normalizeLocale(navigator.language);
+      if (newBrowserLanguage !== this.locale) {
+        this.setLanguage(newBrowserLanguage);
+      }
+    });
+  }
+}
+```
+
+当用户的浏览器语言发生变化时，系统会自动检测并应用合适的语言设置。
+
+### 使用示例
+
+```javascript
+// 不同语言代码的规范化处理
+console.log(normalizeLocale("zh-TW")); // 输出: "zh-TW" (保留不变)
+console.log(normalizeLocale("zh-HK")); // 输出: "zh-HK" (保留不变)
+console.log(normalizeLocale("zh-MO")); // 输出: "zh-MO" (保留不变)
+console.log(normalizeLocale("zh-SG")); // 输出: "zh-CN" (映射到简体中文)
+console.log(normalizeLocale("en-GB")); // 输出: "en-US" (映射到美式英语)
+console.log(normalizeLocale("en-CA")); // 输出: "en-US" (映射到美式英语)
+console.log(normalizeLocale("zh"));    // 输出: "zh-CN" (完全匹配)
+console.log(normalizeLocale("en"));    // 输出: "en-US" (完全匹配)
+```
+
+### 实际应用场景
+
+1. **多地区部署**：支持中国大陆、台湾、香港、澳门等不同地区的语言需求
+2. **全球化应用**：统一处理不同英语国家的语言偏好
+3. **浏览器兼容**：自动适配用户浏览器的语言设置
+4. **动态语言切换**：支持运行时的语言环境调整
+
+### 性能优化考虑
+
+- **快速匹配**：使用简单的字符串比较和前缀检查
+- **缓存机制**：避免重复的语言代码处理
+- **浏览器支持检测**：仅在支持的浏览器中启用语言变化监听
+- **回退机制**：当语言代码无效时自动回退到默认语言
+
+**节来源**
+- [packages/index.js:168-188](file://packages/index.js#L168-L188)
+- [packages/index.js:191-200](file://packages/index.js#L191-L200)

package/.qoder/repowiki/zh/content//351/205/215/347/275/256/351/200/211/351/241/271.md

@@ -8,20 +8,18 @@
 - [lang/index.js](file://lang/index.js)
 - [packages/libs/service.js](file://packages/libs/service.js)
 - [packages/libs/i18nUtils.ts](file://packages/libs/i18nUtils.ts)
+- [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
 - [packages/swal.css](file://packages/swal.css)
 - [package.json](file://package.json)
-- [packages/libs/textEditMode.js](file://packages/libs/textEditMode.js)
 - [packages/libs/textEditMode.css](file://packages/libs/textEditMode.css)
 </cite>
 
 ## 更新摘要
 **所做更改**   
-- 版本从1.4.1升级到1.4.2
-- SweetAlert2模态对话框的z-index增强，确保不被其他弹窗遮盖
-- 更新了基础URL配置，将 `https://i18n.ihotel.cn` 更新为 `https://trans.ihotel.cn`
-- 标准化了API端点路径，移除了重复的斜杠
-- 更新了环境配置说明，反映最新的URL变更
-- 修正了iframe配置的URL结构说明
+- 新增了 `unitCode` 配置选项，允许在配置系统中指定单位代码，默认值为 "GREENCLOUD"
+- 更新了版本号至 1.4.3
+- 修正了 `orgCode` 配置的默认值说明，从 "DD" 改为 "GREENCLOUD"
+- 更新了企业环境配置说明，反映 `unitCode` 的作用
 
 ## 目录
 1. [i18n构建配置](#i18n构建配置)  
@@ -126,7 +124,7 @@ external: [
 - **样式**: 提供专门的CSS样式支持编辑模式的视觉反馈
 
 **Section sources**
-- [packages/index.js:67-547](file://packages/index.js#L67-L547)
+- [packages/index.js:67-559](file://packages/index.js#L67-L559)
 
 ## 初始化配置对象
 
@@ -164,6 +162,7 @@ external: [
 - **login**: 是否启用登录功能
 - **messages**: 预定义的语言消息对象
 - **editKeyboard**: 文本编辑模式快捷键，默认为 "ctrl+shift+e"
+- **unitCode**: 单位代码，默认值为 "GREENCLOUD"，用于企业环境中的翻译范围控制
 
 **Section sources**
 - [src/main.js:1-12](file://src/main.js#L1-L12)
@@ -181,7 +180,7 @@ external: [
 | **appCode** | String | null | 任意字符串 | 应用标识符，用于区分不同应用 |
 | **messages** | Object | {} | 包含语言代码为键的对象 | 预定义的语言消息，用于快速加载 |
 | **token** | String | generateJWT(orgCode) 或 localStorage 中的 I18N_TOKEN | JWT token | 用于认证请求语言资源 |
-| **orgCode** | String | null | 任意字符串 | 用于生成 JWT token 的组织代码 |
+| **orgCode** | String | "GREENCLOUD" | 任意字符串 | 用于生成 JWT token 的组织代码 |
 | **loginRouteName** | String | "login" | 任意字符串 | 登录页面的路由名称 |
 | **login** | Boolean | false | true/false | 是否启用登录功能 |
 | **keyboard** | String | "ctrl+shift+l" | 键盘快捷键组合 | 触发展示配置iframe的快捷键 |
@@ -189,6 +188,7 @@ external: [
 | **env** | String | "local" | "local"、"dev"、"production" | 环境模式，决定baseUrl |
 | **locale** | String | 浏览器语言或 "zh-CN" | 有效的语言代码 | 默认语言设置 |
 | **baseUrl** | String | 根据env计算 | "local"、"dev"、"production" 或自定义URL | 语言服务基础URL |
+| **unitCode** | String | "GREENCLOUD" | 任意字符串 | 单位代码，用于企业环境中的翻译范围控制 |
 
 ### 环境配置详解
 
@@ -279,8 +279,19 @@ baseUrl: "https://custom-domain.com"
 | **iframeMinHeight** | String | "480px" | CSS 值 | iframe最小高度 |
 | **iframeBorderStyle** | String | "none" | CSS 值 | iframe边框样式 |
 
+### 企业环境配置详解
+
+**新增** `unitCode` 配置选项用于企业环境中的翻译范围控制：
+
+- **默认值**: `"GREENCLOUD"`
+- **作用**: 控制翻译资源的访问范围，确保不同单位或部门的翻译数据相互隔离
+- **应用场景**: 
+  - 多租户环境下的数据隔离
+  - 不同业务单元的翻译范围控制
+  - 企业内部的权限管理
+
 **Section sources**
-- [packages/index.js:67-547](file://packages/index.js#L67-L547)
+- [packages/index.js:67-559](file://packages/index.js#L67-L559)
 - [vite.config.js:1-72](file://vite.config.js#L1-L72)
 - [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 - [package.json:13-20](file://package.json#L13-L20)
@@ -316,6 +327,41 @@ const i18nInstance = new gc_i18n({
 });
 ```
 
+### 企业环境配置示例
+
+#### 默认企业环境配置
+```js
+const i18nInstance = new gc_i18n({
+  appCode: "ENTERPRISE_APP",
+  router: router,
+  orgCode: "GREENCLOUD",  // 默认值
+  unitCode: "GREENCLOUD", // 默认值
+  env: "dev"
+});
+```
+
+#### 自定义单位代码配置
+```js
+const i18nInstance = new gc_i18n({
+  appCode: "CUSTOM_UNIT_APP",
+  router: router,
+  orgCode: "CUSTOM_ORG",
+  unitCode: "CUSTOM_UNIT_001",  // 自定义单位代码
+  env: "production"
+});
+```
+
+#### 多租户环境配置
+```js
+const i18nInstance = new gc_i18n({
+  appCode: "MULTI_TENANT_APP",
+  router: router,
+  orgCode: "TENANT_A",
+  unitCode: "UNIT_A_001",  // 租户A的单位代码
+  env: "dev"
+});
+```
+
 ### 环境分离配置示例
 
 #### 本地开发环境
@@ -451,6 +497,6 @@ export default {
 
 **Section sources**
 - [lang/index.js:16-33](file://lang/index.js#L16-L33)
-- [packages/index.js:67-547](file://packages/index.js#L67-L547)
+- [packages/index.js:67-559](file://packages/index.js#L67-L559)
 - [packages/swal.css:1-23](file://packages/swal.css#L1-L23)
 - [packages/libs/textEditMode.css:1-166](file://packages/libs/textEditMode.css#L1-L166)