generator-mico-cli 0.2.28 → 0.2.30

package/generators/micro-react/templates/apps/layout/docs/feature-/350/267/257/347/224/261/344/270/216/350/217/234/345/215/225/350/247/243/350/200/246.md

@@ -1,10 +1,10 @@
 # 路由与菜单解耦
 
-> 创建时间：2026-02-25
+> 创建时间：2026-02-25 更新时间：2026-03-27
 
 ## 功能概述
 
-将动态路由注册与菜单导航的数据源解耦。路由注册消费 `window.__MICO_PAGES__`（页面列表），菜单栏消费 `window.__MICO_MENUS__`（菜单树）。两者独立运作，权限通过菜单交叉引用 + 页面级兜底的双层策略控制。
+将动态路由注册与菜单导航的数据源解耦。路由注册消费 `window.__MICO_PAGES__`（页面列表），菜单栏消费 `window.__MICO_MENUS__`（菜单树）。两者独立运作，**路由与侧栏权限**统一以用户信息中的 **`menu_perms`（菜单 code 列表）** 为准，与页面 **`routeKey`**、菜单项权限 code **一一对应**；无页面元数据时仍可按「菜单中是否可见」兜底。
 
 ## 技术方案
 
@@ -22,9 +22,20 @@ __MICO_PAGES__ (扁平列表，所有页面)
   └── 隐藏页面（不在菜单中显示，但路由可访问）
 
 __MICO_MENUS__ (菜单树，用于导航)
