generator-mico-cli 0.2.21 → 0.2.23

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

@@ -2,9 +2,12 @@ import { layoutLogger } from '@/common/logger';
 import {
   extractRoutes,
   filterMenuItems,
+  findPageByPath,
   findRouteByPath,
-  getWindowMenus,
+  getDynamicRoutes,
+  isSuperuserUser,
 } from '@/common/menu';
+import { getMenus, getPages, hasPages } from '@/common/portal-data';
 import { getAppNameFromEntry } from '@/common/micro';
 import AppTabs from '@/components/AppTabs';
 import MicroAppLoader from '@/components/MicroAppLoader';
@@ -46,57 +49,89 @@ const BasicLayout: React.FC = () => {
     [currentUser?.is_superuser, currentUser?.side_menus],
   );
 
-  // 所有路由（不过滤权限，用于判断路径是否存在）
-  const allRoutes = useMemo(() => {
-    const menus = getWindowMenus();
-    return extractRoutes(menus);
+  // 所有页面路由（优先 PAGES，降级 MENUS）— 用于路由匹配和渲染
+  const allPageRoutes = useMemo(() => {
+    return getDynamicRoutes();
   }, []);
 
-  // 有权限的路由（disableAuth 时不过滤，显示全部）
-  const allowedRoutes = useMemo(() => {
+  // 菜单路由（从 MENUS）— 用于权限交叉引用
+  const allMenuRoutes = useMemo(() => {
+    return extractRoutes(getMenus());
+  }, []);
+
+  const allowedMenuRoutes = useMemo(() => {
     if (isAuthDisabled()) {
-      return allRoutes;
+      return allMenuRoutes;
     }
-    const menus = getWindowMenus();
-    const filteredMenus = filterMenuItems(menus, filterOptions);
+    const filteredMenus = filterMenuItems(getMenus(), filterOptions);
     return extractRoutes(filteredMenus);
-  }, [filterOptions, allRoutes]);
+  }, [filterOptions, allMenuRoutes]);
 
-  // 查找当前路由配置（优先从有权限的路由中查找）
+  // 当前路由配置（从所有页面路由中查找）
   const currentRoute = useMemo(() => {
-    return findRouteByPath(allowedRoutes, location.pathname);
-  }, [allowedRoutes, location.pathname]);
+    return findRouteByPath(allPageRoutes, location.pathname);
+  }, [allPageRoutes, location.pathname]);
 
