盘古用户平台（Pangu User Platform）

面向教育行业的统一用户管理系统

---

项目简介

盘古用户平台是一个基于 RuoYi-Vue 框架开发的教育行业用户管理系统，主要用于管理学校、教师、家长和学生信息，并为其他业务系统提供统一的用户认证和授权服务。

核心功能

• 学校管理：管理学校、年级、班级的树形组织结构
• 会员管理：管理前端用户（家长/教师），支持多种登录方式
• 学生管理：管理学生信息，支持批量导入
• 应用管理：管理第三方应用接入，控制API访问权限
• 基础数据：年级、班级、学科、区域等基础数据维护
• 系统设置：用户、角色、菜单、部门等系统管理（复用RuoYi）

角色权限

角色	权限范围
超级管理员	全部功能，管理所有数据
分公司用户	管理所属区域的学校、会员、学生
学校用户	管理本校的教师、学生

---

技术栈

后端

• Spring Boot 2.7.x
• Spring Security + JWT
• MyBatis Plus 3.5.x
• MySQL 8.0
• Redis 6.x

前端

• Vue 3.x
• Element Plus 2.x
• Pinia
• Axios

基础框架

• RuoYi-Vue 3.8.x

---

项目结构

pangu-user-platform/
├── docs/                           # 项目文档
│   ├── 01-需求文档/                 # 需求规格说明书
│   ├── 02-系统设计/                 # 系统设计文档
│   ├── 03-数据库设计/               # 数据库设计文档
│   ├── 04-接口文档/                 # 接口设计文档
│   ├── 05-测试文档/                 # 测试相关文档
│   └── 06-运维文档/                 # 运维部署文档
├── pangu-admin/                    # 后台管理模块
├── pangu-api/                      # 移动端API模块
├── pangu-open/                     # 开放平台API模块
├── pangu-common/                   # 公共模块
├── pangu-framework/                # 框架核心
├── pangu-system/                   # 系统模块
├── pangu-generator/                # 代码生成器
├── pangu-ui/                       # 前端工程
└── sql/                            # 数据库脚本

---

快速开始

环境要求

• JDK 1.8+
• Maven 3.6+
• MySQL 8.0+
• Redis 6.0+
• Node.js 16+

后端启动

# 1. 克隆项目
git clone https://your-repo/pangu-user-platform.git

# 2. 导入数据库
mysql -u root -p < sql/pangu_user.sql

# 3. 修改配置文件
# 编辑 pangu-admin/src/main/resources/application-druid.yml
# 修改数据库连接信息

# 4. 启动项目
cd pangu-admin
mvn spring-boot:run

前端启动

# 1. 进入前端目录
cd pangu-ui

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev

访问地址

• 后台管理：http://localhost:80
• 后端接口：http://localhost:8080
• Swagger文档：http://localhost:8080/swagger-ui.html

---

文档说明

文档	路径	说明
需求规格说明书	docs/01-需求文档/	详细功能需求，用于评审
系统设计文档	docs/02-系统设计/	架构设计、模块设计
数据库设计文档	docs/03-数据库设计/	表结构、ER图、初始数据
接口设计文档	docs/04-接口文档/	API接口规范

---

原型设计

• 墨刀原型：https://modao.cc/proto/atlwMul8t9pi6yxQ42W7up/sharing
• 页面数量：17个
• 访问方式：只读模式

---

开发规范

代码规范

• 遵循《湖北新华业务中台代码规范》
• 类/方法使用Javadoc注释
• 使用统一的返回格式和异常处理

分支管理

分支	用途
main	主分支，生产环境代码
develop	开发分支
feature/*	功能分支
hotfix/*	紧急修复分支

提交规范

<type>: <简要描述>

类型说明：
- feat: 新功能
- fix: 修复Bug
- docs: 文档修改
- style: 代码格式调整
- refactor: 代码重构
- test: 测试相关
- chore: 构建/工具变动

---

部署说明

单机部署

# 1. 打包后端
mvn clean package -DskipTests

# 2. 上传jar包到服务器
scp pangu-admin/target/pangu-admin.jar user@server:/app/

# 3. 启动服务
nohup java -jar pangu-admin.jar --spring.profiles.active=prod > app.log 2>&1 &

# 4. 打包前端
cd pangu-ui
npm run build:prod

# 5. 上传dist到Nginx目录
scp -r dist/* user@server:/usr/share/nginx/html/

Docker部署（可选）

# 构建镜像
docker build -t pangu-user-platform:1.0 .

# 运行容器
docker run -d -p 8080:8080 --name pangu-api pangu-user-platform:1.0

---

联系方式

• 团队：pangu
• 创建时间：2026-01-31

---

最后更新：2026-01-31