pangu-user-platform/README.md

# 盘古用户平台（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模式）

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

# 2. 安装依赖
npm install

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

# 4. 访问
# http://localhost:3000
# 默认账号：admin / admin123
```

### 前端构建

```bash
# 生产环境构建
npm run build

# 预览构建结果
npm run preview
```

### 后端启动

```bash
# 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 | 前端协同开发说明     |

---

## 原型设计

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

---

## 开发规范

### 代码规范

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

---

## 仓库地址

- **Gitea**: http://47.99.144.51:3000/fangxh2013/pangu-user-platform

---

## 联系方式

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

---

*最后更新：2026-01-31*