光源资本1. 项目概述：在线问诊平台的设计与实现
最近在帮几个计算机专业的学生做毕业设计指导，发现医疗类项目始终是热门选题。恰好去年我主导开发过一个线上问诊系统，今天就把这个基于SpringBoot3+Vue3的前后端分离项目做个完整复盘。这个项目不仅适合作为毕业设计，也可以作为个人学习项目或简历亮点。
这个在线问诊平台实现了从预约挂号到电子处方的全流程数字化管理。系统采用经典的三角色设计（患者、医生、管理员），包含20+核心功能模块。在技术选型上，后端使用SpringBoot3+MyBatisPlus，前端采用Vue3+ElementPlus，数据库使用MySQL8.x。项目最大的特点是完整实现了医疗行业特有的业务流程和数据安全要求，比如电子处方的AES-256加密存储、高并发挂号场景处理等。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心功能模块解析
2.1 患者端功能实现
患者端是整个系统的核心入口，我采用了"漏斗模型"设计用户流程：
-
注册登录模块：
- 采用JWT+Spring Security实现认证
- 密码使用BCrypt加密存储
- 短信验证码集成阿里云SDK
-
预约挂号子系统：
java复制// 挂号服务核心逻辑示例
public class RegistrationService {
@Transactional
public String createRegistration(RegistrationDTO dto) {
// 1. 校验号源库存
DoctorSchedule schedule = scheduleMapper.selectById(dto.getScheduleId());
if (schedule.getRemainCount() <= 0) {
throw new BusinessException("号源已约满");
}
// 2. 创建挂号订单
Registration registration = convertToEntity(dto);
registrationMapper.insert(registration);
// 3. 扣减号源
schedule.setRemainCount(schedule.getRemainCount() - 1);
scheduleMapper.updateById(schedule);
// 4. 生成支付订单
return paymentService.createOrder(registration);
}
}
- 在线问诊模块：
- 使用WebSocket实现实时通讯
- 消息存储采用Redis缓存+MySQL持久化
- 图片消息通过OSS存储
特别注意：医疗聊天记录属于敏感数据，我们实现了7天自动归档机制，归档数据会转移到加密存储区。
2.2 医生端关键设计
医生工作台的设计需要特别考虑医疗场景的特殊性：
-
出诊管理：
- 支持批量设置周出诊计划
- 号源库存采用乐观锁控制
- 临时停诊自动通知已预约患者
-
电子处方系统：
- 药品库对接CFDA标准数据库
- 处方模板支持自定义保存
- 签名采用CA数字证书
处方数据结构示例：
json复制{
"prescriptionId": "RX20231125001",
"patientId": "123456",
"doctorId": "1001",
"diagnosis": "急性上呼吸道感染",
"drugs": [
{
"drugCode": "86979474000208",
"name": "阿莫西林胶囊",
"spec": "0.25g*24粒",
"dosage": "口服",
"frequency": "每日3次",
"quantity": 2
}
],
"signature": "加密签名数据",
"createTime": "2023-11-25T10:30:00"
}
2.3 管理端管控功能
后台管理系统主要包含三大监控维度：
-
业务监控看板：
- 实时问诊量统计
- 医生接诊响应时间
- 处方审核通过率
-
敏感操作审计：
- 采用Spring AOP记录操作日志
- 关键数据变更保留历史版本
- 支持操作回滚机制
-
系统健康监测：
- 接口响应时间监控
- 数据库连接池状态
- 缓存命中率统计
3. 技术架构深度解析
3.1 后端技术栈选型
选择SpringBoot3作为基础框架主要基于以下考量：
-
性能优化：
- 启用GraalVM原生镜像支持
- 采用JDK21的虚拟线程特性
- 集成Micrometer监控指标
-
安全方案：
- 医疗数据加密：AES-256+国密SM4
- 接口防护：Spring Security+RateLimiter
- 审计日志：Logback+ELK
-
高并发处理：
java复制// 挂号库存扣减的分布式锁实现
public boolean lockSchedule(Long scheduleId) {
String lockKey = "reg:lock:" + scheduleId;
return redisTemplate.opsForValue()
.setIfAbsent(lockKey, "1", Duration.ofSeconds(30));
}
3.2 前端架构设计
Vue3的组合式API为复杂医疗界面带来显著优势：
-
问诊室组件设计：
- 使用Composition API组织逻辑
- 消息列表虚拟滚动优化
- 图片预览采用Viewer.js集成
-
状态管理方案：
- Pinia管理全局状态
- 本地缓存问诊记录
- 离线消息队列处理
-
性能优化点：
- 路由懒加载
- API请求防抖
- 大数据列表虚拟滚动
3.3 数据库设计要点
医疗系统数据库设计需要特别注意：
-
核心表关系：
-
索引优化：
- 医生排班表：联合索引(doctor_id, schedule_date)
- 预约记录：覆盖索引(patient_id, status)
- 问诊记录：时间范围索引(create_time)
-
分表策略：
- 问诊记录按月水平分表
- 处方数据按科室哈希分表
- 操作日志按年归档
4. 典型问题与解决方案
4.1 高并发挂号场景
问题现象：
压力测试时出现超卖情况，100并发下多卖出15%的号源
解决方案：
- 采用Redis分布式锁+数据库乐观锁双重保障
- 引入排队机制缓解峰值压力
- 前端增加倒计时保留机制
优化前后对比：
| 指标 | 优化前 | 优化后 |
|---|---|---|
| 超卖率 | 15% | 0% |
| 平均响应时间 | 1200ms | 350ms |
| 系统吞吐量 | 80TPS | 210TPS |
4.2 处方PDF生成
踩坑记录：
初期使用Flying Saucer渲染CSS，发现中文字体渲染异常
最终方案：
- 改用OpenHTML+PDFBox组合
- 嵌入思源黑体作为基准字体
- 添加国密算法签名水印
关键代码片段：
java复制public byte[] generatePdf(PrescriptionVO vo) {
// 1. 模板引擎渲染HTML
String html = thymeleaf.process("prescription", vo);
// 2. PDF转换配置
PdfRendererBuilder builder = new PdfRendererBuilder();
builder.useFont(new File("fonts/SourceHanSans.ttf"), "SourceHanSans");
// 3. 添加数字水印
builder.addHeaderFooter(new DigitalWatermark(doctor.getCertNo()));
// 4. 生成PDF字节流
ByteArrayOutputStream baos = new ByteArrayOutputStream();
builder.withHtmlContent(html, "")
.toStream(baos)
.run();
return baos.toByteArray();
}
4.3 WebSocket断线重连
异常场景：
移动端网络切换导致问诊中断
健壮性改进：
- 实现心跳检测机制（30秒间隔）
- 消息IDempotent设计
- 本地消息缓存队列
- 断线自动重连策略
5. 项目部署与扩展建议
5.1 容器化部署方案
推荐使用Docker Compose编排：
yaml复制version: '3'
services:
app:
image: openjdk:21-jdk
ports:
- "8080:8080"
volumes:
- ./config:/config
depends_on:
- redis
- mysql
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
volumes:
- mysql_data:/var/lib/mysql
redis:
image: redis:7.0
ports:
- "6379:6379"
5.2 后续扩展方向
-
AI辅助诊断：
- 症状自诊机器人
- 用药冲突检测
- 检查报告解读
-
互联网医院进阶：
- 医保在线结算
- 检查预约联动
- 远程会诊系统
-
运营功能增强：
- 健康知识库
- 患者随访系统
- 医生直播问诊
这个项目从技术架构到业务实现都充分考虑到了医疗行业的特殊性，特别是在数据安全和业务流程合规性方面做了大量工作。对于想要学习现代Web开发的学生开发者，建议先从患者端核心流程入手，逐步扩展到医生工作台等复杂模块。