-  // 判断是否是动态路由但无权限（disableAuth 时始终返回 false）
+  // 权限判断：菜单交叉引用 + 隐藏页面级兜底
   const isForbidden = useMemo(() => {
-    // 关闭权限控制时，不校验权限
     if (isAuthDisabled()) return false;
-    // 免权限校验路由，不检查菜单权限
     if (isNoPermissionRoute(location.pathname)) return false;
-    // 如果在有权限的路由中找到了，说明有权限
-    if (currentRoute) return false;
-    // 如果在所有路由中也找不到，说明不是动态路由，交给 Umi 处理
-    const routeInAll = findRouteByPath(allRoutes, location.pathname);
-    // 在所有路由中存在，但在有权限的路由中不存在 → 无权限
-    const forbidden = !!routeInAll;
-
-    layoutLogger.log('isForbidden check:', {
-      pathname: location.pathname,
-      currentRoute,
-      routeInAll,
-      forbidden,
-      allRoutesCount: allRoutes.length,
-      allowedRoutesCount: allowedRoutes.length,
-      filterOptions,
-    });
+    // 非动态路由，交给 Umi 处理（404 等）
+    if (!currentRoute) return false;
+    if (isSuperuserUser(currentUser?.is_superuser)) return false;
+
+    // Tier 1: 菜单权限交叉引用
+    const inAllMenu = findRouteByPath(allMenuRoutes, location.pathname);
+    if (inAllMenu) {
+      const inAllowed = findRouteByPath(allowedMenuRoutes, location.pathname);
+      const forbidden = !inAllowed;
+
+      layoutLogger.log('isForbidden (menu check):', {
+        pathname: location.pathname,
+        inAllMenu: true,
+        inAllowed: !!inAllowed,
+        forbidden,
+      });
+
+      return forbidden;
+    }
+
+    // Tier 2: 隐藏页面级权限（仅在 PAGES 数据可用时生效）
+    if (!hasPages()) return false;
+
+    const page = findPageByPath(getPages(), location.pathname);
+    if (!page) return false;
+
+    if (page.adminOnly) {
+      layoutLogger.log('isForbidden (hidden page adminOnly):', {
+        pathname: location.pathname,
+        pageId: page.id,
+      });
+      return true;
+    }
+
+    if (page.accessControlEnabled) {
+      const sideMenus = (currentUser?.side_menus || []) as string[];
+      const forbidden = !page.routeKey || !sideMenus.includes(page.routeKey);
+
+      layoutLogger.log('isForbidden (hidden page accessControl):', {
+        pathname: location.pathname,
+        pageId: page.id,
+        routeKey: page.routeKey,
+        hasSideMenuMatch: !forbidden,
+      });
+
+      return forbidden;
+    }
 
-    return forbidden;
+    return false;
   }, [
     currentRoute,
-    allRoutes,
-    allowedRoutes,
+    allMenuRoutes,
+    allowedMenuRoutes,
     location.pathname,
-    filterOptions,
+    currentUser?.is_superuser,
+    currentUser?.side_menus,
   ]);
 
   // 判断是否需要显示布局
