盘古用户平台（Pangu User Platform）
面向教育行业的统一用户管理系统
项目简介
盘古用户平台是一个基于 RuoYi-Vue 框架开发的教育行业用户管理系统，主要用于管理学校、教师、家长和学生信息，并为其他业务系统提供统一的用户认证和授权服务。
核心功能
- 学校管理：管理学校、年级、班级的树形组织结构
- 会员管理：管理前端用户（家长/教师），支持多种登录方式
- 学生管理：管理学生信息，支持批量导入
- 应用管理：管理第三方应用接入，控制API访问权限
- 基础数据：年级、班级、学科、区域等基础数据维护
- 系统设置：用户、角色、菜单、部门等系统管理（复用RuoYi）
角色权限
| 角色 |
权限范围 |
| 超级管理员 |
全部功能，管理所有数据 |
| 分公司用户 |
管理所属区域的学校、会员、学生 |
| 学校用户 |
管理本校的教师、学生 |
技术栈版本
前端技术栈
| 框架/库 |
当前版本 |
官方最新版本 |
说明 |
| Vue |
3.5.26 |
3.5.26 |
✅ 最新稳定版 |
| Vite |
7.3.1 |
7.3.1 |
✅ 最新稳定版 |
| Element Plus |
2.13.2 |
2.13.1 |
✅ 已是最新 |
| Pinia |
3.0.4 |
3.0.4 |
✅ 最新稳定版 |
| Vue Router |
4.6.4 |
4.6.4 (5.0.0刚发布) |
✅ 稳定版 |
| Axios |
1.13.4 |
1.13.4 |
✅ 最新稳定版 |
| MockJS |
1.1.0 |
1.1.0 |
✅ 用于Mock数据 |
| Node.js |
≥18.0.0 |
- |
运行环境要求 |
后端技术栈
| 框架/库 |
推荐版本 |
官方最新版本 |
说明 |
| Spring Boot |
3.3.x |
4.0.2 |
建议使用LTS版本 |
| Spring Security |
6.x |
6.4.x |
JWT认证 |
| MyBatis Plus |
3.5.x |
3.5.9 |
ORM框架 |
| MySQL |
8.0+ |
8.0.40 |
数据库 |
| Redis |
7.x |
7.4.x |
缓存/Session |
| JDK |
17+ |
21 LTS |
运行环境 |
基础框架
| 框架 |
版本 |
说明 |
| RuoYi-Vue |
3.8.8 |
后台管理框架 |
项目结构
pangu-user-platform/
├── docs/ # 项目文档
│ ├── 01-需求文档/ # 需求规格说明书
│ ├── 02-系统设计/ # 系统设计文档
│ ├── 03-数据库设计/ # 数据库设计文档
│ ├── 04-接口文档/ # 接口设计文档
│ └── 多Agent协同开发指南.md # 前端多Agent开发文档
├── pangu-ui/ # 前端工程 (Vue 3)
│ ├── src/
│ │ ├── api/ # API接口定义
│ │ ├── assets/ # 静态资源
│ │ ├── components/ # 公共组件
│ │ ├── layout/ # 布局组件
│ │ ├── mock/ # Mock数据
│ │ ├── router/ # 路由配置
│ │ ├── store/ # Pinia状态管理
│ │ ├── utils/ # 工具函数
│ │ └── views/ # 页面视图
│ ├── package.json
│ └── vite.config.js
├── ruoyi-backend/ # 后端工程 (待开发)
├── ruoyi-ui/ # RuoYi原版前端 (参考)
└── README.md
快速开始
环境要求
| 环境 |
版本要求 |
| Node.js |
≥18.0.0 |
| npm |
≥9.0.0 |
| JDK |
≥17 |
| Maven |
≥3.8 |
| MySQL |
≥8.0 |
| Redis |
≥7.0 |
前端启动（Mock模式）
# 1. 进入前端目录
cd pangu-ui
# 2. 安装依赖
npm install
# 3. 启动开发服务器
npm run dev
# 4. 访问
# http://localhost:3000
# 默认账号：admin / admin123
前端构建
# 生产环境构建
npm run build
# 预览构建结果
npm run preview
后端启动
# 1. 导入数据库
mysql -u root -p < sql/pangu_user.sql
# 2. 修改配置文件
# 编辑 application-druid.yml，配置数据库连接
# 3. 启动项目
mvn spring-boot:run
功能模块
| 模块 |
路由 |
状态 |
说明 |
| 登录 |
/login |
✅ 完成 |
用户名密码+验证码 |
| 首页 |
/dashboard |
✅ 完成 |
统计卡片 |
| 学校管理 |
/school |
✅ 完成 |
左侧区域树+右侧列表 |
| 会员管理 |
/member |
✅ 完成 |
家长/教师管理 |
| 学生管理 |
/student |
✅ 完成 |
左侧学校树+右侧列表 |
| 应用管理 |
/application |
✅ 完成 |
第三方应用接入 |
| 年级管理 |
/base/grade |
✅ 完成 |
基础数据 |
| 班级管理 |
/base/class |
✅ 完成 |
基础数据 |
| 学科管理 |
/base/subject |
✅ 完成 |
基础数据 |
| 区域管理 |
/base/region |
✅ 完成 |
树形表格 |
文档说明
| 文档 |
路径 |
说明 |
| 需求规格说明书 |
docs/01-需求文档/ |
详细功能需求，用于评审 |
| 系统设计文档 |
docs/02-系统设计/ |
架构设计、模块设计 |
| 数据库设计文档 |
docs/03-数据库设计/ |
表结构、ER图、初始数据 |
| 接口设计文档 |
docs/04-接口文档/ |
API接口规范 |
| 多Agent开发指南 |
docs/多Agent协同开发指南.md |
前端协同开发说明 |
原型设计
开发规范
代码规范
- 遵循《湖北新华业务中台代码规范》
- 类/方法使用Javadoc注释
- 使用统一的返回格式和异常处理
分支管理
| 分支 |
用途 |
| master |
主分支，生产环境代码 |
| develop |
开发分支 |
| feature/* |
功能分支 |
| hotfix/* |
紧急修复分支 |
提交规范
<type>: <简要描述>
类型说明：
- feat: 新功能
- fix: 修复Bug
- docs: 文档修改
- style: 代码格式调整
- refactor: 代码重构
- test: 测试相关
- chore: 构建/工具变动
版本更新日志
v1.0.0 (2026-01-31)
前端技术栈升级：
- Vue 3.5.24 → 3.5.26
- Vite 7.2.4 → 7.3.1
功能完成：
- 完成登录、首页、学校管理等10个功能模块
- 完成所有Mock数据和API接口定义
- 完成多Agent协同开发指南
仓库地址
联系方式
最后更新：2026-01-31
神码-方晓辉
ba1a62b7af