generator-mico-cli 0.2.29 → 0.2.30

package/README.md

@@ -69,6 +69,7 @@ mico doctor
 ```json
 {
   "projectName": "my-app",
+  "appId": "portal_dev",
   "packageScope": "@my-company",
   "cdnPrefix": "portal",
   "author": "Team <team@example.com>",
@@ -82,6 +83,7 @@ mico doctor
 | 字段 | 类型 | 适用生成器 | 说明 | 默认值 |
 |------|------|-----------|------|--------|
 | `projectName` | string | micro-react | 项目名称 | 当前目录名 |
+| `appId` | string | micro-react | 开发环境 `window.__MICO_CONFIG__.appId`（请求代理等） | `portal_dev` |
 | `packageScope` | string | 所有 | 包作用域（如 `@my-company`） | micro-react: `@<projectName>`；其他: 从根 `package.json` 检测 |
 | `cdnPrefix` | string | micro-react | CDN 路径前缀（如 `portal`、`admin/v2`） | 空字符串 |
 | `author` | string | micro-react | 作者信息 | `Your Name <email@example.com>` |

package/generators/micro-react/index.js

@@ -76,6 +76,18 @@ module.exports = class extends Generator {
             return true;
           },
         },
+        {
+          type: 'input',
+          name: 'appId',
+          message:
+            'App ID（开发环境 window.__MICO_CONFIG__.appId，用于请求代理 / 网关等）',
+          default: rc.appId || 'portal_dev',
+          validate: (input) => {
+            const v = String(input ?? '').trim();
+            if (!v) return 'App ID is required';
+            return true;
+          },
+        },
         {
           type: 'input',
           name: 'packageScope',
@@ -91,7 +103,7 @@ module.exports = class extends Generator {
         {
           type: 'input',
           name: 'cdnPrefix',
-          message: `CDN path prefix (用于区分不同业务线的 CDN 目录)
+          message: `CDN path prefix (用于区分不同业务线的 CDN 目录,一般是运营配置的group名,切记不可乱填)
    示例：CDN 完整路径 = https://cdn.example.com/<prefix>/<projectName>/<version>/
    - 留空: https://cdn.example.com/my-project/1.0.0/
    - 输入 "portal": https://cdn.example.com/portal/my-project/1.0.0/
@@ -119,6 +131,7 @@ module.exports = class extends Generator {
 
       this.projectName = toKebab(this.answers.projectName);
       this.ProjectName = toPascal(this.projectName);
+      this.appId = String(this.answers.appId ?? '').trim();
       this.packageScope = this.answers.packageScope;
       this.cdnPrefix = this.answers.cdnPrefix;
       this.author = this.answers.author;
@@ -173,6 +186,7 @@ module.exports = class extends Generator {
       const templateData = {
         projectName: this.projectName,
         ProjectName: this.ProjectName,
+        appId: this.appId,
         packageScope: this.packageScope,
         author: this.author,
         micoUiVersion: `^${micoUiVer}`,
@@ -204,6 +218,7 @@ module.exports = class extends Generator {
         this.log('\x1b[33m📋 Dry run mode - no files will be created\x1b[0m');
         this.log('');
         this.log(`   Project: ${this.projectName}`);
+        this.log(`   App ID: ${this.appId}`);
         this.log(`   Scope: ${this.packageScope}`);
         this.log(`   Destination: ${this.destDir}`);
         this.log('');
@@ -239,6 +254,7 @@ module.exports = class extends Generator {
 
       this.log('');
       this.log(`📦 Creating project: ${this.projectName}`);
+      this.log(`   App ID: ${this.appId}`);
       this.log(`   Scope: ${this.packageScope}`);
       this.log('');
 

package/generators/micro-react/templates/CICD/start_dev.sh

@@ -14,6 +14,7 @@ PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # 用 node 命令读取 package.json 里的 version 字段
 VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+export VERSION
 # 输出项目版本号
 echo "项目版本: $VERSION"
 
@@ -23,6 +24,16 @@ cd "$PROJECT_ROOT"
 # 导出 PROJECT_ROOT 供 before_build.sh 使用
 export PROJECT_ROOT
 
+# Jenkins 等 CI 注入的构建号（供 Sentry release、layout window.__MICO_BUILD__ 等）
+export BUILD_NUMBER="${BUILD_NUMBER:-}"
+echo "BUILD_NUMBER: ${BUILD_NUMBER:-<unset>}"
+
+export GIT_COMMIT="${GIT_COMMIT:-$(git rev-parse HEAD 2>/dev/null || echo '')}"
+export BRANCH_OR_TAG="${BRANCH_OR_TAG:-${GIT_BRANCH:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')}}"
+export BUILD_TIME="${BUILD_TIME:-$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")}"
+echo "GIT_COMMIT: ${GIT_COMMIT:-<empty>}"
+echo "BRANCH_OR_TAG: ${BRANCH_OR_TAG:-<empty>}"
+
 # 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息
 if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
   # shellcheck disable=SC1090

package/generators/micro-react/templates/CICD/start_local.sh

@@ -14,12 +14,21 @@ PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # 用 node 命令读取 package.json 里的 version 字段
 VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+export VERSION
 # 输出项目版本号
 echo "项目版本: $VERSION"
 
 # 切换到项目根目录，确保后续命令在根目录下运行
 cd "$PROJECT_ROOT"
 
+# Jenkins 等 CI 注入的构建号（供 Sentry release、layout window.__MICO_BUILD__ 等）
+export BUILD_NUMBER="${BUILD_NUMBER:-}"
+echo "BUILD_NUMBER: ${BUILD_NUMBER:-<unset>}"
+
+export GIT_COMMIT="${GIT_COMMIT:-$(git rev-parse HEAD 2>/dev/null || echo '')}"
+export BRANCH_OR_TAG="${BRANCH_OR_TAG:-${GIT_BRANCH:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')}}"
+export BUILD_TIME="${BUILD_TIME:-$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")}"
+
 # 设置子应用的 CDN 公共路径（本地环境使用相对路径）
 export CDN_PUBLIC_PATH="./"
 echo "CDN_PUBLIC_PATH: $CDN_PUBLIC_PATH"

package/generators/micro-react/templates/CICD/start_prod.sh

@@ -14,6 +14,7 @@ PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # 用 node 命令读取 package.json 里的 version 字段
 VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+export VERSION
 # 输出项目版本号
 echo "项目版本: $VERSION"
 
@@ -23,6 +24,18 @@ cd "$PROJECT_ROOT"
 # 导出 PROJECT_ROOT 供 before_build.sh 使用
 export PROJECT_ROOT
 
+# Jenkins 等 CI 注入的构建号（供 Sentry release、layout window.__MICO_BUILD__ 等）
+export BUILD_NUMBER="${BUILD_NUMBER:-}"
+echo "BUILD_NUMBER: ${BUILD_NUMBER:-<unset>}"
+
+# 供 Umi define 注入 window.__MICO_BUILD__（与 package.json 一致；未导出时子进程 process.env.VERSION 为空）
+# Jenkins 常注入 GIT_BRANCH / GIT_COMMIT，BRANCH_OR_TAG 为业务约定名时可由 Job 覆盖
+export GIT_COMMIT="${GIT_COMMIT:-$(git rev-parse HEAD 2>/dev/null || echo '')}"
+export BRANCH_OR_TAG="${BRANCH_OR_TAG:-${GIT_BRANCH:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')}}"
+export BUILD_TIME="${BUILD_TIME:-$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")}"
+echo "GIT_COMMIT: ${GIT_COMMIT:-<empty>}"
+echo "BRANCH_OR_TAG: ${BRANCH_OR_TAG:-<empty>}"
+
 # 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息（用于增量构建）
 if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
   # shellcheck disable=SC1090

package/generators/micro-react/templates/CICD/start_test.sh

@@ -14,6 +14,7 @@ PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # 用 node 命令读取 package.json 里的 version 字段
 VERSION=$(node -p "require('$PROJECT_ROOT/package.json').version")
+export VERSION
 # 输出项目版本号
 echo "项目版本: $VERSION"
 
@@ -23,6 +24,16 @@ cd "$PROJECT_ROOT"
 # 导出 PROJECT_ROOT 供 before_build.sh 使用
 export PROJECT_ROOT
 
+# Jenkins 等 CI 注入的构建号（供 Sentry release、layout window.__MICO_BUILD__ 等）
+export BUILD_NUMBER="${BUILD_NUMBER:-}"
+echo "BUILD_NUMBER: ${BUILD_NUMBER:-<unset>}"
+
+export GIT_COMMIT="${GIT_COMMIT:-$(git rev-parse HEAD 2>/dev/null || echo '')}"
+export BRANCH_OR_TAG="${BRANCH_OR_TAG:-${GIT_BRANCH:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')}}"
+export BUILD_TIME="${BUILD_TIME:-$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")}"
+echo "GIT_COMMIT: ${GIT_COMMIT:-<empty>}"
+echo "BRANCH_OR_TAG: ${BRANCH_OR_TAG:-<empty>}"
+
 # 在执行构建前，计算 BASE_REF / TURBO_FILTER 等增量构建信息
 if [ -f "$PROJECT_ROOT/CICD/before_build.sh" ]; then
   # shellcheck disable=SC1090

package/generators/micro-react/templates/apps/layout/config/config.dev.ts

@@ -19,7 +19,7 @@ const config: ReturnType<typeof defineConfig> = {
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
         window.__MICO_PAGES__ = ${JSON.stringify(mockPages)};
         window.__MICO_CONFIG__ = {
-          appId: '<%= projectName %>',
+          appId: '<%= appId %>',
           appName: '<%= projectName %>',
           title: '测试样例',
           logo: '',
@@ -34,8 +34,14 @@ const config: ReturnType<typeof defineConfig> = {
           // 关闭权限控制（调试用）
           disableAuth: false,
           // SSO 外跳地址（与 resolveExternalLoginPath 读取的 externalLoginPath 一致；生产由注入的 __MICO_CONFIG__ 提供）
-          externalLoginPath:
-            'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
+          externalLoginPath: 'https://micous-idp.cig.tencentcs.com/sso/tn-456d1d3feb5f4e09ad28ab35ee4d2e66/ai-138064426b9e43818098705df5400eef/cas',
+          // 多语言中台（可选）：intl 与 common-intl 包 initIntl 合并；见 packages/common-intl/README.md
+          // 这里只是一个例子，需要根据业务在翻译中台的配置来替换
+          // intl: {
+          //   tag: 'cs_fe_pc',
+          //   app_name: 'middle',
+          //   indexedDBParams: { dbName: 'mico_cs_pc_i18n_db' },
+          // },
         };
       `,
     },

