基于Spring Boot的健康体检预约与管理网站的设计与实现​

一、项目背景与意义随着社会发展和生活水平提高人们对健康管理的需求日益增长定期体检已成为现代人预防疾病、保障健康的重要手段。然而传统的体检预约方式存在诸多痛点流程繁琐用户需电话咨询、现场排队耗时耗力。信息不透明体检套餐、价格、医生排班等信息难以实时获取。管理不便体检报告多为纸质不易保存和追踪历史数据。资源调配低效体检中心难以预测每日预约量导致资源闲置或拥挤。因此开发一个基于Web的健康体检预约与管理平台实现线上预约、套餐选择、报告查询、健康档案管理等一站式服务具有重要的现实意义。本项目旨在通过Spring Boot技术栈构建一个高效、稳定、易用的健康体检管理系统提升用户体验和机构运营效率。二、技术栈选型2.1 后端技术栈Spring Boot 2.7.x快速构建企业级应用简化配置内嵌Tomcat。Spring MVCWeb层框架处理HTTP请求和响应。Spring Data JPA简化数据库操作实现ORM映射。Spring Security负责用户认证与授权保障系统安全。MySQL 8.0关系型数据库存储用户、预约、套餐、报告等核心数据。Redis用作缓存提升热点数据如套餐信息、医生排班查询速度并存储会话信息。Maven项目构建与依赖管理。2.2 前端技术栈Thymeleaf服务端模板引擎与Spring Boot无缝集成用于渲染动态页面。HTML5 / CSS3构建页面结构与样式。JavaScript (ES6)实现页面交互逻辑。Bootstrap 5响应式前端框架快速构建美观、兼容多设备的UI。jQuery / Axios简化AJAX请求实现前后端数据异步交互。2.3 开发与部署工具IntelliJ IDEA集成开发环境。Git版本控制。Docker (可选)容器化部署实现环境一致性。三、系统核心功能模块设计3.1 用户端功能用户注册与登录支持手机号/邮箱注册Spring Security实现密码加密存储与登录验证。体检套餐浏览与筛选按性别、年龄、价格、项目分类展示套餐详情。在线预约选择套餐、体检日期、时间段提交预约订单。订单管理查看预约记录、订单状态待支付、已预约、已完成、已取消支持取消预约。报告查询查看历史体检报告PDF/HTML格式支持报告解读与指标趋势图。个人健康档案汇总历次体检关键指标生成健康趋势分析。消息通知预约成功、报告生成等通过站内信或短信通知。3.2 管理端功能仪表盘展示今日预约数、月度统计、热门套餐等数据可视化图表。用户管理查看、禁用/启用用户账户。套餐管理CRUD操作设置套餐包含项目、价格、适用人群。医生与排班管理管理医生信息设置每日可预约时间段与人数上限。预约订单管理审核、确认、取消用户预约导出预约报表。报告管理上传、审核、发布用户体检报告。系统配置如短信模板、通知开关、基础参数设置。四、数据库核心表设计部分-- 用户表 CREATE TABLE user ( id bigint PRIMARY KEY AUTO_INCREMENT, username varchar(50) UNIQUE NOT NULL COMMENT 用户名, password varchar(255) NOT NULL COMMENT 加密密码, phone varchar(20) UNIQUE COMMENT 手机号, email varchar(100) UNIQUE COMMENT 邮箱, real_name varchar(50) COMMENT 真实姓名, gender tinyint COMMENT 性别 0:未知 1:男 2:女, birthday date COMMENT 出生日期, status tinyint DEFAULT 1 COMMENT 状态 0:禁用 1:正常, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ); -- 体检套餐表 CREATE TABLE package ( id bigint PRIMARY KEY AUTO_INCREMENT, name varchar(100) NOT NULL COMMENT 套餐名称, description text COMMENT 套餐描述, price decimal(10,2) NOT NULL COMMENT 价格, category varchar(50) COMMENT 分类(如基础套餐、入职体检、高端尊享), suitable_gender tinyint COMMENT 适用性别 0:通用 1:男 2:女, min_age int COMMENT 最小适用年龄, max_age int COMMENT 最大适用年龄, items json COMMENT 包含的检查项目(JSON数组), is_active tinyint DEFAULT 1 COMMENT 是否上架, create_time datetime DEFAULT CURRENT_TIMESTAMP ); -- 预约订单表 (核心业务表) CREATE TABLE order ( id varchar(32) PRIMARY KEY COMMENT 订单号, user_id bigint NOT NULL COMMENT 用户ID, package_id bigint NOT NULL COMMENT 套餐ID, checkup_date date NOT NULL COMMENT 体检日期, time_slot varchar(20) NOT NULL COMMENT 时间段(如 08:00-09:00), amount decimal(10,2) NOT NULL COMMENT 订单金额, status tinyint DEFAULT 0 COMMENT 状态 0:待支付 1:已预约 2:已完成 3:已取消, cancel_reason varchar(255) COMMENT 取消原因, create_time datetime DEFAULT CURRENT_TIMESTAMP, INDEX idx_user_id (user_id), INDEX idx_checkup_date (checkup_date), FOREIGN KEY (user_id) REFERENCES user(id), FOREIGN KEY (package_id) REFERENCES package(id) ); -- 体检报告表 CREATE TABLE report ( id bigint PRIMARY KEY AUTO_INCREMENT, order_id varchar(32) NOT NULL COMMENT 关联订单号, user_id bigint NOT NULL COMMENT 用户ID, file_path varchar(500) COMMENT 报告文件存储路径, summary text COMMENT 报告摘要, doctor_advice text COMMENT 医生建议, is_issued tinyint DEFAULT 0 COMMENT 是否已发布给用户, create_time datetime DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (order_id) REFERENCES order(id), FOREIGN KEY (user_id) REFERENCES user(id) );五、核心代码实现示例5.1 预约服务核心逻辑 (Spring Boot Service)package com.health.check.service; import com.health.check.dto.BookingRequest; import com.health.check.entity.Order; import com.health.check.entity.Package; import com.health.check.entity.User; import com.health.check.exception.BusinessException; import com.health.check.repository.OrderRepository; import com.health.check.repository.PackageRepository; import com.health.check.repository.UserRepository; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.time.LocalDate; import java.util.UUID; Service RequiredArgsConstructor public class BookingService { private final OrderRepository orderRepository; private final PackageRepository packageRepository; private final UserRepository userRepository; private final TimeSlotService timeSlotService; // 用于检查时间段容量 Transactional public Order createOrder(BookingRequest request) { // 1. 验证用户 User user userRepository.findById(request.getUserId()) .orElseThrow(() - new BusinessException(用户不存在)); // 2. 验证套餐 Package pkg packageRepository.findById(request.getPackageId()) .filter(Package::getIsActive) .orElseThrow(() -gt; new BusinessException(套餐不存在或已下架)); // 3. 验证预约日期(不能早于今天) LocalDate checkupDate request.getCheckupDate(); if (checkupDate.isBefore(LocalDate.now())) { throw new BusinessException(预约日期不能早于今天); } // 4. 验证时间段容量 if (!timeSlotService.isAvailable(checkupDate, request.getTimeSlot())) { throw new BusinessException(该时间段已约满请选择其他时间); } // 5. 生成订单号 (示例日期随机串) String orderNo HC LocalDate.now().format(DateTimeFormatter.ofPattern(yyyyMMdd)) UUID.randomUUID().toString().replace(-, ).substring(0, 8).toUpperCase(); // 6. 创建订单实体 Order order new Order(); order.setId(orderNo); order.setUser(user); order.setPackage(pkg); order.setCheckupDate(checkupDate); order.setTimeSlot(request.getTimeSlot()); order.setAmount(pkg.getPrice()); order.setStatus(0); // 待支付 // 7. 占用时间段容量 timeSlotService.reserveSlot(checkupDate, request.getTimeSlot()); // 8. 保存订单 return orderRepository.save(order); } Transactional public void cancelOrder(String orderNo, String reason) { Order order orderRepository.findById(orderNo) .orElseThrow(() - new BusinessException(订单不存在)); // 业务规则仅允许取消待支付或已预约状态的订单 if (order.getStatus() ! 0 amp;amp; order.getStatus() ! 1) { throw new BusinessException(当前订单状态不允许取消); } // 更新状态 order.setStatus(3); order.setCancelReason(reason); // 释放时间段容量 timeSlotService.releaseSlot(order.getCheckupDate(), order.getTimeSlot()); orderRepository.save(order); } }5.2 套餐查询与缓存 (使用Redis)package com.health.check.service; import com.health.check.entity.Package; import com.health.check.repository.PackageRepository; import lombok.RequiredArgsConstructor; import org.springframework.cache.annotation.Cacheable; import org.springframework.data.domain.Page; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.domain.Specification; import org.springframework.stereotype.Service; import java.util.List; Service RequiredArgsConstructor public class PackageService { private final PackageRepository packageRepository; // 根据ID获取套餐详情并缓存结果 Cacheable(value package, key #id) public Package getPackageById(Long id) { return packageRepository.findById(id) .orElseThrow(() - new RuntimeException(套餐不存在)); } // 多条件分页查询套餐 (支持分类、性别、年龄筛选) public Pagelt;Packagegt; findPackages(String category, Integer suitableGender, Integer age, Pageable pageable) { Specificationlt;Packagegt; spec Specification.where(null); if (category ! null amp;amp; !category.isEmpty()) { spec spec.and((root, query, cb) -gt; cb.equal(root.get(category), category)); } if (suitableGender ! null) { spec spec.and((root, query, cb) -gt; cb.equal(root.get(suitableGender), suitableGender)); } if (age ! null) { spec spec.and((root, query, cb) -amp;gt; cb.and( cb.lessThanOrEqualTo(root.get(minAge), age), cb.greaterThanOrEqualTo(root.get(maxAge), age) ) ); } // 只查询已上架的套餐 spec spec.and((root, query, cb) -gt; cb.isTrue(root.get(isActive))); return packageRepository.findAll(spec, pageable); } // 获取热门套餐 (缓存) Cacheable(value hotPackages) public Listlt;Packagegt; getHotPackages() { // 业务逻辑可根据销量、点击量等排序取前10 return packageRepository.findTop10ByOrderBySalesDesc(); } }5.3 体检报告上传与查看 (Controller层)package com.health.check.controller; import com.health.check.dto.ApiResponse; import com.health.check.entity.Report; import com.health.check.service.ReportService; import lombok.RequiredArgsConstructor; import org.springframework.core.io.Resource; import org.springframework.http.HttpHeaders; import org.springframework.http.MediaType; import org.springframework.http.ResponseEntity; import org.springframework.security.access.prepost.PreAuthorize; import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; import java.io.IOException; import java.nio.file.Files; import java.nio.file.Path; import java.nio.file.Paths; RestController RequestMapping(/api/reports) RequiredArgsConstructor public class ReportController { private final ReportService reportService; private final String UPLOAD_DIR /opt/health-check/reports/; // 管理员上传报告 PostMapping(/upload) PreAuthorize(hasRole(ADMIN)) public ApiResponselt;Reportgt; uploadReport(RequestParam Long orderId, RequestParam MultipartFile file, RequestParam(required false) String summary, RequestParam(required false) String doctorAdvice) throws IOException { // 文件存储逻辑 String fileName System.currentTimeMillis() _ file.getOriginalFilename(); Path filePath Paths.get(UPLOAD_DIR fileName); Files.createDirectories(filePath.getParent()); file.transferTo(filePath); // 创建报告记录 Report report reportService.createReport(orderId, filePath.toString(), summary, doctorAdvice); return ApiResponse.success(报告上传成功, report); } // 用户查看自己的报告列表 GetMapping(/my) PreAuthorize(hasRole(USER)) public ApiResponselt;Listlt;Reportgt;gt; getMyReports() { Long userId getCurrentUserId(); // 从SecurityContext获取 Listlt;Reportgt; reports reportService.findByUserId(userId); return ApiResponse.success(reports); } // 下载报告文件 GetMapping(/download/{reportId}) public ResponseEntitylt;Resourcegt; downloadReport(PathVariable Long reportId) throws IOException { Report report reportService.findById(reportId); // 权限校验用户只能下载自己的报告管理员可下载所有 checkPermission(report); Path filePath Paths.get(report.getFilePath()); Resource resource new UrlResource(filePath.toUri()); return ResponseEntity.ok() .contentType(MediaType.APPLICATION_PDF) .header(HttpHeaders.CONTENT_DISPOSITION, attachment; filename resource.getFilename() ) .body(resource); } private Long getCurrentUserId() { // 实现从SecurityContext获取当前用户ID return 1L; // 示例 } private void checkPermission(Report report) { // 实现权限校验逻辑 } }六、总结与展望本文介绍了基于Spring Boot的健康体检预约与管理网站的设计与实现涵盖了项目背景、技术栈选型、核心功能、数据库设计以及关键代码示例。该系统通过模块化设计实现了用户在线预约、套餐管理、报告查询等核心业务流程并利用Spring Security保障安全Redis提升性能。未来可扩展方向移动端适配开发微信小程序或APP提供更便捷的移动体验。智能推荐基于用户历史数据和健康画像智能推荐个性化体检套餐。数据可视化大屏为体检中心管理员提供更丰富的运营数据看板。第三方集成对接医保支付、电子健康卡等外部系统。微服务改造随着业务增长可拆分为用户服务、预约服务、报告服务等独立微服务。通过本项目实践开发者可以深入掌握Spring Boot全栈开发、数据库设计、缓存应用及系统安全等关键技术具备构建类似企业级Web应用的能力。