Skip to content
当前页

快速使用本框架

请尽量不要改动基础框架

业务开发可以尽量在views下开发,如:views/upms upms相关的所有功能均在upms目录下完成, 否则可能会遇到前后端无法兼容、版本升级困难的问题。

如有需求对基础框架进行修改,请尽量将代码进行模块化处理。

如何启动项目

  • 升级 node 版本 16.13.x(如需使用 nvm 进行包管理,联系管理员)
  • 云桌面设置 registry:npm config set registry http://192.102.20.230:8081/repository/npm-public/
  • 在.npmrc 中添加 源(该源在 Devops 流水线中同样适用) registry=http://192.102.20.230:8081/repository/npm-public/
  • 全局安装 pnpm npm i -g pnpm(请勿在项目内安装 pnpm,可能会遇到问题)
    1. 安装依赖 pnpm install
    1. 运行 pnpm dev
    1. 打包 pnpm build
  • 使用Mock数据,配置.env.development中的VITE_MOCK=true,可以不依赖后端启动前端工程

微应用配置

主应用与微应用如何进行开发、部署(主应用和子应用共用一套权限管理体系)

主应用配置

  • 开发态.env.development
    • 开发态配置是否子应用 VITE_MICRO=false
  • 运行态.env.production
    • 运行态配置是否子应用 VITE_MICRO=false
  • 部署
    • 使用npm run build即可
    • 容器云配置ingress,域名如:cpvf-ui.com
      • / => xxx-ui:80
      • /sys => xxx-server:port
      • /sso => xxx-server:port
  • 添加子应用
    • 在/upms/micro-app路由下添加子应用信息 micro-app.png
    • 添加菜单 micro-menu.png
    • 子应用菜单结构
      ts
      {
          path: '/micro/vite',
          name: '',
          meta: {
              microPath: '/upms/dept'
          },
          type: '2'
      }

子应用配置

  • 开发态.env.development
    • 开发态配置是否子应用 VITE_MICRO=true
  • 运行态.env.micro(需要部署的二级目录)
    • 运行态配置是否子应用 VITE_MICRO=true
    • 静态资源地址() VITE_APP_STATIC_URL=abc
    • 构建资源公共路径 VITE_PUBLIC_PATH=/abc/
  • 部署
    • 使用npm run build-micro即可
    • 容器云配置ingress,域名如:cpvf-ui.com
      • /abc => xxx-micro-ui:80
  • 菜单配置
    • 无需配置:原理 => 子应用和主应用共用一套权限体系,只需要将主应用菜单的微应用path调整为真实路由即可共用
    • 菜单结构
      ts
      {
          path: '/upms/dept',
          name: '',
          meta: {
              microPath: '/upms/dept'
          },
          type: '0'
      }