package/generators/micro-react/templates/apps/layout/config/config.prod.development.ts

@@ -1,8 +1,13 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
 // 开发环境，不上传 sourcemap。调试时如有需要再解开
 // import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
+const packageVersion: string = JSON.parse(
+  readFileSync(join(__dirname, '../../../package.json'), 'utf-8'),
+).version;
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
@@ -33,6 +38,11 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
+    'process.env.BUILD_NUMBER': process.env.BUILD_NUMBER ?? '',
+    'process.env.BRANCH_OR_TAG': process.env.BRANCH_OR_TAG ?? '',
+    'process.env.GIT_COMMIT': process.env.GIT_COMMIT ?? '',
+    'process.env.VERSION': process.env.VERSION ?? packageVersion,
+    'process.env.BUILD_TIME': process.env.BUILD_TIME ?? '',
     'process.env.LOCALE_REQUEST_URL':
       'https://api-test.micoplatform.com/lang_server/pull',
   },

package/generators/micro-react/templates/apps/layout/config/config.prod.testing.ts

@@ -1,8 +1,13 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
 // 测试环境，不上传 sourcemap。调试时如有需要再解开
 // import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
+const packageVersion: string = JSON.parse(
+  readFileSync(join(__dirname, '../../../package.json'), 'utf-8'),
+).version;
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
@@ -33,6 +38,11 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
+    'process.env.BUILD_NUMBER': process.env.BUILD_NUMBER ?? '',
+    'process.env.BRANCH_OR_TAG': process.env.BRANCH_OR_TAG ?? '',
+    'process.env.GIT_COMMIT': process.env.GIT_COMMIT ?? '',
+    'process.env.VERSION': process.env.VERSION ?? packageVersion,
+    'process.env.BUILD_TIME': process.env.BUILD_TIME ?? '',
     'process.env.LOCALE_REQUEST_URL':
       'https://api-test.micoplatform.com/lang_server/pull',
   },

