Skip to content

DEPLOY.md

Latest commit

 

History

History
162 lines (130 loc) · 3.99 KB

DEPLOY.md

File metadata and controls

162 lines (130 loc) · 3.99 KB

事业单位综合管理系统 - 部署运行说明

一、环境准备

1. 后端环境

  • JDK 1.8 或 17
  • Maven 3.8+
  • MySQL 8.0+

2. 前端环境

  • Node.js 16+
  • npm 7+

二、数据库初始化

  1. 启动 MySQL 服务

  2. 登录 MySQL 命令行或可视化工具（如 Navicat）

  3. 执行 sql/init.sql 脚本，创建数据库和初始化数据：

    mysql -u root -p < sql/init.sql

    或在 MySQL 客户端中直接执行脚本内容

  4. 验证数据库是否创建成功：

    • 数据库名：admin_system

三、后端启动

1. 编译打包

# 进入后端项目根目录
cd /Users/chenxi/Documents/毕设_管理系统

# 编译打包
mvn clean package

2. 运行 jar 包

# 运行 jar 包
java -jar target/admin-system-1.0.0.jar

# 或者直接运行（开发环境）
mvn spring-boot:run

3. 验证后端服务

  • 后端服务默认运行在 http://localhost:8080
  • 可以通过访问 http://localhost:8080/api/user/login 验证服务是否启动成功

四、前端启动

1. 安装依赖

# 进入前端项目目录
cd /Users/chenxi/Documents/毕设_管理系统/front

# 安装依赖
npm install

2. 启动开发服务器

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

3. 访问前端应用

  • 前端应用默认运行在 http://localhost:5173
  • 打开浏览器访问 http://localhost:5173 即可进入登录页面

五、登录测试

1. 管理员账号

  • 用户名：admin
  • 密码：admin123

2. 普通用户账号

  • 用户名：user
  • 密码：user123

六、功能测试

1. 权限测试

  • 管理员登录后，可以进行所有模块的增删改查操作
  • 普通用户登录后，只能查看数据，无法进行修改操作

2. 模块测试

测试每个模块的以下功能：

  • 新增功能
  • 编辑功能
  • 删除功能
  • 分页功能
  • 搜索功能

七、技术栈说明

后端

  • Spring Boot 2.7.18
  • MyBatis-Plus 3.5.3.1
  • MySQL 8.0.30

前端

  • Vue 3.5.30
  • Element Plus 2.4.2
  • Axios 1.5.0
  • Vue Router 5.0.4
  • Vite 8.0.1

八、注意事项

  1. 确保 MySQL 服务正在运行
  2. 配置数据库连接信息：
    • 修改 src/main/resources/application.yml 文件中的数据库连接信息
    • 配置示例： 
      spring:
  datasource:
    url: jdbc:mysql://localhost:3306/admin_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
  3. 前端默认访问后端地址为 http://localhost:8080/api，如果后端服务地址或端口有变化，需要修改前端 main.js 中的 axios.defaults.baseURL
  4. 本系统使用简单的登录认证，实际生产环境建议使用更安全的认证方式
  5. 系统已经预置了一些测试数据，可以直接登录使用

九、项目结构

后端项目结构

admin-system/
├── src/
│   ├── main/
│   │   ├── java/com/example/adminsystem/
│   │   │   ├── controller/     # 控制器
│   │   │   ├── entity/          # 实体类
│   │   │   ├── mapper/          # Mapper接口
│   │   │   ├── service/         # 服务层
│   │   │   ├── common/          # 通用类
│   │   │   └── AdminSystemApplication.java  # 应用主类
│   │   └── resources/
│   │       └── application.yml  # 配置文件
├── sql/
│   └── init.sql                 # 数据库初始化脚本
├── pom.xml                      # Maven配置文件
└── README.md                    # 项目说明文档

前端项目结构

admin-system/front/
├── src/
│   ├── views/           # 页面组件
│   ├── router/          # 路由配置
│   ├── main.js          # 应用入口
│   └── App.vue          # 根组件
├── package.json         # 依赖配置
└── vite.config.js       # Vite配置