# ruoyi-uniapp

**Repository Path**: impressivel/ruoyi-uniapp

## Basic Information

- **Project Name**: ruoyi-uniapp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-11
- **Last Updated**: 2026-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Wujies Mobile —— 无界平台移动端

**wujies-mobile** · uni-app · 一套代码编译到 App / 微信小程序 / H5

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![uni-app](https://img.shields.io/badge/uni--app-Vue%203-2b9939.svg)]()
[![Vue](https://img.shields.io/badge/Vue-3-42b883.svg)]()

配套后端：[`wujies-platform`](https://gitee.com/impressivel/wujies-platform) · 插件仓库：[`wujies-plugins`](https://gitee.com/impressivel/wujies-plugins)

---

## 平台简介

Wujies 无界平台是一套 Spring Boot 3 + Vue 3 的**多租户管理平台**，核心特点是
**业务能力以「应用」为单位在运行期安装、升级、卸载，不需要重新构建或重启**。

**wujies-mobile** 是这个平台的**移动端**前端，基于 uni-app，
**一套代码同时编译到 App、微信小程序与 H5**。

### 技术栈

uni-app · Vue 3 · 自研请求封装（`src/utils/wujies.js`）

---

## 仓库一览

| 仓库 | 内容 |
|---|---|
| [`wujies-platform`](https://gitee.com/impressivel/wujies-platform) | 后端 + 应用市场 + 各应用的契约 |
| [`wujies-plugins`](https://gitee.com/impressivel/wujies-plugins) | 全部业务应用（插件）本体 + 本地开发沙箱 |
| [`wujies-admin`](https://gitee.com/impressivel/wujies-admin) | 管理端前端 + 远程应用前端工程 |
| [`wujies-shop`](https://gitee.com/impressivel/wujies-shop) | C 端（用户端）Web 前端 |
| **wujies-mobile**（本仓库） | 移动端（uni-app） |

---

## ⚠️ 接口路径：取决于"应用装没装"

这是接入本仓库时**最容易踩的坑**，务必先看这一节。

平台在设计上把 C 端接口**全部交给了应用（插件）**，宿主自身不持有任何 C 端控制器 ——
所以移动端调用的 `/open/**` 与 `/portal/**` 这些路径**不是平台自带的**，
而是由对应的应用提供的。

**这意味着**：

- 后端必须**先安装对应应用**（商城、会员、社交、考试…），否则这些接口会 **404**；
- 这是**刻意的架构调整**：宿主只服务管理端，C 端能力随应用走 ——
  这样加一个 C 端业务就是装一个应用，而不是改宿主、重新发版；
- 如果某个接口 404，**先确认对应应用装了没有**，再去查路径本身。

> 排查顺序：① 应用是否已安装并启用 → ② 应用版本是否包含该接口 → ③ 最后才查路径拼写。

---

## 快速开始

### 环境要求

Node.js 18+；用 HBuilderX 或 CLI 均可。

### 开发

```powershell
npm install

npm run dev:app         # App
npm run dev:mp-weixin   # 微信小程序
npm run dev:h5          # H5
```

### 打包

```powershell
npm run build:app
npm run build:mp-weixin
npm run build:h5
```

后端地址配在 `src/config.js`（按环境切换）。

---

## 目录结构

```
src/
  ├── config.js            接口地址与全局配置（改后端地址看这里）
  ├── manifest.json        应用名称 / 图标 / 各端配置
  ├── pages/               主包页面
  ├── pages_mine/          个人中心相关页面
  ├── components/          公共组件
  ├── utils/
  │     └── wujies.js      请求封装（对应其他前端仓库的 request 层）
  └── static/              静态资源
```

---

## 相关文档

| 文档 | 位置 |
|---|---|
| 平台总览 | [`wujies-platform`](https://gitee.com/impressivel/wujies-platform) README |
| 管理端与远程应用约定 | [`wujies-admin`](https://gitee.com/impressivel/wujies-admin) README |
| 插件开发全流程 | [`wujies-plugins`](https://gitee.com/impressivel/wujies-plugins) `docs/插件开发指南.md` |

---

## 许可

[MIT](LICENSE)。本项目是 RuoYi-Vue-Plus 5.X 的衍生作品，遵循 MIT 协议并保留原作者版权声明。