@@ -195,7 +230,9 @@ const BasicLayout: React.FC = () => {
             <AppTabs />
             <Content className="layout-content-outlet">
               <Suspense
-                fallback={<Spin dot style={{ width: '100%', marginTop: 100 }} />}
+                fallback={
+                  <Spin dot style={{ width: '100%', marginTop: 100 }} />
+                }
               >
                 {renderContent()}
               </Suspense>

package/generators/micro-react/templates/apps/layout/src/pages/404/index.tsx

@@ -1,9 +1,5 @@
-import {
-  extractRoutes,
-  filterMenuItems,
-  getWindowMenus,
-  type MenuFilterOptions,
-} from '@/common/menu';
+import { extractRoutes, filterMenuItems, type MenuFilterOptions } from '@/common/menu';
+import { getMenus } from '@/common/portal-data';
 import { isAuthDisabled } from '@/constants';
 import { Button, Result, Space } from '@mico-platform/ui';
 import { history, useModel } from '@umijs/max';
@@ -13,7 +9,7 @@ import React, { useMemo } from 'react';
  * 获取第一个可访问的路由路径
  */
 const getFirstAvailablePath = (filterOptions: MenuFilterOptions): string => {
-  const menus = getWindowMenus();
+  const menus = getMenus();
 
   // 根据权限过滤菜单
   const filteredMenus = isAuthDisabled()

package/generators/micro-react/templates/apps/layout/src/services/user.ts

@@ -10,8 +10,8 @@ const USER_INFO_API = '/api/user/info';
  * - en: 2 (英文)
  */
 const LOCALE_TO_LANG: Partial<Record<SupportedLocale, number>> = {
-  zh_CN: 1,
-  en: 2,
+  'zh-CN': 1,
+  'en-US': 2,
 };
 
 /**
@@ -42,7 +42,11 @@ export async function fetchUserInfo(): Promise<IUserInfo> {
     skipProxy: true,
   });
   if (response.code === 200 && response.data) {
-    return response.data;
+    const data = response.data;
+    if (!data.user_name) {
+      data.user_name = data.username || '';
+    }
+    return data;
   }
   throw new Error(response.msg || '获取用户信息失败');
 }

package/generators/micro-react/templates/dev.preset.json

@@ -10,5 +10,5 @@
       "apps": ["layout"]
     }
   },
-  "default": "minimal"
+  "default": "full"
 }

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

@@ -32,6 +32,7 @@
   "devDependencies": {
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
+    "@sentry/webpack-plugin": "^4.9.1",
 		"@typescript-eslint/eslint-plugin": "^8.54.0",
 		"@typescript-eslint/parser": "^8.54.0",
     "dotenv-cli": "^7.4.1",

package/generators/micro-react/templates/scripts/apply-sentry-plugin.ts

@@ -0,0 +1,45 @@
+interface ApplySentryPluginOptions {
+  /** webpack-chain 实例（Umi chainWebpack 的参数） */
+  memo: any;
+  /** 应用名称，用于 urlPrefix 路径 */
+  appName: string;
+  /** Sentry project 名称，默认 '<%= projectName %>' */
+  project?: string;
+}
+
+/**
+ * 往 webpack-chain 配置上挂载 Sentry sourcemap 上传插件
+ */
+export function applySentryPlugin({
+  memo,
+  appName,
+  project = '<%= projectName %>',
+}: ApplySentryPluginOptions) {
+  const version = require('../package.json').version;
+
+  // 使用 Legacy Upload 方式，自托管 Sentry 不支持 Debug ID / Artifact Bundle
+  const { sentryWebpackPlugin } = require('@sentry/webpack-plugin');
+  memo.plugin('sentry').use(
+    class {
+      apply(compiler: any) {
+        sentryWebpackPlugin({
+          url: 'https://sentry.micoworld.net',
+          org: 'micocenter',
+          project,
+          /** @see https://micoworld.feishu.cn/wiki/AmXQwmnEairvQ9k2m9KcgJNcndv#share-OupCdqeeUoESO4x6YKPcrs4nn3c */
+          authToken: process.env.SENTRY_AUTH_TOKEN,
+          release: {
+            name: version,
+            uploadLegacySourcemaps: {
+              paths: ['./dist'],
+              urlPrefix: `~/portal-center/<%= projectName %>/${version}/${appName}`,
+            },
+          },
+          sourcemaps: {
+            disable: true,
+          },
+        }).apply(compiler);
+      }
+    },
+  );
+}

package/generators/subapp-react/index.js

@@ -118,12 +118,26 @@ module.exports = class extends Generator {
             if (!input.startsWith('@')) return 'Package scope must start with @';
             return true;
           }
+        },
+        {
+          type: 'input',
+          name: 'devPort',
+          message: 'Dev server port',
+          default: rc.devPort || '8010',
+          validate: (input) => {
+            const port = Number(input);
+            if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+              return 'Port must be an integer between 1024 and 65535';
+            }
+            return true;
+          }
         }
       ]);
 
       this.appName = toKebab(this.answers.appName);
       this.appNamePascal = toPascal(this.appName);
       this.packageScope = this.answers.packageScope;