package/generators/micro-react/templates/apps/layout/config/config.prod.ts

@@ -1,7 +1,14 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
 import { applySentryPlugin } from '../../../scripts/apply-sentry-plugin';
+
+const packageVersion: string = JSON.parse(
+  readFileSync(join(__dirname, '../../../package.json'), 'utf-8'),
+).version;
+
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
@@ -21,6 +28,11 @@ const config: ReturnType<typeof defineConfig> = {
       'https://dashboard-api.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api.micoplatform.com/api/yufu_login/refresh/',
+    'process.env.BUILD_NUMBER': process.env.BUILD_NUMBER ?? '',
+    'process.env.BRANCH_OR_TAG': process.env.BRANCH_OR_TAG ?? '',
+    'process.env.GIT_COMMIT': process.env.GIT_COMMIT ?? '',
+    'process.env.VERSION': process.env.VERSION ?? packageVersion,
+    'process.env.BUILD_TIME': process.env.BUILD_TIME ?? '',
     'process.env.LOCALE_REQUEST_URL':
       'https://api.micoplatform.com/lang_server/pull',
   },

package/generators/micro-react/templates/apps/layout/docs/feature-/345/233/275/351/231/205/345/214/226.md

@@ -0,0 +1,121 @@
+# 国际化（common-intl 与 Umi 兜底）
+
+> 创建时间：2026-04-07
+
+## 功能概述
+
+layout 主应用通过 **`<%= packageScope %>/common-intl`**（`packages/common-intl` 中转包）绑定中台 **`tag`**，在 **`app.tsx`** 中 **`configureLocale`** 与 Umi **`umi_locale`** 对齐；当 **`window.__MICO_CONFIG__.intl` 或 `commonIntl`** 含有效 **`tag`、`app_name`** 时视为启用中台，首屏在 **`render`** 中 **`fetchMultilingualData`**。业务侧统一使用 **`useLayoutIntl()`**：**`i18n` 优先**，与 `defaultMessage` 比较后未命中则 **Umi `formatMessage`**（`src/locales/*`）。未启用中台时 **仅 Umi**。
+
+## 技术方案
+
+### 技术栈
+
+- Umi 4 `@umijs/max`：`locale` 运行时、`export const locale`、`useIntl`
+- `<%= packageScope %>/common-intl`：`configureLocale`、`fetchMultilingualData`、`i18n`、`intl`（包内 `initIntl`）
+- 门控与类型：`src/common/intl/intlRuntime.ts`、`types.ts`
+
+### 核心实现
+
+1. **`app.tsx`**：最早 **`configureLocale({ getLocale, setLocale })`**，与 **`getCurrentLocale`** / **`setLocaleToStorage`**（`src/common/locale.ts`）及 **`localeMapping`** 一致；**`export const locale`** 供 Umi 插件；**`render`** 仅在 **`isCommonIntlEnabled()`** 为真时调用 **`fetchMultilingualData`**（`request`、`Message`、`lang`、`LOCALE_REQUEST_URL`）。
+2. **`useLayoutIntl.ts`**：读取 **`isCommonIntlEnabled()`**；启用时 **`i18n({ key, defaultMessage })`**，否则直接 **`useIntl().formatMessage`**；兜底规则与 **`defaultMessage`**、Umi 结果比较（同子应用 **`useSubappIntl`** 策略）。
+3. **全局暴露**：**`window.CommonIntl`** 指向包模块，供子应用 **externals** 复用。
+4. **包内实现**：**`packages/common-intl/src/intl.ts`** 中 **`initIntl`** 合并 **`__MICO_CONFIG__`** 与默认 tag，详见包 README。
+
+## 文件清单（相对 `apps/layout`）
+
+| 文件路径 | 说明 |
+| --- | --- |
+| `src/common/intl/useLayoutIntl.ts` | 页面统一 Hook |
+| `src/common/intl/intlRuntime.ts` | `isCommonIntlEnabled`、`getCommonIntlConfig` |
+| `src/common/intl/localeMapping.ts` | Umi locale ↔ `ILang` |
+| `src/common/intl/types.ts` | `IMicoConfigCommonIntl` |
+| `src/common/intl/index.ts` | 导出 `useLayoutIntl`、`intl`、`isCommonIntlEnabled` 等 |
+| `src/common/locale.ts` | URL / storage / 浏览器语言（与 Umi 一致） |
+| `src/app.tsx` | `configureLocale`、`locale`、`render`、**`window.CommonIntl`** |
+| `config/config.ts` | `locale` 插件（`default`、`antd: false`、`baseNavigator: false`） |
+| `src/locales/zh-CN.ts`、`en-US.ts` | Umi 兜底文案 |
+| `src/pages/Home/index.tsx` | 国际化用法示例（可选参考） |
+
+## API / 组件接口
+
+### `useLayoutIntl`
+
+```typescript
+const {
+  formatMessage,       // 与 useIntl 相同 descriptor / values 签名
+  commonIntlEnabled,   // 是否启用中台（有效 tag + app_name）
+  locale,              // 当前 Umi 风格 locale（getCurrentLocale）
+  intl,                // 包内便捷对象，仅 commonIntlEnabled 为 true 时非 undefined
+} = useLayoutIntl();
+```
+
+### `window.__MICO_CONFIG__.intl` / `commonIntl`
+
+二者取其一（见 `intlRuntime`），字段含义一致：
+
+| 字段 | 说明 |
+| --- | --- |
+| `tag` | 多语言中台 tag（必填） |
+| `app_name` | 中台应用名（必填） |
+| `indexedDBParams` | 可选本地缓存参数 |
+
+## 使用示例
+
+**运行时注入（示例）：**
+
+```javascript
+window.__MICO_CONFIG__ = {
+  commonIntl: {
+    tag: 'cs_fe_pc',
+    app_name: 'middle',
+    indexedDBParams: { dbName: 'mico_cs_web_i18n_db' },
+  },
+};
+```
+
+**页面：**
+
+```tsx
+import { useLayoutIntl } from '@/common/intl';
+
+const { formatMessage, commonIntlEnabled, locale } = useLayoutIntl();
+
+return (
+  <span>
+    {formatMessage({ id: 'page.home.title', defaultMessage: '首页' })}
+  </span>
+);
+```
+
+**包内预置文案（中台 key 亦可走 `i18n`）：**
+
+```tsx
+import { intl } from '@/common/intl';
+
+intl.common_hello();
+```
+
+## 设计决策
+
+| 决策点 | 选择 | 理由 |
+| --- | --- | --- |
+| 门控 | `intl` 与 `commonIntl` 字段兼容 | 与注入脚本、历史配置一致 |
+| 首屏拉取 | 仅 `isCommonIntlEnabled()` 时 `render` 内 fetch | 未配置中台时不阻塞首屏 |
+| 合并策略 | `i18n` 与 Umi 二选一兜底 | 与微前端子应用 `useSubappIntl` 对齐，便于维护 |
+
+## 已知限制与待改进
+
+- **`LOCALE_REQUEST_URL`** 未配置时，行为依赖上游 **`fetchMultilingualData`** 实现。
+- 中台文案与 **`src/locales`** 的 key 需自行约定，避免重复 id 语义冲突。
+
+## 注意事项
+
+- 修改语言时请走与 **`getCurrentLocale`** / **`setLocaleToStorage`** 一致的入口，避免与 **`configureLocale`** 脱节。
+- 子应用不复制上述 **`render`** 逻辑时，嵌入主应用后通常仍依赖主应用已加载的 **`CommonIntl`**；独立运行子应用需自行 **`render` + fetch**（见子应用模板文档）。
+
+## 相关文档
+
+- [packages/common-intl README](../../../../packages/common-intl/README.md)
+- [Layout 国际化（CLI 仓库总览）](../../../../../../docs/feat-layout-国际化翻译.md)
+- [子应用国际化（模板内说明）](../../../../../subapp-react/templates/homepage/docs/feature-国际化.md)
+- [微前端模式](./feature-微前端模式.md)（主应用暴露 `CommonIntl`）

