多端前端
前端开发
平台的前端不是「一个大前端」,而是按使用场景拆开的四个独立工程。它们共用同一套后端接口与登录体系,但构建、部署、发布节奏互不影响。
前端矩阵
| 工程 | 场景 | 技术栈 | 开发端口 | 源码目录 |
|---|---|---|---|---|
| wujies-admin | 后台管理 | Vue 3 + TypeScript + Element Plus + Vite 6 | 80 | plus-ui/ |
| wujies-shop | PC 用户端 | Vue 3 + TypeScript + Element Plus + Vite 6 | 4230 | plus-c/ |
| wujies-mobile(H5) | 手机浏览器 | uni-app + Vue 3 | Vite 默认端口 | ruoyi-uniapp/ |
| wujies-mobile(App / 小程序) | Android / iOS / 微信小程序 | uni-app + Vue 3 | — | ruoyi-uniapp/ |
H5、App、小程序是同一套 uni-app 代码的不同编译目标,所以放在同一个仓库里;文档按端拆开,是因为构建、调试和发布流程差别很大。
三者怎么分工
- 后台管理(wujies-admin):平台底座功能 + 应用市场 + 插件开发台。它还承担一件平台特有的事:在运行期加载远程应用的前端产物。
- PC 用户端(wujies-shop):面向终端消费者的 Web,商城、会员、社交、IM、考试、图床等页面都在这里。
- 移动端(wujies-mobile):同一套 uni-app 代码编译到 H5、App 与各家小程序。

前端矩阵与后端关系(示意图占位)
/images/docs/frontend-matrix.png可画:四个前端工程 → Nginx / 静态站;wujies-admin 额外通过 import map 加载远程应用 ESM。
共同约定
- 后端只有一个地址:开发环境默认
http://127.0.0.1:8086,由 Vite 代理/dev-api转发。 - C 端接口随应用走:
/open/**、/portal/**由已安装应用提供,平台宿主不自带;接口 404 先查应用装没装。 - 后台前端是远程应用的宿主:应用前端产物必须按
appCode输出,入口带?v=<version>,裸模块走 import map 垫片。 - 四个工程各自构建、各自部署:没有统一的 monorepo 构建脚本,也没有「一次构建全部」。
从哪里开始
- 第一次跑后台:后台管理 · 快速开始
- 想改远程应用加载:后台管理 · 远程应用接入
- 跑 PC 用户端:PC 用户端 · 快速开始
- 跑 H5:H5 端 · 快速开始
- 打 App / 小程序:App 端 · 打包发布 · 小程序端