+      this.devPort = this.answers.devPort;
       this.templateDir = this.templatePath('homepage');
       this.destDir = path.join(this.monorepoRoot, 'apps', this.appName);
     } catch (error) {
@@ -172,6 +186,7 @@ module.exports = class extends Generator {
         appName: this.appName,
         AppName: this.appNamePascal,
         packageScope: this.packageScope,
+        devPort: this.devPort,
         micoUiVersion: `^${micoUiVer}`,
         themeVersion: `^${themeVer}`,
         micoUiVersionExact: micoUiVer
@@ -206,7 +221,7 @@ module.exports = class extends Generator {
 
         for (const relPath of files) {
           const destRelPath = transformDestPath(relPath);
-          const isTemplate = isTemplateFile(relPath);
+          const isTemplate = isTemplateFile(relPath) || path.basename(relPath) === '.env';
           const tag = isTemplate ? '\x1b[32m[tpl]\x1b[0m' : '\x1b[36m[cpy]\x1b[0m';
           this.log(`   ${tag} apps/${this.appName}/${destRelPath}`);
 
@@ -243,7 +258,8 @@ module.exports = class extends Generator {
         const destRelPath = transformDestPath(relPath);
         const destPath = path.join(this.destDir, destRelPath);
 
-        if (isTemplateFile(relPath)) {
+        const isEnvFile = path.basename(relPath) === '.env';
+        if (isTemplateFile(relPath) || isEnvFile) {
           this.logger.file('template', destRelPath);
           this.fs.copyTpl(srcPath, destPath, templateData);
           templateCount++;
@@ -255,6 +271,10 @@ module.exports = class extends Generator {
       }
 
       this.logger.verbose(`Processed: ${templateCount} templates, ${copyCount} copied`);
+
+      this._updateDevPreset();
+      this._updateMockPages();
+      this._updateConfigDev();
     } catch (error) {
       console.error('');
       console.error('❌ Error during file generation:');
@@ -264,15 +284,182 @@ module.exports = class extends Generator {
     }
   }
 
+  _updateDevPreset() {
+    const presetPath = path.join(this.monorepoRoot, 'dev.preset.json');
+    if (!fs.existsSync(presetPath)) {
+      this.logger.verbose('dev.preset.json not found, skipping preset update');
+      return;
+    }
+
+    try {
+      const preset = JSON.parse(fs.readFileSync(presetPath, 'utf-8'));
+      const fullApps = preset.presets?.full?.apps;
+
+      if (!Array.isArray(fullApps)) {
+        this.logger.verbose('dev.preset.json has no full.apps array, skipping');
+        return;
+      }
+
+      if (fullApps.includes(this.appName)) {
+        this.logger.verbose(`"${this.appName}" already in full preset, skipping`);
+        return;
+      }
+
+      fullApps.push(this.appName);
+      fs.writeFileSync(presetPath, `${JSON.stringify(preset, null, 2)}\n`, 'utf-8');
+
+      this.log(`   📝 已将 "${this.appName}" 添加到 dev.preset.json 的 full 预设中`);
+    } catch (e) {
+      console.warn(`   ⚠️  更新 dev.preset.json 失败: ${e.message}`);
+    }
+  }
+
+  _updateMockPages() {
+    const pagesPath = path.join(this.monorepoRoot, 'apps/layout/mock/pages.ts');
+    if (!fs.existsSync(pagesPath)) {
+      this.logger.verbose('apps/layout/mock/pages.ts not found, skipping');
+      return;
+    }
+
+    try {
+      const content = fs.readFileSync(pagesPath, 'utf-8');
+
+      if (content.includes(`route: '/${this.appName}'`)) {
+        this.logger.verbose(`Route "/${this.appName}" already in mock pages, skipping`);
+        return;
+      }
+
+      // 找出已有的最大 id
+      const idMatches = [...content.matchAll(/id:\s*(\d+)/g)];
+      const maxId = idMatches.reduce((max, m) => Math.max(max, Number(m[1])), 0);
+
+      const newEntry = [
+        '  {',
+        `    id: ${maxId + 1},`,
+        `    name: '${this.appNamePascal}',`,
+        `    nameEn: '${this.appNamePascal}',`,
+        `    nameKey: 'page.${this.appName}',`,
+        `    route: '/${this.appName}',`,
+        `    htmlUrl: '//localhost:${this.devPort}',`,
+        '    jsUrls: [],',
+        '    cssUrls: [],',
+        "    prefixPath: '',",
+        "    routeMode: 'prefix',",
+        '    enabled: true,',
+        '    accessControlEnabled: false,',
+        '    adminOnly: false,',
+        '    routeKey: null,',
+        `    mainDocumentId: ${Math.floor(Math.random() * 900) + 100},`,
+        "    version: '',",
+        '  },',
+      ].join('\n');
+
+      // 插入到兜底路由 (route: '/*') 之前
+      const lines = content.split('\n');
+      let insertIdx = -1;
+
+      for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes("route: '/*'")) {
+          for (let j = i - 1; j >= 0; j--) {
+            if (lines[j].trim() === '{') {
+              insertIdx = j;
+              break;
+            }
+          }
+          break;
+        }
+      }
+
+      if (insertIdx === -1) {
+        const closingIdx = lines.findIndex((l) => l.trim() === '];');
+        if (closingIdx > 0) insertIdx = closingIdx;
+      }
+
+      if (insertIdx > 0) {
+        lines.splice(insertIdx, 0, newEntry);
+        fs.writeFileSync(pagesPath, lines.join('\n'), 'utf-8');
+        this.log(`   📝 已将 "${this.appName}" 的页面配置添加到 mock/pages.ts`);
+      }
+    } catch (e) {
+      console.warn(`   ⚠️  更新 mock/pages.ts 失败: ${e.message}`);
+    }
+  }
+
+  _updateConfigDev() {
+    const configPath = path.join(this.monorepoRoot, 'apps/layout/config/config.dev.ts');
+    if (!fs.existsSync(configPath)) {
+      this.logger.verbose('apps/layout/config/config.dev.ts not found, skipping');
+      return;
+    }
+
+    try {
+      const content = fs.readFileSync(configPath, 'utf-8');
+      const routeEntry = `'/${this.appName}/*'`;
+
+      if (content.includes(routeEntry)) {
+        this.logger.verbose(`Route "${routeEntry}" already in noPermissionRouteList, skipping`);
+        return;
+      }
+
+      const updated = content.replace(
+        /noPermissionRouteList:\s*\[([^\]]*)\]/,
+        (match, inner) => {
+          const trimmed = inner.trim();
+          const entries = trimmed ? `${trimmed}, ${routeEntry}` : routeEntry;
+          return `noPermissionRouteList: [${entries}]`;
+        },
+      );
+
+      if (updated === content) {
+        this.logger.verbose('noPermissionRouteList not found in config.dev.ts, skipping');
+        return;
+      }
+
+      fs.writeFileSync(configPath, updated, 'utf-8');
+      this.log(`   📝 已将 "${routeEntry}" 添加到 config.dev.ts 的 noPermissionRouteList 中`);
+    } catch (e) {
+      console.warn(`   ⚠️  更新 config.dev.ts 失败: ${e.message}`);
+    }
+  }
+
   install() {
     // 跳过 dry-run 模式
     if (this._skipInstall) return;
 
     this.log('');
     this.log('📦 正在安装依赖...');
-    this.spawnCommandSync('pnpm', ['install'], {
-      cwd: this.monorepoRoot
-    });
+    try {
+      this.spawnCommandSync('pnpm', ['install'], {
+        cwd: this.monorepoRoot
+      });
+    } catch (e) {
+      this._installFailed = true;
+      this.log('');
+      this.log('⚠️  依赖安装失败，但子应用文件已全部生成。');
+      this.logger.verbose('Install error:', e.message);
+      return;
+    }
+
+    // 依赖安装成功后，格式化被修改的 layout 文件
+    const layoutDir = path.join(this.monorepoRoot, 'apps/layout');
+    if (fs.existsSync(path.join(layoutDir, '.prettierrc'))) {
+      const filesToFormat = [
+        path.join(layoutDir, 'mock/pages.ts'),
+        path.join(layoutDir, 'config/config.dev.ts'),
+      ].filter((f) => fs.existsSync(f));
+
+      if (filesToFormat.length > 0) {
+        try {
+          this.spawnCommandSync(
+            'pnpm',
+            ['-C', 'apps/layout', 'exec', 'prettier', '--write', ...filesToFormat],
+            { cwd: this.monorepoRoot },
+          );
+        } catch (e) {
+          this.logger.verbose('Formatting failed (non-critical):', e.message);
+        }
+      }
+    }
   }
 
   end() {
@@ -280,7 +467,20 @@ module.exports = class extends Generator {
     if (this._skipInstall) return;
 
     this.log('');
-    this.log('✅ 子应用创建成功！');
+
+    if (this._installFailed) {
+      this.log('⚠️  子应用文件已创建，但依赖安装未完成。');
+      this.log('');
+      this.log('   请手动安装依赖:');
+      this.log('');
+      this.log('   pnpm install');
+      this.log('');
+      this.log('   如果安装仍然失败，可尝试:');
+      this.log('   pnpm install --network-concurrency 4');
+    } else {
+      this.log('✅ 子应用创建成功！');
+    }
+
     this.log('');
     this.log('   后续步骤:');
     this.log('');

package/generators/subapp-react/templates/homepage/.env

@@ -1,4 +1,5 @@
 # Default: 5
 CHECK_TIMEOUT=10
 DID_YOU_KNOW=none
-PORT=8010
+PORT=<%= devPort %>
+SOCKET_SERVER=http://localhost:<%= devPort %>

package/generators/subapp-react/templates/homepage/config/config.prod.development.ts

@@ -28,6 +28,7 @@ const config: ReturnType<typeof defineConfig> = {
     react: 'React',
     'react-dom': 'ReactDOM',
     '@mico-platform/ui': 'micoUI',
+    '@common-web/sentry': 'CommonWebSentry',
   },
 };
 

package/generators/subapp-react/templates/homepage/config/config.prod.testing.ts

@@ -28,6 +28,7 @@ const config: ReturnType<typeof defineConfig> = {
     react: 'React',
     'react-dom': 'ReactDOM',
     '@mico-platform/ui': 'micoUI',
+    '@common-web/sentry': 'CommonWebSentry',
   },
 };
 

package/generators/subapp-react/templates/homepage/config/config.prod.ts

@@ -1,6 +1,7 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+import { applySentryPlugin } from '../../../scripts/apply-sentry-plugin';
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
@@ -8,6 +9,11 @@ const PUBLIC_PATH: string = CDN_PUBLIC_PATH
   : '/<%= appName %>/';
 
 const config: ReturnType<typeof defineConfig> = {
+  /**
+   * 启用 Source Map（用于 Sentry 错误追踪）
+   * hidden-source-map 会生成 .map 文件但不在 JS 中添加 sourcemap 注释
+   */
+  devtool: 'hidden-source-map',
   // 生产环境：将所有代码打包到一个文件
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
@@ -17,6 +23,7 @@ const config: ReturnType<typeof defineConfig> = {
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;
   },
   publicPath: PUBLIC_PATH,
@@ -34,6 +41,7 @@ const config: ReturnType<typeof defineConfig> = {
     react: 'React',
     'react-dom': 'ReactDOM',
     '@mico-platform/ui': 'micoUI',
+    '@common-web/sentry': 'CommonWebSentry',
   },
 };
 

package/generators/subapp-react/templates/homepage/package.json

@@ -21,6 +21,7 @@
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
+    "@common-web/sentry": "^0.0.3",
     "@mico-platform/ui": "<%= micoUiVersion %>",
     "@types/react": "^18.0.33",
     "@types/react-dom": "^18.0.11",

package/generators/subapp-react/templates/homepage/src/app.tsx

@@ -7,7 +7,9 @@
  * 自定义函数请放在 @/common/mainApp.ts 中
  */
 
+import React from 'react';
 import { history } from '@umijs/max';
+import { SentryErrorBoundary } from '@common-web/sentry';
 import { appLogger } from './common/logger';
 import { type IMicroAppProps, setMainAppProps } from './common/mainApp';
 
@@ -95,3 +97,7 @@ export async function getInitialState() {
     name: '<%= appName %>',
   };
 }
+
+export function rootContainer(container: React.ReactNode) {
+  return <SentryErrorBoundary>{container}</SentryErrorBoundary>;
+}

package/generators/subapp-umd/ignore-list.json

@@ -0,0 +1,5 @@
+[
+  "node_modules",
+  "dist",
+  ".turbo"
+]