package/generators/micro-react/templates/apps/layout/docs/feature-/345/276/256/345/211/215/347/253/257/346/250/241/345/274/217.md

@@ -136,6 +136,14 @@ interface MicroAppProps {
 
 **说明**：子应用在 `mount` 生命周期中通过 `props` 接收这些数据。
 
+### 国际化（common-intl）
+
+- **共享文案（默认）**：主应用在 `render` 中拉取中台后，子应用 `import { intl } from '<%= packageScope %>/common-intl'` 即可（与主应用同一默认 tag），详见 `packages/common-intl/README.md`。
+- **不同 tag**：上游支持多次 `initIntl`，子应用可对同一依赖再绑定一套 tag 并在子应用 `render` 中拉取；或直连 `@common-web/common-intl`，见 README「不同 tag」。
+- **可选模板层**：若子应用需 `formatMessage` 式 API 与 Umi 兜底，见仓库 `docs/feat-subapp-国际化翻译.md`（生成项目根目录文档以实际为准）。
+
+主应用 **不向** 子应用 props 传递 `commonIntl`；子应用 **locale** 以 props 与主应用对齐（见上表 `locale`）。
+
 ### 子应用 Props 更新机制
 
 主应用通过 qiankun 的 `update()` 方法实时通知子应用状态变化，无需重新加载：

package/generators/micro-react/templates/apps/layout/mock/menus.ts

@@ -116,6 +116,20 @@ const mockMenus: MockMenuItem[] = [
     adminOnly: true,
     children: [],
   },
+  {
+    id: 9,
+    name: '小组管理',
+    nameEn: 'Group Management',
+    nameKey: 'cs_web_menu_group_management',
+    type: 'page',
+    path: '/group-management',
+    icon: 'Group',
+    enabled: true,
+    sortOrder: 4,
+    pageId: 125,
+    adminOnly: true,
+    children: [],
+  }
 ];
 
 export default mockMenus;

