中国 帮助

工程结构

后台前端是标准的 Vue 3 + Vite 工程,外加一个平台特有的 plugins/appmarket/ 和 appmarketdist/。读这一页的目标是:知道新页面、新接口、新远程应用分别该放哪。 目录 text wujiesa

工程结构
封面

> 本文整理自平台文档 docs/wujies/5.x/frontends/admin/structure.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-696a320aeff2-cover.svg)

后台前端是标准的 Vue 3 + Vite 工程,外加一个平台特有的 plugins/appmarket/ 和 app-market-dist/。读这一页的目标是:知道新页面、新接口、新远程应用分别该放哪。

目录

wujies-admin/
├── index.html                  ★ import map(裸模块 → /app-runtime/*.js)
├── vite.config.ts              端口、/dev-api 代理、插件
├── .env.development            开发环境变量
├── app-market-dist/            ★ 远程应用产物(构建期复制进 dist)
│   ├── remote-apps/<appCode>/  index.js / index.css
│   └── app-runtime/            vue.js、element-plus.js、dromara-*.js
├── scripts/
│   ├── gen-runtime-shims.mjs   生成运行时垫片
│   ├── check-runtime-shims.mjs 校验垫片
│   ├── check-remote-apps.mjs   校验远程应用产物
│   └── check-remote-globals.mjs 校验 AutoImport 清单
└── src/
    ├── api/                    接口函数,按业务域分文件
    ├── assets/                 静态资源
    ├── components/             通用组件
    ├── layout/                 顶栏 / 侧边栏 / 标签页
    ├── plugins/
    │   ├── appmarket/          ★ 远程应用宿主(loader / runtime / bootstrap)
    │   └── ...                 全局插件
    ├── router/                 静态路由 + 动态菜单路由
    ├── store/                  Pinia(用户、权限、应用、设置)
    ├── utils/                  request / auth / 加密 / 下载
    └── views/                  页面
        ├── appstore/           应用市场、已安装、开发台、任务
        ├── member/             会员中心
        ├── dashboard/          工作台
        ├── system/             系统管理
        ├── monitor/            系统监控
        ├── workflow/           工作流
        └── ...

请求链路

页面组件
  → src/api/xxx.ts
    → src/utils/request.ts(axios 实例)
      → /dev-api/...(开发)或 VITE_APP_BASE_API 给的绝对地址(生产)
        → Vite / Nginx 代理
          → 后端 8086
  • 开发:vite.config.ts 把 VITE_APP_BASE_API(默认 /dev-api)代理到 http://127.0.0.1:8086,并去掉前缀;/site 也一并代理过去,让后端直出的公开页与后台同源(登录态存在 localStorage,按 origin 隔离)。
  • 生产:.env.production 当前把 VITE_APP_BASE_API 写成绝对地址 https://api.wujies.cn/v1/prod,由后端放开 CORS;要改回同域反代,用同文件里注释着的 /prod-api,再由 Nginx 转发到后端。
  • 加密:VITE_APP_ENCRYPT 打开时,请求与响应走 RSA;必须和后端同时开/关。

### 登录标记与回跳安全

平台关掉了 cookie 鉴权(common-satoken.yml 的 is-read-cookie: false)以杜绝 CSRF,token 只存 localStorage,任何情况下都不写进 cookie。

后端直出的前台页 /site/** 需要知道用户是否登录,靠一个名为 wujies-site-state 的标记 cookie。它不含凭据,值恒为 1,只表示这台浏览器在这个主机上登录过。用 cookie 而不用 localStorage 是因为 localStorage 按 origin 隔离、origin 含端口,开发态后台在 :80、前台在 :8086 是两个 origin,前台读不到;cookie 作用域只有域加 path、不含端口,正好跨得过去。生产上前后台同域,这条只为开发便利。标记有效期 30 天,每次开后台随登录态往前滑,过期只影响前台显示,不影响安全。

登录成功后的 ?redirect= 有两种来源:本站路由,和 CMS 主题带上的前台绝对地址(形如 https://域名/site/p/hello)。前台是后端直出的另一份页面,不在 SPA 路由表里,只能整页换页。绝对地址只认同一个主机,否则 ?redirect= 就是一枚开放重定向。比对只比 hostname 不比 origin,因为开发态后台与后端端口不同。回环地址的别名 localhost / 127.0.0.1 / ::1 / [::1] 视为同一台机器,生产同域放行不影响安全,仍只认回环,localhost.evil.com 对不上;//evil.com 这类协议相对地址当作外链拒绝。

新增一个页面

1. 在 src/views/<业务>/ 下新建 .vue; 2. 在 src/api/ 下补接口函数; 3. 菜单由后端 sys_menu 下发,component 填页面路径(宿主页面)或 remote:<appCode>/<viewKey>(远程应用页面); 4. 权限按钮由后端菜单的 perms 控制,页面里用 v-hasPermi / hasPermi 判断。

菜单里写 remote:exam/exam/settings 时,exam/exam/settings 只是视图键,不是 src/views 下的路径。真实代码在应用仓库 wujies-exam-plugin/frontend/src/views/ 里,由运行时 import() 加载。

新增一个远程应用(宿主侧)

宿主侧通常不需要改代码,只要产物到位:

1. 应用打包时把前端产物放到 app-market-dist/remote-apps/<appCode>/; 2. 后端返回的 GET /app/runtime/remote-apps 里带上 { appCode, entry }; 3. 菜单的 component 使用 remote:<appCode>/<viewKey>; 4. 刷新页面,loader.ts 会注册视图与路由。

如果产物是本地开发目录,可以用 WUJIES_FRONTEND_DIST 指过去,避免手工复制:

$env:WUJIES_FRONTEND_DIST = '<宿主根>\app-market-dist\remote-apps'

哪些文件不要动

文件原因
index.html 的 import map与运行时垫片、gen-runtime-shims.mjs 三方一致,改错会双 Vue
app-market-dist/app-runtime/*.js生成物;改源文件后重启 dev / 重新构建即可,也可 node scripts/gen-runtime-shims.mjs
src/plugins/appmarket/loader.ts 的加载契约影响所有远程应用,改前先读 [远程应用接入](/docs/wujies/5.x/frontends/admin/remote-app)
check-* 脚本它们是硬约定的守门人,不要为了让检查通过而放宽

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-696a320aeff2-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容