本项目是一个基于Spring Boot和Uniapp开发的毕业生档案查询小程序，旨在为毕业生提供便捷的档案查询服务，同时为学校管理员和档案操作员提供高效的档案管理工具。

## 技术栈

后端技术

 框架：Spring Boot

 持久层：MyBatis Plus

 数据库：MySQL

 缓存：Redis

 API风格：RESTful API

前端技术

 框架：Uniapp

 UI组件：uView UI

 页面路由：Vue Router

## 项目结构

```

grad_archive_system/

├── backend/              # 后端代码

│   ├── src/              # 源代码

│   │   ├── main/java/com/gradarchive/  # Java源代码

│   │   │   ├── config/   # 配置类

│   │   │   ├── controller/  # 控制器

│   │   │   ├── entity/   # 实体类

│   │   │   ├── mapper/   # 数据访问层

│   │   │   ├── service/  # 业务逻辑层

│   │   │   └── GradArchiveApplication.java  # 应用入口

│   │   └── resources/    # 资源文件

│   ├── pom.xml           # Maven配置文件

│   └── database.sql      # 数据库脚本

├── frontend/             # 前端代码

│   ├── pages/            # 页面文件

│   │   ├── login/        # 登录页面

│   │   ├── index/        # 首页

│   │   ├── archives/     # 档案查询页面

│   │   ├── profile/      # 个人中心页面

│   │   ├── records/      # 查询记录页面

│   │   ├── help/         # 帮助反馈页面

│   │   ├── admin/        # 管理员页面

│   │   └── operator/     # 操作员页面

│   ├── static/           # 静态资源

│   ├── uni_modules/      # 第三方模块

│   ├── App.vue           # 应用入口组件

│   ├── main.js           # 应用入口文件

│   ├── manifest.json     # 应用配置

│   ├── pages.json        # 页面配置

│   └── uni.scss          # 全局样式

├── requirements.md       # 需求文档

└── README.md             # 项目说明

```

## 功能模块

1. 公共模块

 用户登录：支持学生用户、操作员、管理员登录

 首页：系统概览、快速入口

 个人中心：用户信息管理

2. 学生用户模块

 档案查询：根据学号、姓名等信息查询个人档案状态和流转情况

 查询记录：查看历史查询记录

 反馈与帮助：提交问题反馈和获取帮助信息

3. 档案操作员模块

 学生信息管理：维护学生基本信息

 档案录入：录入学生档案信息

 流转节点管理：新增、编辑、删除档案流转节点

 批量录入：批量导入档案流转节点信息

4. 管理员模块

 用户管理：管理系统用户账号

 档案管理：管理所有学生档案信息

 流转节点管理：管理档案流转节点

 帮助反馈管理：处理用户提交的反馈信息

 数据统计：统计系统使用情况、档案查询情况等数据

## 环境要求

后端环境

 JDK 1.8+

 Maven 3.6+

 MySQL 5.7+

 Redis 5.0+

前端环境

 Node.js 10+

 HBuilderX

## 安装与部署

1. 后端部署

1. 克隆项目

   ```bash

   git clone <项目地址>

   cd grad_archive_system/backend

   ```

2. 配置数据库

    创建数据库 `grad_archive_system`

    执行 `database.sql` 脚本初始化数据库结构

    修改 `src/main/resources/application.yml` 中的数据库配置

3. 构建项目

   ```bash

   mvn clean package

   ```

4. 运行项目

   ```bash

   java jar target/gradarchivesystem.jar

   ```

2. 前端部署

1. 打开项目

    使用 HBuilderX 打开 `frontend` 目录

2. 配置API地址

    修改前端API调用地址，指向后端服务

3. 打包构建

    在 HBuilderX 中选择 "发行" > "网站  H5手机版"

    或选择其他平台进行打包

## 系统使用

1. 登录系统

 学生用户：使用学号和密码登录

 档案操作员：使用操作员账号登录

 管理员：使用管理员账号登录

2. 学生用户操作

 档案查询：进入"档案查询"页面，输入查询条件查询档案信息

 查询记录：进入"查询记录"页面，查看历史查询记录

 反馈与帮助：进入"反馈与帮助"页面，提交问题反馈

3. 档案操作员操作

 学生信息管理：进入"学生信息管理"页面，维护学生信息

 新增流转节点：进入"新增流转节点"页面，添加档案流转节点

 节点维护：进入"节点维护"页面，管理档案流转节点

 批量录入：进入"批量录入"页面，批量导入档案流转节点信息

4. 管理员操作

 用户管理：进入"用户管理"页面，管理系统用户

 档案管理：进入"档案管理"页面，管理所有学生档案

 流转节点管理：进入"流转节点管理"页面，管理档案流转节点

 帮助反馈管理：进入"帮助反馈管理"页面，处理用户反馈

 数据统计：进入"数据统计"页面，查看系统统计数据

## API文档

后端API基础路径

`http://localhost:8080/api`

主要API接口

#用户相关

 `POST /user/login`  用户登录

 `GET /user/info`  获取用户信息

 `PUT /user/update`  更新用户信息

#档案相关

 `GET /archive/query`  查询档案信息

 `POST /archive/add`  添加档案信息

 `PUT /archive/update`  更新档案信息

 `DELETE /archive/delete`  删除档案信息

#流转节点相关

 `GET /archive/node/list`  获取流转节点列表

 `POST /archive/node/add`  添加流转节点

 `PUT /archive/node/update`  更新流转节点

 `DELETE /archive/node/delete`  删除流转节点

#学生信息相关

 `GET /student/list`  获取学生列表

 `POST /student/add`  添加学生信息

 `PUT /student/update`  更新学生信息

 `DELETE /student/delete`  删除学生信

#帮助反馈相关

 `GET /help/list`  获取反馈列表

 `POST /help/add`  添加反馈

 `PUT /help/update`  更新反馈状态

## 注意事项

1. 数据库配置：确保修改 `application.yml` 中的数据库配置为正确的连接信息

2. Redis配置：确保Redis服务正常运行，并且配置正确

3. 前端API地址：确保前端API调用地址指向正确的后端服务

4. 权限管理：不同角色的用户拥有不同的操作权限，请确保使用正确的账号登录

## 开发指南

后端开发

1. 遵循Spring Boot开发规范

2. 使用MyBatis Plus进行数据库操作

3. 实现RESTful API接口

4. 编写单元测试

前端开发

1. 遵循Uniapp开发规范

2. 使用uView UI组件库

3. 实现响应式布局

4. 优化用户体验

## 许可证

本项目采用MIT许可证。