> 本文整理自平台文档 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)


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