generator-mico-cli 0.2.20 → 0.2.22

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

@@ -4,6 +4,7 @@ import { defineConfig } from '@umijs/max';
 
 
 import mockMenus from '../mock/menus';
+import mockPages from '../mock/pages';
 
 const config: ReturnType<typeof defineConfig> = {
   publicPath: '/',
@@ -16,18 +17,21 @@ const config: ReturnType<typeof defineConfig> = {
     {
       content: `
         window.__MICO_MENUS__ = ${JSON.stringify(mockMenus)};
+        window.__MICO_PAGES__ = ${JSON.stringify(mockPages)};
         window.__MICO_CONFIG__ = {
           appName: '<%= projectName %>',
+          title: '测试样例',
+          logo: '',
           apiBaseUrl: '',
           defaultPath: '',
           // 免认证路由（跳过 SSO 登录），支持 /* 前缀匹配
           // noAuthRouteList: ['/*'],
           // 免权限校验路由（跳过菜单权限检查）
-          // noPermissionRouteList: ['/task-query/*'],
+          noPermissionRouteList: [],
           // 不显示布局的路由（全屏页面）
-          // noLayoutRouteList: ['/task-query/*'],
+          // noLayoutRouteList: [],
           // 关闭权限控制（调试用）
-          disableAuth: true,
+          disableAuth: false,
         };
       `,
     },

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

@@ -118,6 +118,27 @@ const config: ReturnType<typeof defineConfig> = {
    */
   tailwindcss: {},
 
+  /**
+   * @name 额外 Babel Presets
+   * @description 使用 @mico-platform/ui 的 babel preset，实现组件与图标的按需加载
+   */
+  extraBabelPresets: ['@mico-platform/ui/babel-preset'],
+
+  /**
+   * @name MFSU 配置
+   * @description
+   * - exclude: theme 子路径解析；ui 尽量与主应用一起编译
+   * - shared: React 单例，确保 MFSU 预打包里的组件（如 Layout）与主应用共用同一份 React，否则 useContext 报 null
+   * @doc https://umijs.org/docs/guides/mfsu
+   */
+  mfsu: {
+    exclude: ['@mico-platform/theme', '@mico-platform/ui'],
+    shared: {
+      react: { singleton: true },
+      'react-dom': { singleton: true },
+    },
+  },
+
   /**
    * @name qiankun 微前端配置
    * @description 作为主应用，动态加载子应用

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

@@ -5,11 +5,6 @@
  * @note Umi Max 会自动使用 src/layouts/index.tsx 作为全局布局，无需显式配置
  */
 export default [
-  {
-    path: '/user/login',
-    component: './User/Login',
-    name: '登录',
-  },
   {
     path: '/',
     component: './Home',

package/generators/micro-react/templates/apps/layout/docs/common-intl.md

@@ -10,6 +10,8 @@
 - 需要从多语言中台动态获取翻译文案
 - 希望统一管理国际化逻辑，减少重复代码
 
+> **注意**：本文档描述的是 `@payment-portal/common-intl` 包的完整使用方式，涵盖了所有使用该包的应用（包括本仓库外的应用如 conversation-v2、session、workorder 等）。当前仓库仅包含 `layout` 和 `basis` 两个应用。
+
 ## 核心特性
 
 | 特性       | 说明                                             |
@@ -311,12 +313,12 @@ console.log(SUPPORTED_LOCALES); // ['zh_CN', 'en', 'ar', 'tr']
 
 目前支持以下语言：
 
-| 语言常量     | 值      | 说明     |
-| ------------ | ------- | -------- |
-| `LANG.ZH_CN` | `zh_CN` | 简体中文 |
-| `LANG.EN`    | `en`    | 英语     |
-| `LANG.AR`    | `ar`    | 阿拉伯语 |
-| `LANG.TR`    | `tr`    | 土耳其语 |
+| 语言常量      | 值      | 说明     |
+| ------------- | ------- | -------- |
+| `LANG.ZH_CN`  | `zh_CN` | 简体中文 |
+| `LANG.EN_US`  | `en`    | 英语     |
+| `LANG.AR_SA`  | `ar`    | 阿拉伯语 |
+| `LANG.TR_TR`  | `tr`    | 土耳其语 |
 
 ### Q: 如何在代码中获取当前语言？
 

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

@@ -18,8 +18,8 @@
 
 ### 核心实现
 
-1. 主应用通过 `window.__MICO_MENUS__` 获取菜单配置
-2. 解析菜单时根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
+1. 主应用优先通过 `window.__MICO_PAGES__` 获取页面配置，无数据时降级到 `window.__MICO_MENUS__`（详见 [路由与菜单解耦](./feature-路由与菜单解耦.md)）
+2. 解析页面时根据 `htmlUrl` 或 `jsUrls` 判断是否为微应用
 3. 路由匹配时，微应用类型使用 `MicroAppLoader` 组件加载
 4. `MicroAppLoader` 使用 qiankun 的 `loadMicroApp` API 动态挂载子应用
 5. 组件卸载时自动调用 `unmount()` 清理子应用
@@ -28,16 +28,16 @@
 
 ### 核心文件
 
-| 文件路径                                            | 说明                             |
-| --------------------------------------------------- | -------------------------------- |
-| `src/components/MicroAppLoader/index.tsx`           | qiankun 微应用加载器组件         |
-| `src/components/MicroAppLoader/container-manager.ts`| 容器生命周期管理、会话 ID 机制   |
-| `src/components/MicroAppLoader/index.less`          | 加载器样式                       |
-| `src/common/menu/parser.ts`                         | 菜单解析，包含加载类型判断       |
-| `src/common/menu/types.ts`                          | 类型定义                         |
-| `src/layouts/index.tsx`                             | 主布局，集成微应用渲染           |
-| `src/app.tsx`                                       | qiankun 全局错误处理             |
-| `config/config.ts`                                  | qiankun master 配置              |
+| 文件路径 | 说明 |
+| --- | --- |
+| `src/components/MicroAppLoader/index.tsx` | qiankun 微应用加载器组件 |
+| `src/components/MicroAppLoader/micro-app-manager.ts` | 微应用管理器（单例），稳定容器 + 实例缓存 + 操作序列号 |
+| `src/components/MicroAppLoader/index.less` | 加载器样式 |
+| `src/common/menu/parser.ts` | 菜单解析，包含加载类型判断 |
+| `src/common/menu/types.ts` | 类型定义 |
+| `src/layouts/index.tsx` | 主布局，集成微应用渲染 |
+| `src/app.tsx` | qiankun 全局错误处理 |
+| `config/config.ts` | qiankun master 配置 |
 
 ## API / 组件接口
 
@@ -334,6 +334,7 @@ const config: ReturnType<typeof defineConfig> = {
   externals: {
     react: 'window.React',
     'react-dom': 'window.ReactDOM',
+    'react-dom/client': 'window.ReactDOMClient',
     '@mico-platform/ui': 'window.micoUI',
   },
 };
@@ -421,6 +422,8 @@ export default function HomePage() {
 
 ## 相关文档
 
+- [路由与菜单解耦](./feature-路由与菜单解耦.md) - 路由注册与菜单导航数据源分离
+- [菜单权限控制](./feature-菜单权限控制.md) - sideMenus 白名单权限逻辑
 - [主题色切换](./feature-主题色切换.md) - 主题系统实现与子应用适配
 - [请求模块架构](./arch-请求模块.md) - HTTP 请求层模块化设计
 - [日志与常量](./arch-日志与常量.md) - Logger 工具与常量管理
@@ -462,52 +465,77 @@ addGlobalUncaughtErrorHandler((event: Event | string) => {
 });
 ```
 
-### container-manager API
+### MicroAppManager API (micro-app-manager.ts)
 
-容器管理器提供会话 ID 机制防止并发加载冲突：
+`MicroAppManager` 是单例类，管理微应用的加载、缓存、切换和卸载：
 
 ```typescript
-/** 开始加载会话，返回唯一会话 ID */
-function startLoadSession(appName: string): number;
+interface MicroAppConfig {
+  name: string;
+  entry: string;
+  target: HTMLElement;       // 目标挂载位置
+  props: Record<string, unknown>;
+}
+
+interface MicroAppState {
+  loading: boolean;
+  error: string | null;
+  mounted: boolean;
+}
+
+const manager = microAppManager; // 单例，导出即用
 
-/** 检查会话是否仍然有效（被新加载覆盖时返回 false） */
-function isLoadSessionValid(appName: string, sessionId: number): boolean;
+/** 切换到指定微应用（已挂载则仅更新 props） */
+manager.switchTo(config: MicroAppConfig): void;
 
-/** 标记加载完成 */
-function markLoadComplete(appName: string, sessionId: number): boolean;
+/** 更新当前已挂载微应用的 props */
+manager.updateProps(props: Record<string, unknown>): void;
 
-/** 等待当前卸载操作完成（如果有） */
-async function waitForUnmount(appName: string): Promise<void>;
+/** 取消待处理的请求 */
+manager.cancel(): void;
 
-/** 获取当前加载状态 */
-function getLoadingStatus(appName: string): 'idle' | 'loading' | 'mounted' | 'unmounting';
+/** 清除所有缓存实例 */
+manager.clearCache(): Promise<void>;
+
+/** 获取调试信息 */
+manager.getDebugInfo(): object;
+
+/** 设置状态变化回调 */
+manager.setStateCallback(callback: StateChangeCallback | null): void;
 ```
 
+### 核心设计
+
+1. **稳定容器**：容器在 `document.body` 中创建，激活时移到目标元素内，停用时移回 body 隐藏，不受 React 生命周期影响
+2. **实例缓存**：每个 entry 只 `loadMicroApp` 一次，后续切换复用已有实例（mount/unmount）
+3. **操作序列号**：通过递增的 `operationSeq` 检测过期操作，替代旧的会话 ID 机制
+4. **自动路由守卫**：由独立的 `route-guard.ts` 自动检测用户意图，业务代码无需感知
+
 ### 快速切换时序
 
 ```
 场景：A → B → A 快速切换
 
-A1 开始加载 (sessionId=1)
-  ↓
-切换到 B，A1 cleanup 在 queueMicrotask 中执行
+switchTo(A)：operationSeq=1，开始 loadMicroApp
   ↓
-切换回 A，A2 开始加载 (sessionId=2)
+switchTo(B)：operationSeq=2，A 的 pendingRequest 被替换
   ↓
-A2 调用 waitForUnmount()，等待 A1 完全卸载
+A 的 processRequest 在异步步骤中检测 shouldAbort(mySeq=1) → true
   ↓
-A1 卸载完成（带 10 秒超时保护）
+A 等待 mountPromise 完成后执行 safeUnmount，容器移回 body
   ↓
-A2 继续加载，每个异步步骤检查 isLoadSessionValid(sessionId)
+B 开始 processRequest，检查缓存 → 无缓存 → loadMicroApp
   ↓
-加载完成后立即同步最新 Props（locale/timezone 等）
+B 加载完成后同步最新 Props（locale/timezone/routePath 等）
 ```
 
 ### 设计决策
 
 | 决策点 | 选择 | 理由 |
-|--------|------|------|
-| 卸载时机 | `queueMicrotask` | 在当前事件循环末尾执行，比 `requestAnimationFrame` 更快更可靠 |
-| 并发控制 | 会话 ID 机制 | 简单高效，无需复杂的锁机制 |
-| 超时时间 | 10 秒 | 平衡等待时间与异常检测速度 |
-| Props 同步 | 加载后立即同步 | 确保加载期间的变化不丢失 |
+| --- | --- | --- |
+| 容器策略 | 稳定容器（body 中创建，移动挂载） | 不受 React 生命周期影响，避免容器被意外销毁 |
+| 并发控制 | 操作序列号 + pendingRequest 队列 | 简单高效，新请求自动覆盖旧请求 |
+| 实例缓存 | loadPromise 完成后立即缓存 | 即使被 abort 也可复用，避免重复加载 |
+| unmount 安全 | 等待 mountPromise 完成后再 unmount | 避免 single-spa error #32 |
+| 超时保护 | load 30s / mount 30s / unmount 10s | 平衡等待时间与异常检测速度 |
+| Props 同步 | mount 完成后立即 safeUpdate | 确保加载期间的变化不丢失 |

package/generators/micro-react/templates/apps/layout/docs/feature-/350/217/234/345/215/225/346/235/203/351/231/220/346/216/247/345/210/266.md

@@ -1,6 +1,6 @@
 # 菜单权限控制
 
-> 创建时间：2026-01-24 更新时间：2026-01-27
+> 创建时间：2026-01-24 更新时间：2026-02-08
 
 ## 功能概述
 
@@ -19,12 +19,12 @@
 
 ### 四种路由场景
 
-| 场景 | noAuthRouteList | noPermissionRouteList | 示例 |
-| --- | --- | --- | --- |
-| 公开页面 | ✅ | ✅ | 首页、活动页 |
-| 登录后公共页面 | ❌ | ✅ | 个人设置、帮助中心 |
-| 需要权限的页面 | ❌ | ❌ | 后台管理、业务功能 |
-| 登录页等特殊页面 | ✅ | ✅ | /user/login、/403 |
+| 场景 | noAuthRouteList | noPermissionRouteList | accessControlEnabled | 示例 |
+| --- | --- | --- | --- | --- |
+| 公开页面 | ✅ | ✅ | `false` | 首页、活动页 |
+| 登录后公共页面 | ❌ | ✅ | - | 个人设置、帮助中心 |
+| 需要权限的页面 | ❌ | ❌ | `true` | 后台管理、业务功能 |
+| 登录页等特殊页面 | ✅ | ✅ | `false` | /login、/403 |
 
 ## 技术方案
 
@@ -40,22 +40,28 @@
 用户访问路由
     │
     ▼
-┌─────────────────────────────────┐
-│  1. SSO 认证检查 (app.tsx)       │
-│     isNoAuthRoute(pathname)?    │
-│     ├── 是 → 跳过 SSO           │
-│     └── 否 → 执行 ensureSsoSession()
-└─────────────────────────────────┘
+┌──────────────────────────────────────────────┐
+│  1. SSO 认证检查 (app.tsx)                    │
+│     isNoAuthRoute(pathname)?                 │
+│     ├── 是 → 跳过 SSO                        │
+│     page.accessControlEnabled === false?     │
+│     ├── 是 → 跳过 SSO（PAGES 数据驱动）       │
+│     └── 否 → 执行 ensureSsoSession()          │
+└──────────────────────────────────────────────┘
     │
     ▼
-┌─────────────────────────────────┐
-│  2. 权限校验 (layouts/index.tsx) │
-│     isNoPermissionRoute(pathname)?
-│     ├── 是 → 跳过权限校验        │
-│     └── 否 → 检查 side_menus    │
-│              ├── 有权限 → 正常渲染
-│              └── 无权限 → 显示 403
-└─────────────────────────────────┘
+┌──────────────────────────────────────────┐
+│  2. 权限校验 (layouts/index.tsx)          │
+│     isNoPermissionRoute(pathname)?       │
+│     ├── 是 → 跳过权限校验                │
+│     └── 否 → 双层权限判断                │
+│              Tier 1: 页面在菜单中？       │
+│              ├── 是 → 沿用 sideMenus     │
+│              │        白名单逻辑          │
+│              └── 否 → Tier 2: 页面级权限  │
+│                       adminOnly / routeKey│
+│              详见：路由与菜单解耦文档      │
+└──────────────────────────────────────────┘
     │
     ▼
 ┌─────────────────────────────────┐
@@ -66,12 +72,16 @@
 └─────────────────────────────────┘
     │
     ▼
-┌─────────────────────────────────┐
-│  4. 子应用加载 (MicroAppLoader)  │
-│     isNoPermissionRoute(pathname)?
-│     ├── 是 → 直接加载           │
-│     └── 否 → 等待 currentUser   │
-└─────────────────────────────────┘
+┌──────────────────────────────────────────────┐
+│  4. 子应用加载 (MicroAppLoader)               │
+│     page.accessControlEnabled === false?     │
+│     ├── 是 → 直接加载（PAGES 数据驱动）       │
+│     isNoAuthRoute(pathname)?                 │
+│     ├── 是 → 直接加载（静态配置兜底）         │
+│     isNoPermissionRoute(pathname)?           │
+│     ├── 是 → 直接加载                        │
+│     └── 否 → 等待 currentUser                │
+└──────────────────────────────────────────────┘
 ```
 
 ### 权限判断逻辑（详细）
@@ -84,18 +94,39 @@
     ├── 是 → 允许所有访问（调试模式）
     │
     ▼
+page.accessControlEnabled === false？
+    ├── 是 → 跳过 SSO 认证 + 跳过权限校验
+    │
+    ▼
 是否在 noPermissionRouteList 中？
     ├── 是 → 允许访问，显示全部菜单
     │
     ▼
+是否是非动态路由（不在 PAGES 中）？
+    ├── 是 → 交给 Umi 处理（404 等静态路由）
+    │
+    ▼
 是否是超级用户？
-    ├── 是 → 允许访问所有菜单
+    ├── 是 → 允许访问所有页面
+    │
+    ▼
+Tier 1: 页面在菜单中？
+    ├── 是 → 沿用菜单权限逻辑：
+    │        菜单项 adminOnly === true？
+    │        ├── 是 → 禁止访问
+    │        检查 side_menus 白名单
+    │        ├── 匹配 → 允许访问
+    │        └── 不匹配 → 显示 403
     │
     ▼
-检查 side_menus 白名单
-    ├── 精确匹配：menuPath === side_menus[i]
-    ├── 前缀匹配：side_menus[i].startsWith(menuPath + '.')
-    └── 都不匹配 → 禁止访问，显示 403
+Tier 2: 隐藏页面（不在菜单中）
+    adminOnly === true？
+    ├── 是 → 显示 403
+    accessControlEnabled === true？
+    ├── 是 → 检查 routeKey ∈ side_menus
+    │        ├── 匹配 → 允许访问
+    │        └── 不匹配 → 显示 403
+    └── 否 → 允许访问
 ```
 
 ## 文件清单
@@ -241,24 +272,36 @@ export const NO_PERMISSION_ROUTE_LIST: string[] = ['/403', '/404'];
 │   └── 配置队列     ✅ 精确匹配 "列队管理.配置队列"
 ├── 质量管理         ❌ 不在白名单
 │   └── 抽样检查     ❌ 不在白名单
-└── 权限管理         ❌ 硬编码禁止（非超级用户）
+└── 权限管理         ❌ adminOnly=true，非超级用户不可见
 ```
 
 ### Layout 中的权限判断
 
 ```tsx
-// layouts/index.tsx
+// layouts/index.tsx — 双层权限判断
 const isForbidden = useMemo(() => {
-  // 关闭权限控制时，不校验权限
   if (isAuthDisabled()) return false;
-  // 免权限校验路由，不检查菜单权限
   if (isNoPermissionRoute(location.pathname)) return false;
-  // 如果在有权限的路由中找到了，说明有权限
-  if (currentRoute) return false;
-  // 在所有路由中存在但无权限
-  const routeInAll = findRouteByPath(allRoutes, location.pathname);
-  return !!routeInAll;
-}, [currentRoute, allRoutes, location.pathname]);
+  if (!currentRoute) return false; // 非动态路由
+  if (isSuperuserUser(currentUser?.is_superuser)) return false;
+
+  // Tier 1: 菜单权限交叉引用
+  const inAllMenu = findRouteByPath(allMenuRoutes, location.pathname);
+  if (inAllMenu) {
+    return !findRouteByPath(allowedMenuRoutes, location.pathname);
+  }
+
+  // Tier 2: 隐藏页面级权限
+  if (!hasWindowPages()) return false;
+  const page = findPageByPath(getWindowPages(), location.pathname);
+  if (!page) return false;
+  if (page.adminOnly) return true;
+  if (page.accessControlEnabled) {
+    const sideMenus = (currentUser?.side_menus || []) as string[];
+    return !page.routeKey || !sideMenus.includes(page.routeKey);
+  }
+  return false;
+}, [...]);
 ```
 
 ### MicroAppLoader 中的认证判断
@@ -267,6 +310,8 @@ const isForbidden = useMemo(() => {
 // components/MicroAppLoader/index.tsx
 const isAuthReady =
   isAuthDisabled() ||
+  isPageAuthFree(location.pathname) ||
+  isNoAuthRoute(location.pathname) ||
   isNoPermissionRoute(location.pathname) ||
   !!initialState?.currentUser;
 
@@ -276,18 +321,34 @@ if (!isAuthReady) {
 }
 ```
 
+判断优先级：
+1. `isAuthDisabled()` — 全局关闭权限，直接放行
+2. `isPageAuthFree` — **PAGES 数据驱动**，页面 `accessControlEnabled === false` 时跳过认证和权限校验
+3. `isNoAuthRoute()` — 静态配置兜底，免认证路由（PAGES 未注入时的降级保护）
+4. `isNoPermissionRoute()` — 免权限路由（如 403/404），无需等待 currentUser
+5. `!!initialState?.currentUser` — 已登录，有用户信息
+
+**注意**：`accessControlEnabled === false` 同时影响三个阶段：
+
+- SSO 认证（`app.tsx`）：跳过 `ensureSsoSession()` 和 `handleAuthFailureRedirect()`
+- 权限校验（`layouts/index.tsx`）：Tier 2 隐藏页面默认放行
+- 子应用加载（`MicroAppLoader`）：不等待 currentUser 直接加载
+
 ## 设计决策
 
 | 决策点 | 选择 | 理由 |
 | --- | --- | --- |
+| accessControlEnabled 统一控制 | `false` 同时跳过认证和授权 | PAGES 数据驱动，一个字段即可标记公开页面，无需重复配置 noAuthRouteList |
 | 认证与授权分离 | 两个独立配置项 | 不同场景需要不同组合，如"需要登录但不需要权限"的个人设置页 |
 | 权限模型 | 白名单 (`side_menus`) | 后端返回的 `side_menus` 是允许列表，比黑名单更安全 |
 | 403 处理 | 原地渲染组件 | 保持 URL 不变，用户体验更好，便于分享链接 |
 | 父级菜单显示 | 前缀匹配 | 子菜单有权限时，父级菜单需要作为容器显示 |
 | 超级用户 | 跳过所有检查 | 管理员需要完整访问权限 |
 | 免权限路由的菜单 | 显示全部 | 用户访问公开页面时应能看到所有导航选项 |
+| 免认证路由的子应用 | 直接加载 | 不等待 currentUser，免认证路由本身不需要登录 |
 | 免权限路由的子应用 | 直接加载 | 不等待 currentUser，避免加载卡住 |
 | 静态路由不受权限控制 | 默认允许访问 | 见下方"静态路由与动态路由"说明 |
+| adminOnly 判断 | 读取菜单数据字段 | 替代硬编码菜单名称匹配，由后端数据驱动，支持多语言且无需前端维护 |
 
 ## 静态路由与动态路由
 
@@ -296,7 +357,7 @@ if (!isAuthReady) {
 | 类型 | 来源 | 示例 |
 | --- | --- | --- |
 | **静态路由** | 代码中定义 (`config/routes.ts`) | `/`, `/403`, `/404`, `/user/login` |
-| **动态路由** | 后端菜单配置 (`window.__MICO_MENUS__`) | `/queue-management`, `/quality-check` |
+| **动态路由** | 后端页面配置 (`window.__MICO_PAGES__`，降级 `window.__MICO_MENUS__`) | `/queue-management`, `/quality-check` |
 
 ### 权限控制范围
 
@@ -306,9 +367,11 @@ if (!isAuthReady) {
 权限判断逻辑（isForbidden）：
 1. 检查 isAuthDisabled() → 关闭则全部允许
 2. 检查 isNoPermissionRoute() → 在免权限列表中则允许
-3. 检查 currentRoute（有权限路由） → 找到则允许
-4. 检查 routeInAll（所有动态路由） → 存在则返回 403
-5. 都不匹配 → 交给 Umi 处理（静态路由走这里）
+3. 检查 currentRoute（PAGES 中的路由）→ 不存在则非动态路由，交给 Umi
+4. 检查 isSuperuserUser() → 超级用户放行
+5. Tier 1: 在菜单中 → 检查 allowedMenuRoutes
+6. Tier 2: 不在菜单（隐藏页面）→ 检查 adminOnly + accessControlEnabled + routeKey
+7. 都不匹配 → 放行
 ```
 
 ### 设计理由
@@ -346,10 +409,11 @@ if (!isAuthReady) {
 - `side_menus` 格式为菜单路径，如 `"列队管理.配置队列"`
 - `miss_permissions` 用于按钮级别权限控制，不影响菜单显示
 - 403 页面在 Layout 内渲染，不会触发路由跳转
-- 调试时可在控制台搜索 `isForbidden check` 查看权限判断日志
+- 调试时可在控制台搜索 `isForbidden (menu check)` 或 `isForbidden (hidden page` 查看权限判断日志
 - **常见问题**：配置了 `noAuthRouteList` 但页面仍显示 403，需同时配置 `noPermissionRouteList`
 
 ## 相关文档
 
-- [微前端模式](./feature-微前端模式.md) - 路由和菜单解析
+- [路由与菜单解耦](./feature-路由与菜单解耦.md) - 路由注册与菜单导航数据源分离、双层权限详细说明
+- [微前端模式](./feature-微前端模式.md) - 微应用加载机制
 - [日志与常量](./arch-日志与常量.md) - 常量管理