# RuoYi-App-Plus

**Repository Path**: super-stack/RuoYi-App-Plus

## Basic Information

- **Project Name**: RuoYi-App-Plus
- **Description**: 基于 uni-app + Vue3 + TypeScript 的移动端后台管理系统，是 RuoYi-Vue-Plus 的移动端解决方案。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2025-04-23
- **Last Updated**: 2025-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RuoYi Mobile Admin

基于 uni-app + Vue3 + TypeScript 的移动端后台管理系统，是 RuoYi-Vue-Plus 的移动端解决方案。

## 项目介绍

本项目是一个基于 uni-app 的移动端后台管理系统，支持多端部署（H5、App、小程序等），采用 Vue3 + TypeScript 开发，UI 风格统一美观，提供了完整的权限管理功能。

### 技术栈

- 前端框架：uni-app (Vue3 + TypeScript)
- 状态管理：Pinia + 持久化
- UI组件：uni-ui + 自定义组件
- HTTP请求：uni.request + 拦截器
- 路由管理：uni-app 内置路由 + 权限控制
- 工具支持：ESLint + Prettier + TypeScript

### 主要功能

1. 用户认证
   - 账号密码登录（支持验证码）
   - Token 验证和自动刷新
   - 记住密码和自动登录
   - 多端登录控制

2. 系统管理
   - 用户管理：用户信息的增删改查，状态管理，密码重置
   - 角色管理：角色权限分配，数据权限设置，菜单权限配置
   - 菜单管理：菜单树形展示，权限点管理，按钮权限配置
   - 部门管理：部门树形展示，组织架构管理
   - 岗位管理：岗位信息维护，岗位状态管理
   - 字典管理：系统中各种枚举字典维护

3. 个人中心
   - 基本资料：修改用户信息，更新个人设置
   - 修改密码：更新登录密码，安全设置
   - 头像上传：更换用户头像，图片裁剪

### 项目特点

1. 完整的权限系统
   - 基于角色的访问控制（RBAC）
   - 菜单权限和按钮权限控制
   - 数据权限和部门权限管理
   - 灵活的权限配置机制

2. 优秀的用户体验
   - 统一的UI风格和交互设计
   - 响应式布局，适配多种设备
   - 友好的操作提示和错误反馈
   - 平滑的动画过渡效果

3. 丰富的组件封装
   - XlamTree：树形选择组件
     - 支持展开/收起功能
     - 支持父子节点联动
     - 支持全选/反选功能
     - 自定义样式配置
   - 表单组件：统一的表单处理
   - 列表组件：上拉加载和下拉刷新

4. 完善的工具支持
   - TypeScript 类型支持和类型检查
   - 请求/响应拦截器和统一错误处理
   - 全局状态管理和持久化存储
   - 工具函数库和常用方法封装

## 开发指南

### 环境要求

- Node.js >= 14
- pnpm >= 6
- HBuilderX（推荐）

### 开发设置

1. 克隆项目

bash
git clone [项目地址]


2. 安装依赖

bash
pnpm install

3. 启动开发服务器

bash
H5
pnpm dev:h5
微信小程序
pnpm dev:mp-weixin


### 构建部署

1. 构建生产版本

bash
H5
pnpm build:h5
微信小程序
pnpm build:mp-weixin


2. 部署说明
   - 修改 src/config.ts 中的接口地址
   - 配置跨域代理（如需要）
   - 设置应用信息

### 开发规范

1. 代码规范
   - 使用 TypeScript 开发
   - 遵循 ESLint 规则
   - 使用 Prettier 格式化代码

2. 命名规范
   - 文件名：kebab-case
   - 组件名：PascalCase
   - 变量名：camelCase

3. 目录结构
   - api：接口请求
   - components：公共组件
   - pages：页面文件
   - stores：状态管理
   - utils：工具函数

4. Git 提交规范
   - feat：新功能
   - fix：修复
   - docs：文档
   - style：格式
   - refactor：重构
   - test：测试
   - chore：构建

## 常见问题

1. 跨域问题
   - 开发环境配置代理
   - 生产环境后端配置 CORS

2. 权限控制
   - 路由权限：permission.ts
   - 菜单权限：基于角色配置
   - 按钮权限：基于权限点

3. 性能优化
   - 按需加载
   - 图片懒加载
   - 合理的缓存策略
## 预览
![alt text](image.png)![alt text](image-1.png)![alt text](image-2.png)![alt text](image-3.png)![alt text](image-4.png)![alt text](image-5.png)![alt text](image-6.png)![alt text](image-7.png)

## 更新日志

### v0.1.0 (2024-11-22)

#### 新特性
- ✨ 完成基础框架搭建
- ✨ 实现用户登录和权限控制
- ✨ 完成首页和工作台页面
- ✨ 实现角色管理基础功能

#### 组件
- 🎨 新增 XlamTree 树形选择组件
  - 支持展开/收起功能
  - 支持父子节点联动
  - 支持全选/反选功能
  - 优化组件样式和交互

#### 优化
- 🔧 优化请求拦截器，完善错误处理
- 🔧 改进路由权限控制逻辑
- 🔧 优化用户信息管理
- 🔧 改进表单验证和提交逻辑

#### Bug 修复
- 🐛 修复登录状态判断问题
- 🐛 修复菜单树选择状态异常
- 🐛 修复角色管理页面数据加载问题

### v0.1.1 (2024-11-29)

#### 新特性
- ✨ 新增岗位管理功能
  - 支持岗位列表查询
  - 支持岗位新增/编辑
  - 支持岗位状态修改
  - 支持岗位删除操作

#### 优化
- 🔧 优化表单页面样式
- 🔧 改进列表页加载状态
- 🔧 统一表单验证规则

#### Bug 修复
- 🐛 修复状态切换问题
- 🐛 修复表单重置问题

### 后续计划
- [ ] 完善用户管理功能
- [ ] 添加部门管理模块
- [ ] 实现字典管理功能
- [ ] 优化移动端适配
- [ ] 添加更多自定义组件
- [ ] 提升整体性能和用户体验

## 贡献指南

1. Fork 本仓库
2. 创建特性分支
3. 提交代码
4. 创建 Pull Request

## 许可证

[MIT](LICENSE)