-  └── page 字段 → 引用 __MICO_PAGES__ 中的某个页面
+  └── `page` 类型项通过 pageId / path 关联到 __MICO_PAGES__（见下方「菜单项关联页面」）
 ```
 
+### 菜单项关联页面（`getMenuPage`）
+
+侧栏过滤、从菜单树提取路由（`extractRoutes`）、`routeKey` / `menu_perms` 等需要「菜单项 → 页面配置」时，统一由 `src/common/portal-data.ts` 的 **`getMenuPage(item)`** 解析：
+
+| 顺序 | 规则 | 说明 |
+| --- | --- | --- |
+| 1 | **`pageId` → `getPageById`** | 菜单项带 `pageId` 且在 `__MICO_PAGES__` 中存在对应 `id` 时，**优先使用该页面** |
+| 2 | **`path` + `findPageByPath`** | 上一步无结果时（无 `pageId`、或 id 在列表中不存在），用菜单 **`path`** 与页面 **`route`** 匹配（精确 + 最长前缀 `/*`），与路由侧解析规则一致 |
+
+仅 `type === 'page'` 的菜单项会走上述逻辑；`findPageByPath` 仅匹配 **`enabled === true`** 的页面。
+
 ### 数据流
 
 ```
@@ -35,7 +46,7 @@ Before:
 
 After:
   patchClientRoutes  ← getDynamicRoutes() → PAGES 优先，降级 MENUS
-  layouts 权限校验    ← getDynamicRoutes() + extractRoutes(MENUS) + filterMenuItems(MENUS)
+  layouts 权限校验    ← PAGES 上 routeKey ∈ menu_perms；无 page 时 allowedMenuRoutes 兜底
   菜单渲染           ← parseMenuItems(MENUS)  ← 不变
 ```
 
@@ -53,26 +64,22 @@ page.accessControlEnabled === false？
     ├── 是 → 跳过 SSO 认证 + 跳过权限校验（公开页面）
     │
     ▼
-非动态路由（不在 PAGES 中）？
+非动态路由（currentRoute 不在 PAGES 动态列表中）？
     ├── 是 → 交给 Umi 处理（404 等）
     │
     ▼
-┌─────────────────────────────────────────────┐
-│  Tier 1: 菜单权限交叉引用                    │
-│  页面在 __MICO_MENUS__ 中？                   │
-│    ├── 是 → 沿用 sideMenus 白名单逻辑        │
-│    │        在 allowedMenuRoutes 中？          │
-│    │        ├── 是 → 放行                     │
-│    │        └── 否 → 403                      │
-│    └── 否 → 进入 Tier 2                       │
-├─────────────────────────────────────────────┤
-│  Tier 2: 隐藏页面级权限                       │
-│  （仅 PAGES 数据可用时生效）                   │
-│  adminOnly: true        → 403                │
-│  accessControlEnabled: true                  │
-│    → routeKey ∈ sideMenus ? 放行 : 403       │
-│  其他                    → 放行               │
-└─────────────────────────────────────────────┘
+能解析到 PAGES 中的页面配置？
+    ├── 是 → adminOnly → 403
+    │        accessControlEnabled && routeKey
+    │          → routeKey ∈ menu_perms ? 放行 : 403
+    │        其他 → 放行
+    │
+    ▼
+路径仅在菜单路由中出现（无 page 元数据）？
+    ├── 是 → 在 filterMenuItems(menu_perms) 后的 allowedMenuRoutes 中？
+    │        ├── 是 → 放行
+    │        └── 否 → 403
+    └── 否 → 放行（非本逻辑覆盖）
 ```
 
 ### 降级策略
@@ -93,9 +100,10 @@ getDynamicRoutes():
 | 文件路径 | 修改内容 |
 | --- | --- |
 | `src/common/menu/types.ts` | `PageConfig` 新增 `accessControlEnabled`、`routeKey` 字段；新增 `PublicPageItem` 类型（`Omit<PageConfig, ...>`）；Window 声明新增 `__MICO_PAGES__` |
-| `src/common/menu/parser.ts` | 新增 `getWindowPages`、`hasWindowPages`、`extractRoutesFromPages`、`getDynamicRoutes`、`findPageByPath` 函数；导出 `isSuperuserUser` |
+| `src/common/portal-data.ts` | `findPageByPath`、`getMenuPage`（pageId 优先，其次 path 匹配页面 route） |
+| `src/common/menu/parser.ts` | `extractRoutesFromPages`、`getDynamicRoutes`；从 portal-data 再导出 `findPageByPath`；菜单过滤与 `extractRoutes` 消费 `getMenuPage` |
 | `src/app.tsx` | `patchClientRoutes` 改为调用 `getDynamicRoutes()` |
-| `src/layouts/index.tsx` | 路由匹配改用 `allPageRoutes`；权限判断改为双层逻辑（菜单交叉引用 + 隐藏页面级兜底） |
+| `src/layouts/index.tsx` | 路由匹配 `allPageRoutes`；权限以 `menu_perms` + `routeKey` 为主，无 page 时菜单路由兜底 |
 
 ### 未修改文件
 
@@ -119,16 +127,19 @@ type PublicPageItem = Omit<
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
 | `accessControlEnabled` | `boolean` | 是否开启访问控制。`false` 时跳过 SSO 认证和权限校验（公开页面）；`true` 时需要登录且通过 `routeKey` 校验权限 |
-| `routeKey` | `string \| null` | 路由权限标识（用于匹配 sideMenus） |
+| `routeKey` | `string \| null` | 路由权限标识，与用户信息 `menu_perms`、菜单项权限 code 一致 |
 
-### 页面数据函数
+### 页面数据函数（`portal-data.ts` / `parser.ts`）
 
 ```typescript
 /** 获取 window.__MICO_PAGES__ */
-function getWindowPages(): PublicPageItem[];
+function getPages(): PublicPageItem[];
 
 /** 判断页面数据是否可用 */
-function hasWindowPages(): boolean;
+function hasPages(): boolean;
+
+/** 菜单项 → 关联页面：pageId 优先，无匹配再用 path 与页面 route 匹配 */
+function getMenuPage(item: MenuItem): PublicPageItem | undefined;
 
 /** 从页面数据提取路由配置 */
 function extractRoutesFromPages(pages: PublicPageItem[]): ParsedRoute[];
@@ -136,8 +147,11 @@ function extractRoutesFromPages(pages: PublicPageItem[]): ParsedRoute[];
 /** 获取动态路由（PAGES 优先，降级 MENUS） */
 function getDynamicRoutes(): ParsedRoute[];
 
