chore: 升级前端依赖到官方最新版本

- Vue 3.5.24 → 3.5.26
- Vite 7.2.4 → 7.3.1
- 更新README.md,添加详细技术栈版本说明
- 添加功能模块列表和版本更新日志
This commit is contained in:
神码-方晓辉 2026-01-31 16:52:01 +08:00
parent 8d8ca97e3d
commit ba1a62b7af
3 changed files with 127 additions and 89 deletions

184
README.md
View File

@ -27,26 +27,37 @@
--- ---
## 技术栈 ## 技术栈版本
### 后端 ### 前端技术栈
- Spring Boot 2.7.x | 框架/库 | 当前版本 | 官方最新版本 | 说明 |
- Spring Security + JWT | ---------------- | ------- | ---------------- | ---------- |
- MyBatis Plus 3.5.x | **Vue** | 3.5.26 | 3.5.26 | ✅ 最新稳定版 |
- MySQL 8.0 | **Vite** | 7.3.1 | 7.3.1 | ✅ 最新稳定版 |
- Redis 6.x | **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 | - | 运行环境要求 |
### 前端 ### 后端技术栈
- Vue 3.x | 框架/库 | 推荐版本 | 官方最新版本 | 说明 |
- Element Plus 2.x | ------------------- | ----- | ------ | ---------- |
- Pinia | **Spring Boot** | 3.3.x | 4.0.2 | 建议使用LTS版本 |
- Axios | **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.x | 框架 | 版本 | 说明 |
| ------------- | ----- | ------ |
| **RuoYi-Vue** | 3.8.8 | 后台管理框架 |
--- ---
@ -59,17 +70,23 @@ pangu-user-platform/
│ ├── 02-系统设计/ # 系统设计文档 │ ├── 02-系统设计/ # 系统设计文档
│ ├── 03-数据库设计/ # 数据库设计文档 │ ├── 03-数据库设计/ # 数据库设计文档
│ ├── 04-接口文档/ # 接口设计文档 │ ├── 04-接口文档/ # 接口设计文档
│ ├── 05-测试文档/ # 测试相关文档 │ └── 多Agent协同开发指南.md # 前端多Agent开发文档
│ └── 06-运维文档/ # 运维部署文档 ├── pangu-ui/ # 前端工程 (Vue 3)
├── pangu-admin/ # 后台管理模块 │ ├── src/
├── pangu-api/ # 移动端API模块 │ │ ├── api/ # API接口定义
├── pangu-open/ # 开放平台API模块 │ │ ├── assets/ # 静态资源
├── pangu-common/ # 公共模块 │ │ ├── components/ # 公共组件
├── pangu-framework/ # 框架核心 │ │ ├── layout/ # 布局组件
├── pangu-system/ # 系统模块 │ │ ├── mock/ # Mock数据
├── pangu-generator/ # 代码生成器 │ │ ├── router/ # 路由配置
├── pangu-ui/ # 前端工程 │ │ ├── store/ # Pinia状态管理
└── sql/ # 数据库脚本 │ │ ├── utils/ # 工具函数
│ │ └── views/ # 页面视图
│ ├── package.json
│ └── vite.config.js
├── ruoyi-backend/ # 后端工程 (待开发)
├── ruoyi-ui/ # RuoYi原版前端 (参考)
└── README.md
``` ```
--- ---
@ -78,31 +95,16 @@ pangu-user-platform/
### 环境要求 ### 环境要求
- JDK 1.8+ | 环境 | 版本要求 |
- Maven 3.6+ | ------- | ------- |
- MySQL 8.0+ | Node.js | ≥18.0.0 |
- Redis 6.0+ | npm | ≥9.0.0 |
- Node.js 16+ | JDK | ≥17 |
| Maven | ≥3.8 |
| MySQL | ≥8.0 |
| Redis | ≥7.0 |
### 后端启动 ### 前端启动Mock模式
```bash
# 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
```
### 前端启动
```bash ```bash
# 1. 进入前端目录 # 1. 进入前端目录
@ -113,24 +115,63 @@ npm install
# 3. 启动开发服务器 # 3. 启动开发服务器
npm run dev npm run dev
# 4. 访问
# http://localhost:3000
# 默认账号admin / admin123
``` ```
### 访问地址 ### 前端构建
- 后台管理http://localhost:80 ```bash
- 后端接口http://localhost:8080 # 生产环境构建
- Swagger文档http://localhost:8080/swagger-ui.html 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/01-需求文档/ | 详细功能需求,用于评审 |
| 系统设计文档 | docs/02-系统设计/ | 架构设计、模块设计 | | 系统设计文档 | docs/02-系统设计/ | 架构设计、模块设计 |
| 数据库设计文档 | docs/03-数据库设计/ | 表结构、ER图、初始数据 | | 数据库设计文档 | docs/03-数据库设计/ | 表结构、ER图、初始数据 |
| 接口设计文档 | docs/04-接口文档/ | API接口规范 | | 接口设计文档 | docs/04-接口文档/ | API接口规范 |
| 多Agent开发指南 | docs/多Agent协同开发指南.md | 前端协同开发说明 |
--- ---
@ -154,7 +195,7 @@ npm run dev
| 分支 | 用途 | | 分支 | 用途 |
| --------- | ---------- | | --------- | ---------- |
| main | 主分支,生产环境代码 | | master | 主分支,生产环境代码 |
| develop | 开发分支 | | develop | 开发分支 |
| feature/* | 功能分支 | | feature/* | 功能分支 |
| hotfix/* | 紧急修复分支 | | hotfix/* | 紧急修复分支 |
@ -176,37 +217,26 @@ npm run dev
--- ---
## 部署说明 ## 版本更新日志
### 单机部署 ### v1.0.0 (2026-01-31)
```bash **前端技术栈升级:**
# 1. 打包后端
mvn clean package -DskipTests
# 2. 上传jar包到服务器 - Vue 3.5.24 → 3.5.26
scp pangu-admin/target/pangu-admin.jar user@server:/app/ - Vite 7.2.4 → 7.3.1
# 3. 启动服务 **功能完成:**
nohup java -jar pangu-admin.jar --spring.profiles.active=prod > app.log 2>&1 &
# 4. 打包前端 - 完成登录、首页、学校管理等10个功能模块
cd pangu-ui - 完成所有Mock数据和API接口定义
npm run build:prod - 完成多Agent协同开发指南
# 5. 上传dist到Nginx目录 ---
scp -r dist/* user@server:/usr/share/nginx/html/
```
### Docker部署可选 ## 仓库地址
```bash - **Gitea**: http://47.99.144.51:3000/fangxh2013/pangu-user-platform
# 构建镜像
docker build -t pangu-user-platform:1.0 .
# 运行容器
docker run -d -p 8080:8080 --name pangu-api pangu-user-platform:1.0
```
--- ---

View File

@ -1,24 +1,27 @@
{ {
"name": "pangu-ui", "name": "pangu-ui",
"version": "0.0.0", "version": "1.0.0",
"lockfileVersion": 3, "lockfileVersion": 3,
"requires": true, "requires": true,
"packages": { "packages": {
"": { "": {
"name": "pangu-ui", "name": "pangu-ui",
"version": "0.0.0", "version": "1.0.0",
"dependencies": { "dependencies": {
"@element-plus/icons-vue": "^2.3.2", "@element-plus/icons-vue": "^2.3.2",
"axios": "^1.13.4", "axios": "^1.13.4",
"element-plus": "^2.13.2", "element-plus": "^2.13.2",
"mockjs": "^1.1.0", "mockjs": "^1.1.0",
"pinia": "^3.0.4", "pinia": "^3.0.4",
"vue": "^3.5.24", "vue": "^3.5.26",
"vue-router": "^4.6.4" "vue-router": "^4.6.4"
}, },
"devDependencies": { "devDependencies": {
"@vitejs/plugin-vue": "^6.0.1", "@vitejs/plugin-vue": "^6.0.1",
"vite": "^7.2.4" "vite": "^7.3.1"
},
"engines": {
"node": ">=18.0.0"
} }
}, },
"node_modules/@babel/helper-string-parser": { "node_modules/@babel/helper-string-parser": {

View File

@ -1,8 +1,10 @@
{ {
"name": "pangu-ui", "name": "pangu-ui",
"private": true, "private": true,
"version": "0.0.0", "version": "1.0.0",
"type": "module", "type": "module",
"description": "盘古用户平台 - 前端项目",
"author": "pangu",
"scripts": { "scripts": {
"dev": "vite", "dev": "vite",
"build": "vite build", "build": "vite build",
@ -14,11 +16,14 @@
"element-plus": "^2.13.2", "element-plus": "^2.13.2",
"mockjs": "^1.1.0", "mockjs": "^1.1.0",
"pinia": "^3.0.4", "pinia": "^3.0.4",
"vue": "^3.5.24", "vue": "^3.5.26",
"vue-router": "^4.6.4" "vue-router": "^4.6.4"
}, },
"devDependencies": { "devDependencies": {
"@vitejs/plugin-vue": "^6.0.1", "@vitejs/plugin-vue": "^6.0.1",
"vite": "^7.2.4" "vite": "^7.3.1"
},
"engines": {
"node": ">=18.0.0"
} }
} }