package/generators/micro-react/templates/apps/layout/mock/pages.ts

@@ -31,7 +31,7 @@ const mockPages: PublicPageItem[] = [
     // htmlUrl:
     //   'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.2/login/index.html',
     htmlUrl:
-      'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/login/index.html',
+      'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.9/login/index.html',
     jsUrls: [],
     cssUrls: [],
     prefixPath: '/user',
@@ -51,7 +51,27 @@ const mockPages: PublicPageItem[] = [
     // htmlUrl:
     //   'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.3/permission/index.html',
     htmlUrl:
-      'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/permission/index.html',
+      'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.9/permission/index.html',
+    jsUrls: [],
+    cssUrls: [],
+    prefixPath: '',
+    routeMode: 'prefix',
+    enabled: true,
+    accessControlEnabled: true,
+    adminOnly: true,
+    routeKey: null,
+    mainDocumentId: 59,
+    version: 'v2026.02.26-04.13-419',
+  },
+  {
+    id: 125,
+    name: '小组管理',
+    route: '/group-management',
+    base: '/',
+    // htmlUrl:
+    //   'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.3/permission/index.html',
+    htmlUrl:
+      'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.9/group-management/index.html',
     jsUrls: [],
     cssUrls: [],
     prefixPath: '',

package/generators/micro-react/templates/apps/layout/package.json

@@ -22,6 +22,8 @@
     "test": "cross-env UMI_ENV=test max dev"
   },
   "dependencies": {
+    "<%= packageScope %>/common-intl": "workspace:*",
+    "<%= packageScope %>/shared": "workspace:*",
     "@mico-platform/ui": "<%= micoUiVersion %>",
     "@mico-platform/theme": "<%= themeVersion %>",
     "@umijs/max": "^4.6.15",
@@ -29,8 +31,7 @@
     "qiankun": "^2.10.16",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "spark-md5": "^3.0.2",
-    "<%= packageScope %>/common-intl": "workspace:*"
+    "spark-md5": "^3.0.2"
   },
   "devDependencies": {
     "@types/react": "^18.0.33",

package/generators/micro-react/templates/apps/layout/src/app.tsx

@@ -1,16 +1,24 @@
 import { history, type RequestConfig } from '@umijs/max';
 import { addGlobalUncaughtErrorHandler } from 'qiankun';
+import * as CommonWebSentry from '@common-web/sentry';
 import { SentryErrorBoundary } from '@common-web/sentry';
 import { errorConfig } from './requestErrorConfig';
 // 将 @mico-platform/ui 暴露到 window，供子应用 externals 使用
 import * as micoUI from '@mico-platform/ui';
+import dayjs from 'dayjs';
 import React from 'react';
 import ReactDOM from 'react-dom';
 
+import customParseFormat from 'dayjs/plugin/customParseFormat';
+import dayjsTimezone from 'dayjs/plugin/timezone';
+import dayjsUtc from 'dayjs/plugin/utc';
 import { request as commonRequest } from './common/request';
+import { configureRequest } from '<%= packageScope %>/shared/services';
+import { configureTimezone } from '<%= packageScope %>/shared/timezone';
+import { getTimezone } from '@/common/helpers';
 import {
+  configureLocale,
   fetchMultilingualData,
-  getCurrentLocale as getIntlLocale,
   type ILang,
 } from '<%= packageScope %>/common-intl';
 import * as CommonIntl from '<%= packageScope %>/common-intl';
@@ -30,10 +38,32 @@ import {
 } from './common/request/sso';
 import { initTheme } from './common/theme';
 import MicroAppLoader from './components/MicroAppLoader';
+import { isCommonIntlEnabled } from '@/common/intl';
 import { isNoAuthRoute } from '@/constants';
-import { getCurrentLocale } from '@/common/locale';
 import '@mico-platform/theme/dist/css/theme.css';
 import './global.less';
+import { getCurrentLocale, setLocaleToStorage } from './common/locale';
+import { ilangToUmiLocale, umiLocaleToILang } from '@/common/intl/localeMapping';
+
+// 主应用：将统一 request 注入 shared 包，供共享服务层（getRequest）使用
+// 注意：模块顶层注入，确保任何业务调用 getRequest() 之前已就绪
+configureRequest(commonRequest as <T = unknown>(url: string, options?: Record<string, unknown>) => Promise<T>);
+
+// 主应用：扩展 dayjs 插件并注入「当前 IANA 时区」获取器，供 shared/timezone 使用
+// 说明：apps/layout/src/common/helpers.ts 已扩展 utc/timezone，此处再补 customParseFormat（shared/timezone 的 parseDateInTimezone 需要它）
+// dayjs.extend 内部去重，重复调用安全
+dayjs.extend(dayjsUtc);
+dayjs.extend(dayjsTimezone);
+dayjs.extend(customParseFormat);
+configureTimezone({ getTimezone });
+
+// 主应用：common-intl initIntl 的 getLocale/setLocale 与 Umi `umi_locale` 单一数据源对齐（见 packages/common-intl configureLocale）
+configureLocale({
+  getLocale: () => umiLocaleToILang(getCurrentLocale()),
+  setLocale: (lang: ILang) => {
+    setLocaleToStorage(ilangToUmiLocale(lang));
+  },
+});
 
 // ==================== qiankun 全局错误处理 ====================
 // 捕获子应用运行时未捕获的异常，防止页面崩溃
@@ -87,15 +117,31 @@ if (typeof window !== 'undefined') {
     // 注意：这里不阻止错误冒泡，让控制台仍能显示原始错误
     // 如果需要阻止，可以 return true
   });
+
+  // 注入构建信息
+  if (typeof window !== 'undefined') {
+    window.__MICO_BUILD__ = {
+      branchOrTag: process.env.BRANCH_OR_TAG,
+      gitCommit: process.env.GIT_COMMIT,
+      version: process.env.VERSION,
+      buildTime: dayjs(process.env.BUILD_TIME).format('YYYY-MM-DD HH:mm:ss'),
+      buildNumber: process.env.BUILD_NUMBER,
+    };
+  }
 }
 
 // ==================== 微前端共享依赖 ====================
 // 将公共库暴露到 window，供子应用复用，避免重复打包
 // 子应用通过 externals 配置引用这些全局变量