-/** 根据路径查找页面配置（精确匹配 + 通配符） */
-function findPageByPath(pages: PublicPageItem[], pathname: string): PublicPageItem | undefined;
+/** 根据路径查找页面配置（精确匹配 + 最长前缀 `/*`） */
+function findPageByPath(
+  pages: PublicPageItem[],
+  pathname: string,
+): PublicPageItem | undefined;
 ```
 
 ### Window 全局变量
@@ -156,24 +170,25 @@ interface Window {
 | 决策点 | 选择 | 理由 |
 | --- | --- | --- |
 | 路由数据源 | `__MICO_PAGES__` 独立于菜单 | 页面和菜单是不同维度：页面定义"有什么路由"，菜单定义"导航怎么组织"；解耦后支持隐藏页面 |
-| 权限方案 | 菜单交叉引用 + 页面级兜底 | 菜单中的页面复用现有 sideMenus 白名单逻辑，改动最小；隐藏页面用 adminOnly + accessControlEnabled 兜底 |
+| 权限方案 | `menu_perms` + `routeKey` | 与后端新用户信息接口一致；菜单项 code 与 `menu_perms` 一一对应 |
 | 降级策略 | `getDynamicRoutes()` 自动降级 | `__MICO_PAGES__` 未注入时回退到旧行为，零配置向后兼容 |
 | PublicPageItem 定义 | `Omit<PageConfig, ...>` 派生 | 保持与 PageConfig 的类型继承关系，避免字段重复定义和类型漂移 |
 | accessControlEnabled 语义 | `false` = 公开页面（跳过认证+授权），`true` = 需要权限检查 | 一个字段统一控制 SSO 认证、权限校验、子应用加载等待，减少配置冗余 |
 | 隐藏页面权限 | 先 adminOnly 再 accessControlEnabled | adminOnly 是硬拦截，accessControlEnabled + routeKey 提供用户级粒度控制 |
+| 菜单 → 页面解析 | `pageId` 优先，再 `path` | 中台以 id 为准；路径匹配用于无 id 或 id 失效时的兜底，与 `findPageByPath` 一致 |
 
 ## 已知限制与待改进
 
-- `routeKey` 当前复用 `sideMenus` 做权限匹配，后续可能独立为专门的权限字段
-- 隐藏页面的权限控制依赖 `routeKey` 存在于 `sideMenus` 中，需要后端在下发用户权限时包含隐藏页面的 `routeKey`
+- 用户信息接口为 **`GET /user/info/`**（OpenAPI 8），与旧 `/api/user/info` 非同一后端；`fetchUserInfo` 已切换
+- 外链类型菜单项需配置 `nameKey` 作为权限 code，否则无法匹配 `menu_perms`
 
 ## 注意事项
 
 - `__MICO_PAGES__` 只包含用户在后台配置的微应用页面，404/403 等静态页面不在其中
-- `__MICO_MENUS__` 中菜单项的 `page` 字段引用的是 `__MICO_PAGES__` 中的某个页面
-- 调试时可在控制台搜索 `isForbidden (menu check)` 或 `isForbidden (hidden page` 查看权限判断日志
+- `__MICO_MENUS__` 中 `page` 类型项通过 **`pageId`**（优先）或 **`path` 与页面 `route` 匹配** 关联到 `__MICO_PAGES__` 中的页面配置
+- 调试时可在控制台过滤 `routePermission` 查看结构化权限日志（详见 [路由权限日志](./feature-路由权限日志.md)）
 
 ## 相关文档
 
 - [微前端模式](./feature-微前端模式.md) - 微应用加载机制
-- [菜单权限控制](./feature-菜单权限控制.md) - sideMenus 白名单权限逻辑
+- [菜单权限控制](./feature-菜单权限控制.md) - `menu_perms` 与菜单过滤

package/generators/micro-react/templates/apps/layout/docs/feature-/350/267/257/347/224/261/346/235/203/351/231/220/346/227/245/345/277/227.md

@@ -0,0 +1,162 @@
+# 路由权限日志
+
+> 创建时间：2026-03-27
+
+## 功能概述
+
+在 layout 中输出两类结构化开发日志，便于本地排查权限问题：
+
+1. **`routePermission`**：`BasicLayout` 中 **`isForbidden` 路由权限判定**（为何放行 / 为何 403）。
+2. **`menuFilter`**：`filterMenuItems` 中**被隐藏的菜单项**及**隐藏原因**（侧栏不可见条目）。
+
+日志均经 `layoutLogger` 输出，**仅开发环境生效**，生产构建无控制台输出。
+
+## 技术方案
+
+### 技术栈
+
+- 框架：React 18 + @umijs/max
+- 日志：`apps/layout/src/common/logger.ts` 的 `layoutLogger`（`NODE_ENV === 'development'` 时 `console.log`）
+
+### 核心实现
+
+1. 在 `BasicLayout` 的 `useMemo`（`isForbidden`）中，于各分支返回前调用 `layoutLogger.log('routePermission', payload)`。
+2. 统一使用 **`routePermission`** 作为首参，便于控制台过滤；`payload` 为结构化对象，包含 `verdict`、`reason`、`branch`（部分分支）及路径、页面上下文。
+3. **不记录**「无动态路由 `currentRoute`」与「无页面元数据且未命中菜单兜底」的常见放行路径，避免刷屏。
+4. 在 `parser.ts` 的 `filterMenuItems` 中，于菜单项被剔除时输出 **`menuFilter`**；**关闭权限**或**超级用户**时不打菜单隐藏日志（此时无实质过滤）。
+
+## 文件清单
+
+### 修改文件
+
+| 文件路径 | 说明 |
+|----------|------|
+| `apps/layout/src/layouts/index.tsx` | `isForbidden` 内各关键分支的 `routePermission` 日志 |
+| `apps/layout/src/common/menu/parser.ts` | `getMenuItemFilterOutcome`、`filterMenuItems` 内 `menuFilter` 隐藏日志 |
+
+## 日志字段说明
+
+### 通用字段
+
+| 字段 | 说明 |
+|------|------|
+| `verdict` | `skip`：跳过权限校验；`allow`：允许访问；`deny`：403 |
+| `reason` | 见下表 |
+| `pathname` | 当前 `location.pathname` |
+| `routePath` | 匹配到的动态路由 `currentRoute.path`（有 `currentRoute` 时） |
+| `userId` | `currentUser.id` |
+| `isSuperuser` | 是否超管 |
+| `menuPermsCount` | `menu_perms` 长度 |
+
+### `reason` 取值
+
+| reason | verdict | 含义 |
+|--------|---------|------|
+| `disableAuth` | skip | `__MICO_CONFIG__.disableAuth` 等效关闭权限 |
+| `noPermissionRoute` | skip | 命中免权限路由列表 |
+| `superuser` | skip | 超级用户不校验 |
+| `adminOnly` | deny | 页面 `adminOnly`，非超管 |
+| `publicPage` | allow | `accessControlEnabled === false` |
+| `accessControlNoRouteKey` | allow | 已开启访问控制但未配置 `routeKey`，不做 `menu_perms` 校验（与侧栏 `isMenuPageRequiringPermCode` 一致） |
+| `routeKeyNotInMenuPerms` | deny | `routeKey` 不在 `menu_perms` |
+| `routeKeyInMenuPerms` | allow | `routeKey` 在 `menu_perms` |
+| `notInFilteredMenuRoutes` | deny | 菜单兜底分支：过滤后路由不包含当前路径 |
+| `inFilteredMenuRoutes` | allow | 菜单兜底分支：过滤后仍包含 |
+
+### 分支字段 `branch`
+
+| branch | 含义 |
+|--------|------|
+| `pageMeta` | 已解析到 `__MICO_PAGES__` 页面配置时的 `routeKey` / `menu_perms` 判定 |
+| `menuRouteFallback` | 无页面元数据时，用「全量菜单路由 vs `filterMenuItems` 后菜单路由」比对 |
+
+### 页面元数据分支额外字段
+
+| 字段 | 说明 |
+|------|------|
+| `pageId` | 页面配置 id |
+| `routeKey` | 页面 `routeKey` |
+| `keyInMenuPerms` | `routeKey` 是否在 `menu_perms` 中（仅当需校验 `routeKey` 时输出） |
+
+### 菜单兜底分支额外字段
+
+| 字段 | 说明 |
+|------|------|
+| `inAllowed` | 当前路径是否在过滤后的允许菜单路由中 |
+
+---
+
+## 菜单过滤日志 `menuFilter`
+
+### 通用字段
+
+| 字段 | 说明 |
+|------|------|
+| `verdict` | 固定 `hidden` |
+| `reason` | 见下表 |
+| `menuId` | 菜单项 `id` |
+| `menuType` | `group` / `page` / `link` |
+| `name` | 菜单展示名（配置中的 `name`） |
+| `nameKey` | 菜单 `nameKey`（若有） |
+| `permCode` | `getMenuItemPermCode` 解析出的权限 code（可能为 `null`） |
+| `menuPermsCount` | 当前用户 `menu_perms` 长度 |
+| `path` | 菜单路由或关联页路由 |
+
+### `menuFilter.reason` 取值
+
+| reason | 含义 |
+|--------|------|
+| `adminOnly` | 菜单项 `adminOnly`，非超管不可见 |
+| `missingPermCode` | `page` 无可用 `routeKey`、`link` 无 `nameKey`，无法匹配 `menu_perms` |
+| `menuPermsEmpty` | `menu_perms` 为空数组 |
+| `permCodeNotInMenuPerms` | 权限 code 不在 `menu_perms` 中 |
+| `groupNoVisibleChildren` | 分组下子菜单全部过滤后无可见项 |
+| `allChildrenFilteredOut` | 父级单项通过（`page`/`link` 有权限），但子级全部过滤后无子项可展示 |
+
+说明：`group` 作为容器在子项仍可见时**不会**被记为 `hidden`；仅当整组被剔除时打日志。
+
+## 使用示例
+
+在浏览器控制台过滤：
+
+```text
+routePermission
+```
+
+或：
+
+```text
+menuFilter
+```
+
+或：
+
+```text
+[Layout]
+```
+
+（具体前缀以 `layoutLogger` 实现为准。）
+
+## 设计决策
+
+| 决策点 | 选择 | 理由 |
+|--------|------|------|
+| 日志前缀 | 固定 `'routePermission'` + 对象载荷 | 可过滤、可结构化，便于 AI/人工检索 |
+| 生产环境 | 静默 | `layoutLogger` 在 `production` 下不输出 |
+| 无 `currentRoute` 不打日志 | 跳过 | 静态路由访问频繁，避免噪音 |
+| `menuFilter` 与超管/关权限 | 不打 | 无过滤效果时无隐藏项可记 |
+
+## 已知限制与待改进
+
+- 日志仅在**开发环境**可见；线上问题需依赖 Sentry 或其它监控，不在本功能内。
+- `renderContent` 另有 `renderContent:` 日志，与 `routePermission` 独立，排查时可同时参考。
+
+## 注意事项
+
+- 权限判定逻辑以 `layouts/index.tsx` 与 [菜单权限控制](./feature-菜单权限控制.md)、[路由与菜单解耦](./feature-路由与菜单解耦.md) 为准；本文档**仅描述日志字段**，不替代权限语义说明。
+
+## 相关文档
+
+- [菜单权限控制](./feature-菜单权限控制.md)
+- [路由与菜单解耦](./feature-路由与菜单解耦.md)
+- [日志与常量](./arch-日志与常量.md)（`layoutLogger` 行为）

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

@@ -5,38 +5,30 @@
  */
 
 export default {
-  // 获取用户信息
-  'GET /api/user/info': {
-    "code": 200,
-    "data": {
-        "id": 381,
-        "last_login": "2026-03-06T02:37:10.050735Z",
-        "is_superuser": true,
-        "username": "本地测试mock用户",
-        "first_name": "",
-        "last_name": "",
-        "email": "本地测试mock用户@micous.com",
-        "is_staff": true,
-        "is_active": true,
-        "type": 1,
-        "phone": "",
-        "agency_id": 0,
-        "avatar": "https://gw.alipayobjects.com/zos/antfincdn/XAosXuNZyF/BiazfanxmamNRoxxVxka.png",
-        "user_name": "Easton",
-        "permission_tree": [
-        ],
-        "miss_permissions": [],
-        "side_menus": [
-          '首页',
-          '示例模块.示例页面',
-          '微应用示例.子应用页面',
-          '外部链接',
-          '权限管理',
-        ],
-        "region_permissions": []
+  // 获取用户信息（OpenAPI 8 GET /user/info/，与 fetchUserInfo 一致）
+  'GET /user/info/': {
+    code: 200,
+    data: {
+      id: 381,
+      avatar:
+        'https://gw.alipayobjects.com/zos/antfincdn/XAosXuNZyF/BiazfanxmamNRoxxVxka.png',
+      email: '本地测试mock用户@micous.com',
+      name: 'Easton',
+      app_perms: [],
+      region_perms: [],
+      menu_perms: [
+        'cs_web_menu_home',
+        'cs_web_menu_example_page',
+        'cs_web_menu_subapp_page',
+        'cs_web_menu_external_link',
+        'cs_web_menu_permission_management',
+        'cs_web_menu_group_management',
+      ],
+      button_perms: ['cs_web_btn_subapp_demo', 'cs_web_btn_home_demo'],
+      is_superuser: false,
     },
-    "msg": "ok"
-},
+    msg: 'ok',
+  },
 
   // 获取统计数据
   // 'GET /api/dashboard/stats': {

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

@@ -6,6 +6,7 @@
  * - id: 页面唯一标识
  * - name: 页面名称
  * - route: 路由路径
+ * - base: 微应用挂载前缀（可与 route 不同）
  * - htmlUrl: 微应用 HTML 入口 URL
  * - jsUrls: 额外 JS 资源
  * - cssUrls: 额外 CSS 资源
@@ -25,12 +26,12 @@ const mockPages: PublicPageItem[] = [
   {
     id: 125,
     name: '登录页',
-    nameEn: 'Login',
-    nameKey: 'page.user.login',
     route: '/user/login',
     base: '/user/login',
+    // 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',
@@ -45,12 +46,32 @@ const mockPages: PublicPageItem[] = [
   {
     id: 124,
     name: '权限管理',
-    nameEn: 'Permission Management',
-    nameKey: 'page.permission',
     route: '/permission',
     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.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: '',
@@ -65,8 +86,6 @@ const mockPages: PublicPageItem[] = [
   {
     id: 115,
     name: '兜底',
-    nameEn: 'Fallback',
-    nameKey: 'page.fallback',
     route: '/*',
     base: '/',
     htmlUrl: '',

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",

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

@@ -1,12 +1,27 @@
 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,
+  type ILang,
+} from '<%= packageScope %>/common-intl';
+import * as CommonIntl from '<%= packageScope %>/common-intl';
 import { getStoredAuthToken } from './common/auth/auth-manager';
 import type { IUserInfo } from './common/auth/type';
 import { fetchUserInfo } from './services/user';
@@ -23,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 全局错误处理 ====================
 // 捕获子应用运行时未捕获的异常，防止页面崩溃
@@ -80,16 +117,33 @@ 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;
 }
 
 // 初始化主题（在页面加载时立即执行，避免闪烁）
@@ -107,6 +161,33 @@ export const locale = {
   },
 };
 
+// ==================== 国际化数据预加载 ====================
+
+/**
+ * 配置了有效 `__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: umiLocaleToILang(getCurrentLocale()) as ILang,
+    localeRequestUrl: process.env.LOCALE_REQUEST_URL,
+  })
+    .then(oldRender)
+    .catch((error: Error) => {
+      console.error('获取多语言文案失败', error);
+      oldRender();
+    });
+}
+
 /**
  * @see https://umijs.org/docs/api/runtime-config#getinitialstate
  */
@@ -137,8 +218,8 @@ export async function getInitialState(): Promise<{
     await ensureSsoSession();
   }
 
-  // 有 token 就获取用户信息（无论在哪个页面，支持登录后 refresh 场景）
-  // 当页面免认证时，不获取用户信息
+  // 有 token 就获取用户信息（登录后 refresh、免认证页同样需要 currentUser：
+  // 如 PermissionFilter / MicroAppLoader 注入子应用的 button_perms）
   if (getStoredAuthToken() && !skipAuth) {
     const userInfo = await fetchUserInfoFn();
     if (userInfo) {

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();
 }
 
 /**