fangxh2013
/
pangu-user-platform
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
pangu-user-platform/README.md

4.9 KiB
Raw Blame History

盘古用户平台（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

访问地址

文档说明

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

原型设计

开发规范

代码规范

  • 遵循《湖北新华业务中台代码规范》
  • 类/方法使用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