-if (typeof window !== 'undefined') {
+if (typeof window !== 'undefined' && process.env.NODE_ENV === 'development') {
   const win = window as unknown as Record<string, unknown>;
   win.React = React;
   win.ReactDOM = ReactDOM;
+  win.CommonWebSentry = CommonWebSentry;
+}
+
+if (typeof window !== 'undefined') {
+  const win = window as unknown as Record<string, unknown>;
   win.micoUI = micoUI;
   win.CommonIntl = CommonIntl;
 }
@@ -117,15 +163,22 @@ export const locale = {
 
 // ==================== 国际化数据预加载 ====================
 
-/** @see https://umijs.org/docs/api/runtime-config#render */
+/**
+ * 配置了有效 `__MICO_CONFIG__.commonIntl` 时首屏拉取中台文案；失败仍继续渲染。
+ * @see generators/micro-react/templates/packages/common-intl/README.md
+ */
 export function render(oldRender: () => void): void {
+  if (!isCommonIntlEnabled()) {
+    oldRender();
+    return;
+  }
   fetchMultilingualData({
     requestInstance: commonRequest,
     messageInstance: {
       error: micoUI.Message.error,
       warning: micoUI.Message.warning,
     },
-    lang: getIntlLocale() as ILang,
+    lang: umiLocaleToILang(getCurrentLocale()) as ILang,
     localeRequestUrl: process.env.LOCALE_REQUEST_URL,
   })
     .then(oldRender)

package/generators/micro-react/templates/apps/layout/src/common/auth/index.ts

@@ -2,12 +2,15 @@ import { authLogger } from '@/common/logger';
 import { checkStaffAuth } from '@/services/auth';
 import { handleAuthFailureRedirect } from '../request';
 import { clearStoredTokens, getAuthInfo } from './auth-manager';
+import { clearStoredTenantCode } from './tenant';
 
 // 导出 STORAGE_KEYS 常量
 export { STORAGE_KEYS } from '../../constants';
 
 export function logout(): void {
   clearStoredTokens();
+  // 清理当前租户，避免切换账号后残留
+  clearStoredTenantCode();
 }
 
 /**

package/generators/micro-react/templates/apps/layout/src/common/auth/tenant.ts

@@ -0,0 +1,25 @@
+import { getFromStorage, removeStorage, setStorage } from '@/common/helpers';
+import { STORAGE_KEYS } from '@/constants';
+
+/**
+ * 当前租户 code 存储工具
+ *
+ * 多租户模式下，当前选中的租户会被持久化到 localStorage，
+ * 在调用 `fetchUserInfo` 时作为 `tenant` 参数传给后端，
+ * 以获取对应租户的 menu_perms / button_perms / region_perms。
+ */
+
+export const getStoredTenantCode = (): string | null => {
+  return getFromStorage(STORAGE_KEYS.CURRENT_TENANT);
+};
+
+export const setStoredTenantCode = (code: string): void => {
+  if (!code) {
+    return;
+  }
+  setStorage(STORAGE_KEYS.CURRENT_TENANT, code);
+};
+
+export const clearStoredTenantCode = (): void => {
+  removeStorage(STORAGE_KEYS.CURRENT_TENANT);
+};