社区维修服务平台:基于Spring Boot与Vue的全栈实现方案
社区维修服务平台:基于Spring Boot与Vue的全栈实现方案
系统架构概述
本社区维修服务平台采用前后端分离架构,后端使用Spring Boot框架构建RESTful API,前端采用Vue.js框架实现用户界面,同时支持uniapp实现跨平台移动端应用。系统通过MyBatis-Plus作为持久层框架,实现高效的数据访问与操作。
技术栈详解
后端框架:Spring Boot
Spring Boot简化了Java应用的开发过程,通过内嵌Web服务器(如Tomcat、Jetty或Undertow)实现了零配置部署。其核心优势在于自动配置机制,能够根据项目依赖自动调整应用配置,大幅减少手动配置的工作量。Spring Boot还提供了丰富的开箱即用功能,包括Spring Data、Spring Security和Spring Cloud等,加速了企业级应用的开发进程。
前端框架:Vue.js
Vue.js采用虚拟DOM技术,通过响应式数据绑定实现高效的UI更新。其组件化架构使开发者能够构建可复用、可维护的用户界面。Vue的数据驱动特性让开发者能够专注于业务逻辑处理,而无需手动操作DOM,从而提高了开发效率和应用性能。
持久层框架:MyBatis-Plus
MyBatis-Plus作为MyBatis的增强工具,提供了丰富的API和注解,简化了数据访问层的开发。它支持多种数据库,包括MySQL、Oracle、SQL Server和PostgreSQL等。MyBatis-Plus的代码生成器可以自动创建实体类、Mapper接口和XML映射文件,显著提升开发效率。此外,它还提供了分页查询、动态SQL、乐观锁和性能分析等实用功能,满足复杂数据操作需求。
系统功能设计
社区维修服务平台主要包含以下功能模块:
- 用户管理:支持多角色用户(管理员、维修人员、普通用户)的注册、登录、信息管理
- 维修服务:发布维修需求、选择维修人员、跟踪维修进度
- 评价系统:对维修服务进行评分和评价
- 通知系统:实时推送维修状态更新和系统通知
核心代码实现
用户认证与授权
@IgnoreAuth
@PostMapping("/auth/login")
public ResponseResult login(String username, String password, String captcha, HttpServletRequest request) {
UserEntity user = userService.queryOne(new QueryWrapper<UserEntity>().eq("username", username));
if(user == null || !user.getPassword().equals(password)) {
return ResponseResult.fail("账号或密码不正确");
}
String token = authService.generateToken(user.getId(), username, "users", user.getRole());
return ResponseResult.success().put("token", token);
}
@Override
public String generateToken(Long userId, String username, String tableName, String role) {
TokenEntity tokenEntity = this.getOne(new QueryWrapper<TokenEntity>()
.eq("user_id", userId)
.eq("role", role));
String token = TokenUtil.generateRandomToken(32);
Calendar cal = Calendar.getInstance();
cal.setTime(new Date());
cal.add(Calendar.HOUR_OF_DAY, 1);
if(tokenEntity != null) {
tokenEntity.setToken(token);
tokenEntity.setExpiryTime(cal.getTime());
this.updateById(tokenEntity);
} else {
this.save(new TokenEntity(userId, username, tableName, role, token, cal.getTime()));
}
return token;
}
权限拦截器
@Component
public class AuthInterceptor implements HandlerInterceptor {
public static final String AUTH_TOKEN_HEADER = "X-Auth-Token";
@Autowired
private TokenService tokenService;
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 支持跨域请求
response.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS, DELETE");
response.setHeader("Access-Control-Max-Age", "3600");
response.setHeader("Access-Control-Allow-Credentials", "true");
response.setHeader("Access-Control-Allow-Headers",
"x-requested-with,request-source,X-Auth-Token, Origin,Content-Type, cache-control");
response.setHeader("Access-Control-Allow-Origin", request.getHeader("Origin"));
// 处理OPTIONS请求
if (request.getMethod().equals(RequestMethod.OPTIONS.name())) {
response.setStatus(HttpStatus.OK.value());
return false;
}
// 检查方法是否需要跳过认证
SkipAuth annotation;
if (handler instanceof HandlerMethod) {
annotation = ((HandlerMethod) handler).getMethodAnnotation(SkipAuth.class);
} else {
return true;
}
// 从header中获取token
String token = request.getHeader(AUTH_TOKEN_HEADER);
// 不需要验证权限的方法直接放过
if(annotation != null) {
return true;
}
TokenEntity tokenEntity = null;
if(StringUtils.isNotBlank(token)) {
tokenEntity = tokenService.getTokenByValue(token);
}
if(tokenEntity != null) {
request.getSession().setAttribute("userId", tokenEntity.getUserId());
request.getSession().setAttribute("role", tokenEntity.getRole());
request.getSession().setAttribute("tableName", tokenEntity.getTableName());
request.getSession().setAttribute("username", tokenEntity.getUsername());
return true;
}
// 返回未登录错误
response.setCharacterEncoding("UTF-8");
response.setContentType("application/json; charset=utf-8");
try {
response.getWriter().print(JsonUtil.toJsonString(ResponseResult.fail(401, "请先登录")));
} finally {
response.getWriter().close();
}
return false;
}
}
数据库设计
用户认证表
-- ----------------------------
-- Table structure for authentication_tokens
-- ----------------------------
DROP TABLE IF EXISTS `authentication_tokens`;
CREATE TABLE `authentication_tokens` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
`user_id` bigint(20) NOT NULL COMMENT '用户ID',
`username` varchar(100) NOT NULL COMMENT '用户名',
`table_name` varchar(100) DEFAULT NULL COMMENT '关联表名',
`role` varchar(100) DEFAULT NULL COMMENT '用户角色',
`token` varchar(200) NOT NULL COMMENT '认证令牌',
`create_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`expiry_time` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00' COMMENT '过期时间',
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8 ROW_FORMAT=COMPACT COMMENT='认证令牌表';
维修服务表
-- ----------------------------
-- Table structure for repair_services
-- ----------------------------
DROP TABLE IF EXISTS `repair_services`;
CREATE TABLE `repair_services` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
`title` varchar(100) NOT NULL COMMENT '服务标题',
`description` text COMMENT '服务描述',
`category_id` bigint(20) NOT NULL COMMENT '服务分类ID',
`requester_id` bigint(20) NOT NULL COMMENT '请求者ID',
`provider_id` bigint(20) DEFAULT NULL COMMENT '服务提供者ID',
`status` tinyint(4) DEFAULT '0' COMMENT '状态:0-待处理,1-处理中,2-已完成,3-已取消',
`address` varchar(255) NOT NULL COMMENT '服务地址',
`contact_phone` varchar(20) NOT NULL COMMENT '联系电话',
`appointment_time` datetime DEFAULT NULL COMMENT '预约时间',
`completion_time` datetime DEFAULT NULL COMMENT '完成时间',
`create_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ROW_FORMAT=COMPACT COMMENT='维修服务表';
系统测试
功能测试
系统测试主要采用黑盒测试方法,通过模拟用户操作验证各个功能模块的正确性。测试内容包括用户登录、权限验证、维修服务发布与处理等核心功能。
登录功能测试用例
| 输入数据 | 预期结果 | 实际结果 | 结果分析 |
|---|---|---|---|
| 用户名:admin 密码:123456 验证码:正确 |
登录成功 | 成功登录系统 | 符合预期 |
| 用户名:admin 密码:111111 验证码:正确 |
密码错误提示 | 显示密码错误信息 | 符合预期 |
| 用户名:admin 密码:123456 验证码:错误 |
验证码错误提示 | 显示验证码错误信息 | 符合预期 |
维修服务测试用例
| 测试场景 | 预期结果 | 实际结果 | 结果分析 |
|---|---|---|---|
| 发布新的维修服务 | 服务成功创建 | 服务列表显示新记录 | 符合预期 |
| 选择维修人员 | 状态更新为处理中 | 状态正确更新 | 符合预期 |
| 完成维修服务 | 状态更新为已完成 | 状态正确更新 | 符合预期 |
部署指南
环境要求
- Java 8 或更高版本
- MySQL 5.7 或更高版本
- Node.js 12 或更高版本
- Maven 3.6 或更高版本
后端部署步骤
- 克隆项目代码到本地
- 配置数据库连接信息
- 执行数据库初始化脚本
- 使用Maven构建项目:
mvn clean package - 运行生成的jar文件:
java -jar target/community-repair-platform.jar
前端部署步骤
- 进入前端项目目录
- 安装依赖:
npm install - 修改API接口地址配置
- 构建项目:
npm run build - 将dist目录下的文件部署到Web服务器