基于SpringBoot的同城共享空间预约平台设计与实现

温馨提示本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片1. 项目背景与意义随着城市化进程的不断加快人们对办公、会议、活动等空间资源的需求日益多样化。传统空间租赁模式存在信息不透明、预约流程繁琐、资源利用率低等问题大量闲置空间无法得到有效利用。同城共享空间预约平台正是为解决这一痛点而设计通过互联网技术将城市中的闲置空间资源进行整合与共享为用户提供便捷的在线预约服务。本项目的设计与实现具有以下意义提升资源利用率将分散的闲置空间集中展示减少资源浪费提高空间使用效率。优化用户体验用户可在线浏览、筛选、预约空间简化传统线下沟通流程提升预约效率。促进共享经济发展推动同城空间资源共享为空间提供方和需求方搭建高效对接桥梁。提供技术实践参考基于 SpringBoot 的完整前后端分离实现为同类共享经济平台开发提供参考。2. 技术栈选型本平台采用前后端分离架构后端基于 SpringBoot 构建前端使用 Vue.js 配合 Element UI 组件库数据库选用 MySQL缓存层使用 Redis。整体技术栈选型如下层次技术选型说明后端框架SpringBoot 2.7.x快速构建独立运行的 Spring 应用简化配置持久层框架MyBatis-Plus简化 CRUD 操作内置分页插件支持代码生成数据库MySQL 8.0存储用户、空间、订单等核心业务数据缓存Redis缓存热点数据实现验证码存储与分布式会话安全认证Spring Security JWT实现用户认证与接口权限控制前端框架Vue.js 3 Element UI构建响应式单页应用提供丰富的 UI 组件接口文档Swagger / Knife4j自动生成在线接口文档便于前后端联调构建工具Maven统一管理项目依赖与构建流程3. 系统功能模块设计平台面向普通用户、空间提供方和管理员三类角色核心功能模块划分如下3.1 用户端功能用户注册与登录支持手机号验证码注册登录使用 JWT 进行身份认证。空间浏览与搜索按区域、类型、价格、容量等条件筛选空间支持关键词搜索。空间详情查看查看空间图片、设施配置、价格规则、可预约时段等详细信息。在线预约选择预约日期与时间段提交预约订单支持在线支付。订单管理查看预约记录、订单状态支持取消预约与申请退款。个人中心管理个人信息、收藏空间、查看历史订单与评价记录。3.2 提供方端功能空间管理发布、编辑、上下架自有空间维护空间基础信息与图片。时段设置配置空间可预约时段、价格规则与节假日安排。订单处理查看预约订单确认或拒绝预约请求处理退款申请。数据统计查看空间预约量、收入等经营数据。3.3 管理员端功能用户管理审核用户资质禁用违规账号。空间审核审核提供方发布的空间信息确保合规。订单监管查看全平台订单处理纠纷与投诉。系统配置管理公告、分类字典、支付参数等基础配置。4. 数据库设计系统核心数据表包括用户表、空间表、订单表、时段表、评价表等。以下为主要表结构设计4.1 用户表 t_user字段名类型说明idbigint主键自增phonevarchar(20)手机号唯一索引passwordvarchar(100)加密后的密码nicknamevarchar(50)昵称avatarvarchar(255)头像地址roletinyint角色1-用户2-提供方3-管理员statustinyint状态0-禁用1-正常create_timedatetime创建时间4.2 空间表 t_space字段名类型说明idbigint主键自增provider_idbigint提供方用户 IDnamevarchar(100)空间名称typevarchar(20)空间类型会议室、办公室、活动场地等addressvarchar(255)详细地址areadecimal(10,2)面积平方米capacityint可容纳人数pricedecimal(10,2)每小时价格descriptiontext空间描述statustinyint状态0-待审核1-已上架2-已下架4.3 订单表 t_order字段名类型说明idbigint主键自增order_novarchar(32)订单编号唯一user_idbigint下单用户 IDspace_idbigint预约空间 IDstart_timedatetime预约开始时间end_timedatetime预约结束时间total_amountdecimal(10,2)订单总金额statustinyint状态0-待支付1-已支付2-已取消3-已完成4-退款中create_timedatetime下单时间5. 核心功能实现5.1 用户认证与 JWT 登录平台使用 Spring Security 结合 JWT 实现无状态认证。用户登录成功后后端生成包含用户信息的 JWT Token 返回给前端前端在后续请求中携带 Token 访问受保护接口。核心实现如下Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Autowired private StringRedisTemplate redisTemplate; Autowired private JwtUtil jwtUtil; Override public LoginResponse login(LoginRequest request) { // 1. 校验验证码 String cachedCode redisTemplate.opsForValue().get(sms: request.getPhone()); if (cachedCode null || !cachedCode.equals(request.getCode())) { throw new BusinessException(验证码错误或已过期); } // 2. 查询用户不存在则自动注册 User user userMapper.selectByPhone(request.getPhone()); if (user null) { user new User(); user.setPhone(request.getPhone()); user.setNickname(用户 request.getPhone().substring(7)); user.setRole(1); user.setStatus(1); userMapper.insert(user); } // 3. 生成 JWT Token String token jwtUtil.generateToken(user.getId(), user.getRole()); LoginResponse response new LoginResponse(); response.setToken(token); response.setUserInfo(user); return response; } }5.2 空间预约与冲突校验预约功能是平台的核心业务。用户提交预约时后端需要校验所选时段是否与已有订单冲突避免同一空间同一时段被重复预约。核心实现如下Service public class OrderServiceImpl implements OrderService { Autowired private OrderMapper orderMapper; Autowired private SpaceMapper spaceMapper; Override Transactional(rollbackFor Exception.class) public Order createOrder(OrderCreateRequest request, Long userId) { // 1. 校验空间是否存在且已上架 Space space spaceMapper.selectById(request.getSpaceId()); if (space null || space.getStatus() ! 1) { throw new BusinessException(空间不存在或已下架); } // 2. 校验时间合法性 if (request.getStartTime().isAfter(request.getEndTime())) { throw new BusinessException(预约开始时间不能晚于结束时间); } // 3. 校验时段冲突 int conflictCount orderMapper.countConflict( request.getSpaceId(), request.getStartTime(), request.getEndTime() ); if (conflictCount 0) { throw new BusinessException(该时段已被预约请选择其他时间); } // 4. 计算订单金额 long hours Duration.between(request.getStartTime(), request.getEndTime()).toHours(); BigDecimal totalAmount space.getPrice().multiply(BigDecimal.valueOf(hours)); // 5. 创建订单 Order order new Order(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setSpaceId(space.getId()); order.setStartTime(request.getStartTime()); order.setEndTime(request.getEndTime()); order.setTotalAmount(totalAmount); order.setStatus(0); orderMapper.insert(order); return order; } private String generateOrderNo() { return SP System.currentTimeMillis() RandomUtil.randomNumbers(4); } }5.3 空间时段冲突查询 SQL时段冲突校验的核心 SQL 通过判断已有订单的时间区间与新增预约区间是否存在交集来实现具体如下select idcountConflict resultTypeint SELECT COUNT(*) FROM t_order WHERE space_id #{spaceId} AND status IN (0, 1) AND start_time #{endTime} AND end_time #{startTime} /select5.4 空间列表分页查询空间列表支持按区域、类型、价格区间等多条件组合筛选使用 MyBatis-Plus 分页插件实现高效分页查询Service public class SpaceServiceImpl implements SpaceService { Autowired private SpaceMapper spaceMapper; Override public PageResultSpaceVO querySpacePage(SpaceQueryRequest request) { // 构建分页参数 PageSpace page new Page(request.getPageNum(), request.getPageSize()); // 构建查询条件 LambdaQueryWrapperSpace wrapper new LambdaQueryWrapper(); wrapper.eq(Space::getStatus, 1); if (StringUtils.hasText(request.getKeyword())) { wrapper.like(Space::getName, request.getKeyword()); } if (StringUtils.hasText(request.getType())) { wrapper.eq(Space::getType, request.getType()); } if (request.getMinPrice() ! null) { wrapper.ge(Space::getPrice, request.getMinPrice()); } if (request.getMaxPrice() ! null) { wrapper.le(Space::getPrice, request.getMaxPrice()); } wrapper.orderByDesc(Space::getCreateTime); // 执行分页查询 PageSpace result spaceMapper.selectPage(page, wrapper); // 转换为 VO 并返回 PageResultSpaceVO pageResult new PageResult(); pageResult.setTotal(result.getTotal()); pageResult.setRecords(result.getRecords().stream() .map(this::convertToVO) .collect(Collectors.toList())); return pageResult; } }6. 系统架构设计平台整体采用前后端分离的 B/S 架构前端通过 RESTful API 与后端交互。后端按分层架构组织代码各层职责清晰、便于维护与扩展flowchart TD A[Vue.js 前端] --|HTTP / RESTful API| B[Nginx 反向代理] B -- C[SpringBoot 后端服务] C -- D[Controller 控制层] D -- E[Service 业务层] E -- F[Mapper 持久层] F -- G[(MySQL 数据库)] E -- H[(Redis 缓存)] C -- I[Spring Security JWT 认证] C -- J[Swagger 接口文档]后端项目采用标准分层结构主要包划分如下controller接收前端请求参数校验调用业务层并返回结果。service封装核心业务逻辑如预约校验、订单状态流转等。mapper基于 MyBatis-Plus 的数据访问层负责数据库读写。entity数据库表对应的实体类。vo / dto视图对象与数据传输对象隔离前端展示与后端存储结构。configSpring Security、Redis、Swagger 等配置类。common统一返回结果、异常处理、工具类等公共组件。7. 总结与展望本文围绕基于 SpringBoot 的同城共享空间预约平台从项目背景、技术选型、功能模块、数据库设计、核心代码实现和系统架构等方面进行了系统阐述。平台通过整合同城闲置空间资源为用户提供便捷的在线预约服务有效提升了空间资源利用率具有良好的应用价值。在后续迭代中平台可从以下方向持续优化智能推荐基于用户历史预约行为引入推荐算法为用户推荐更匹配的空间。信用评价体系完善用户与空间的双向评价机制建立信用积分体系提升平台信任度。消息通知接入