简介本资源为基于SpringBoot的社区居民诊疗健康管理系统完整项目面向计算机相关专业毕业生、课程设计学生及Java Web开发者可作为毕业设计、课程作业或企业级项目练手参考。系统覆盖居民健康档案、诊疗服务、慢性病管理、家庭医生签约、公共卫生服务、药品物资管理及统计决策支持七大模块包含预约挂号、电子病历、随访预警、疫苗接种、库存效期管理等具体业务场景。压缩包共766个文件约22.49MB以171个Java源码、128个Vue前端组件、63个JavaScript脚本、22个XML配置及SQL脚本、JAR依赖等为主前后端分离结构清晰便于按模块阅读与二次开发。目前已有64人学习下载适合需要完整业务方案、数据库设计与前后端联调思路的读者参考借鉴。1. 社区居民诊疗健康管理系统从一份毕业论文到能跑起来的 SpringBoot 工程很多做 Java 毕业设计的同学选题时看到「社区居民诊疗健康管理系统」觉得业务简单、好写真正动手才发现坑在别处病历、处方、随访、慢病档案这些实体怎么建模角色权限怎么切论文里的 E-R 图和代码里的表结构对不上最后 PPT 答辩时被老师追问「你这个随访提醒到底怎么触发的」直接卡壳。这篇笔记就围绕这个标题把一套基于 SpringBoot 的社区居民诊疗健康管理系统从需求拆解、库表设计、接口实现到论文与 PPT 的产出路径讲清楚。它适合正在做 Java 毕业设计、需要一套能演示能答辩的完整项目的同学也适合想拿一个中小型医疗业务系统练手 SpringBoot 全栈的开发者。核心不是堆功能而是让「社区诊疗」这条业务线在代码里真正闭环。2. 需求拆解与角色建模社区诊疗到底要管哪几件事社区诊疗和三级医院的 HIS 系统不是一回事。医院系统围绕门诊挂号、住院、收费、医保结算展开而社区卫生服务中心的核心是「长期、就近、预防为主」——居民建档、慢病随访、常见病诊疗、健康宣教。如果照搬医院那套表结构你会发现一半字段用不上答辩时也讲不清业务价值。所以第一步是把业务边界收窄到社区场景真正高频的几件事。2.1 四类角色与他们的真实操作路径社区诊疗系统里角色划分直接决定权限表怎么设计。常见做法是分四类居民、社区医生、护士/公卫人员、系统管理员。居民端的核心动作是注册登录、查看自己的健康档案、预约就诊、查看处方和随访记录。注意居民看的是「自己的」数据这就意味着所有查询接口都要带当前登录用户的居民 ID 做数据隔离不能只靠前端隐藏菜单。社区医生端是系统最重的部分接诊、开处方、写病历、发起随访计划、查看自己管辖居民的档案。医生和居民之间是「签约」关系一个居民可能签约一名家庭医生医生只能看自己签约居民的数据这是社区场景区别于医院的关键权限点。护士/公卫人员负责录入体检数据、执行随访、更新慢病档案。管理员负责账号、科室、药品字典等基础数据维护。把这条路径画清楚后权限模型就自然出来了不是简单的「管理员/普通用户」两级而是「角色 数据归属」双重控制。这一点在论文里是加分项在代码里是必须落地的。2.2 核心业务实体与库表设计围绕上面四类角色核心实体有这些居民档案resident、医生doctor、签约关系contract、就诊记录visit、病历medical_record、处方prescription、处方明细prescription_item、随访计划follow_up、体检记录health_exam、药品字典drug。库表设计有几个容易翻车的地方。第一居民档案和系统用户要分开user 表管登录认证resident 表管业务信息两者用 resident_id 关联不要把身份证号、病史塞进 user 表。第二处方和处方明细必须拆两张表一对多关系否则一张处方开五种药就没法存。第三随访计划要有状态字段待执行/已完成/已逾期和计划时间这是后面做提醒功能的基础。下面是一段核心表结构的建表 SQL用 MySQL 8 语法-- 居民档案表业务信息与登录账号分离 CREATE TABLE resident ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL COMMENT 关联 user 表登录账号, name VARCHAR(32) NOT NULL, id_card VARCHAR(18) UNIQUE COMMENT 身份证号唯一, phone VARCHAR(20), address VARCHAR(128), chronic_type VARCHAR(64) COMMENT 慢病类型高血压/糖尿病等, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_user (user_id) ) COMMENT 居民健康档案; -- 签约关系表医生与居民的家庭医生签约 CREATE TABLE contract ( id BIGINT PRIMARY KEY AUTO_INCREMENT, doctor_id BIGINT NOT NULL, resident_id BIGINT NOT NULL, sign_date DATE NOT NULL, status TINYINT DEFAULT 1 COMMENT 1生效 0解约, UNIQUE KEY uk_doc_res (doctor_id, resident_id) ) COMMENT 家庭医生签约; -- 处方明细表与处方主表一对多 CREATE TABLE prescription_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, prescription_id BIGINT NOT NULL, drug_id BIGINT NOT NULL, quantity INT NOT NULL, dosage VARCHAR(64) COMMENT 用法用量, KEY idx_pres (prescription_id) ) COMMENT 处方明细;逻辑说明resident 表用 user_id 外键关联登录账号实现认证与业务解耦contract 表用 (doctor_id, resident_id) 联合唯一键防止重复签约prescription_item 通过 prescription_id 挂到主表。参数上chronic_type 用字符串而非枚举是为了后续扩展慢病类型时不用改表结构status 用 TINYINT 而不是布尔方便以后加「暂停」等中间状态。提示身份证号字段加 UNIQUE 约束前先确认业务上是否允许同一人重复建档。社区场景通常不允许但如果是测试数据批量导入唯一约束会直接报错建议导入脚本里先做去重。2.3 技术选型为什么是 SpringBoot 而不是别的毕业设计选 SpringBoot 几乎是默认答案但要说清理由。SpringBoot 的自动配置让一个 Web 项目几分钟就能跑起来内嵌 Tomcat 省去部署容器的麻烦starter 依赖把 MyBatis、Redis、安全框架的整合成本压到最低。对于社区诊疗这种中等规模、以 CRUD 和少量业务规则为主的项目SpringBoot MyBatis-Plus MySQL 是最省心的组合。前端如果时间紧用 Thymeleaf 做服务端渲染或者 Vue 单独打包后放进 SpringBoot 的 static 目录都是常见做法。这里要注意一个高频坑Vue 打包后的路由是 history 模式时刷新页面会 404需要在 SpringBoot 里配一个转发到 index.html 的控制器或者干脆用 hash 模式。这个细节答辩时老师不一定问但演示时刷新一下就露馅。3. 用 SpringBoot 搭起可运行的后端骨架骨架搭得好后面写业务就是填空骨架搭得乱写到一半就得推倒重来。这一章按「建工程 → 配数据源 → 分层 → 写第一个接口」的顺序走每一步都给可抄的配置和代码。3.1 工程结构与依赖配置用 IDEA 新建 SpringBoot 项目时JDK 选 8 或 11 都行SpringBoot 版本不要盲目追新。热词里「springboot版本太高」是真实痛点3.x 版本要求 JDK 17很多同学本地环境还是 JDK 8一启动就报错。稳妥做法是选 2.7.x 系列兼容性好网上资料多答辩环境也不容易出问题。pom.xml 的核心依赖dependencies !-- Web 层提供 REST 接口和内嵌 Tomcat -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus简化单表 CRUD省去大量 XML -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- Lombok减少 getter/setter 样板代码 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies逻辑说明starter-web 负责 MVC 和 JSON 序列化MyBatis-Plus 在 MyBatis 基础上封装了 BaseMapper单表增删改查不用写 SQLLombok 用 Data 注解自动生成方法。参数上MyBatis-Plus 版本要和 SpringBoot 版本匹配2.7.x 配 3.5.x 是经过验证的组合不要混用 3.4 以下的老版本否则分页插件会报错。3.2 数据源与 MyBatis-Plus 配置application.yml 里把数据源、连接池、MyBatis-Plus 一次配好spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/community_health?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password hikari: maximum-pool-size: 10 # 社区系统并发低10 足够 minimum-idle: 2 mybatis-plus: configuration: map-underscore-to-camel-case: true # 下划线字段自动映射驼峰属性 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开发期打印 SQL global-config: db-config: logic-delete-field: deleted # 逻辑删除字段 logic-delete-value: 1 logic-not-delete-value: 0逻辑说明url 里的 serverTimezone 必须显式指定否则 MySQL 8 驱动会报时区错误这是新手最常见的启动失败原因之一。map-underscore-to-camel-case 让数据库的 create_time 自动映射到 Java 的 createTime省去手写 resultMap。log-impl 在开发期打开能看到实际执行的 SQL排查问题时非常有用但上线前要关掉否则日志量爆炸。注意逻辑删除字段 deleted 需要在每张业务表里都加上默认值 0。如果某张表忘了加MyBatis-Plus 的逻辑删除对它不生效删除操作会变成物理删除数据就真没了没有后悔药。3.3 分层结构与第一个业务接口标准分层是 controller → service → mapper → entity。以「查询某医生的签约居民列表」为例走一遍完整链路。实体类Data TableName(resident) public class Resident { TableId(type IdType.AUTO) private Long id; private Long userId; private String name; private String idCard; private String phone; private String chronicType; private Date createTime; }Mapper 接口继承 BaseMapper复杂查询再写自定义方法public interface ResidentMapper extends BaseMapperResident { // 联表查询医生签约的居民用注解写 SQL Select(SELECT r.* FROM resident r JOIN contract c ON r.id c.resident_id WHERE c.doctor_id #{doctorId} AND c.status 1) ListResident selectByDoctorId(Param(doctorId) Long doctorId); }Service 层做业务组装Controller 层只负责接收参数和返回结果RestController RequestMapping(/api/resident) public class ResidentController { Autowired private ResidentService residentService; // 查询当前医生签约的居民doctorId 从登录态取不信任前端传参 GetMapping(/my-list) public ResultListResident myResidents(RequestAttribute Long doctorId) { return Result.ok(residentService.listByDoctor(doctorId)); } }逻辑说明Mapper 用 Select 注解写联表 SQL避免为简单查询建 XML 文件Controller 里 doctorId 从 RequestAttribute 取这个值由登录拦截器写入而不是让前端传防止越权查询别人的居民。参数上Result 是统一响应封装包含 code、msg、data 三个字段前端处理起来一致。这里有个血泪经验联表查询返回的字段如果和实体属性对不上MyBatis 不会报错只会默默返回 null。比如 SQL 里查的是 r.chronic_type实体属性是 chronicType靠 map-underscore-to-camel-case 才能映射上。如果哪天配置被注释掉了接口不报错但数据全空排查起来很费时间。4. 诊疗业务闭环预约、病历、处方、随访怎么串起来骨架跑通后真正体现项目价值的是业务闭环。社区诊疗的闭环是居民预约 → 医生接诊写病历 → 开处方 → 生成随访计划 → 到期提醒。这一章把每个环节的关键实现和状态流转讲透。4.1 预约与接诊的状态机预约不是简单插一条记录。它有时间段、状态、取消规则。常见状态有待就诊、已就诊、已取消、已过期。状态流转必须由后端控制不能让前端随便改。public enum AppointmentStatus { PENDING(0, 待就诊), FINISHED(1, 已就诊), CANCELED(2, 已取消), EXPIRED(3, 已过期); private final int code; private final String desc; // 构造和 getter 省略 }接诊时医生点击「开始接诊」系统把预约状态从 PENDING 改为 FINISHED同时创建一条 visit 就诊记录。这里要用数据库事务包住两个操作否则可能出现预约改了但就诊记录没建的情况。Transactional(rollbackFor Exception.class) public void startVisit(Long appointmentId, Long doctorId) { Appointment appt appointmentMapper.selectById(appointmentId); // 校验只有待就诊状态、且是该医生的预约才能接诊 if (appt null || appt.getStatus() ! 0 || !appt.getDoctorId().equals(doctorId)) { throw new BizException(预约状态异常或无权操作); } appt.setStatus(1); appointmentMapper.updateById(appt); // 创建就诊记录 Visit visit new Visit(); visit.setAppointmentId(appointmentId); visit.setResidentId(appt.getResidentId()); visit.setDoctorId(doctorId); visit.setVisitTime(new Date()); visitMapper.insert(visit); }逻辑说明Transactional 保证两个写操作要么都成功要么都回滚状态校验放在业务层而不是数据库约束因为状态流转规则会变写死在 SQL 里不好维护。参数上rollbackFor 指定 Exception 而非默认的 RuntimeException是为了让受检异常也能触发回滚避免漏网。4.2 病历与处方的关联写入病历和处方通常在一次接诊里一起提交。前端传一个包含病历内容和药品列表的对象后端拆成三张表写入medical_record、prescription、prescription_item。Transactional(rollbackFor Exception.class) public void submitRecord(RecordDTO dto) { // 1. 写病历 MedicalRecord record new MedicalRecord(); record.setVisitId(dto.getVisitId()); record.setChiefComplaint(dto.getChiefComplaint()); // 主诉 record.setDiagnosis(dto.getDiagnosis()); // 诊断 medicalRecordMapper.insert(record); // 2. 写处方主表 Prescription pres new Prescription(); pres.setRecordId(record.getId()); pres.setResidentId(dto.getResidentId()); pres.setCreateTime(new Date()); prescriptionMapper.insert(pres); // 3. 批量写处方明细 for (DrugItem item : dto.getDrugs()) { PrescriptionItem pi new PrescriptionItem(); pi.setPrescriptionId(pres.getId()); pi.setDrugId(item.getDrugId()); pi.setQuantity(item.getQuantity()); pi.setDosage(item.getDosage()); prescriptionItemMapper.insert(pi); } }逻辑说明先插主表拿到自增 ID再用这个 ID 去挂明细顺序不能反。参数上处方明细用循环单条插入在数据量小时没问题如果一次开几十种药建议改成批量插入MyBatis-Plus 的 saveBatch 或手写 foreach 的 insert减少数据库往返。提示药品库存扣减如果要做必须和处方写入在同一个事务里并且用「更新时带库存判断」的写法UPDATE drug SET stock stock - #{n} WHERE id #{id} AND stock #{n}靠数据库行锁防超卖不要先查再改。4.3 随访计划的生成与到期提醒随访是社区诊疗区别于医院的核心功能。慢病居民需要定期随访比如高血压每季度一次。随访计划表要有 resident_id、doctor_id、plan_date、status、follow_type 字段。生成随访计划有两种触发方式医生手动创建或者系统根据慢病类型自动生成。自动生成可以用定时任务扫描慢病居民按规则批量插入计划。// 每天凌晨扫描为高血压居民生成季度随访计划 Scheduled(cron 0 0 1 * * ?) public void generateFollowUp() { ListResident hypertensives residentMapper.selectList( new LambdaQueryWrapperResident().eq(Resident::getChronicType, 高血压)); for (Resident r : hypertensives) { // 检查是否已有未完成的随访计划避免重复生成 Long count followUpMapper.selectCount( new LambdaQueryWrapperFollowUp() .eq(FollowUp::getResidentId, r.getId()) .ne(FollowUp::getStatus, 1)); if (count 0) { FollowUp fu new FollowUp(); fu.setResidentId(r.getId()); fu.setPlanDate(DateUtil.offsetMonth(new Date(), 3)); fu.setStatus(0); followUpMapper.insert(fu); } } }逻辑说明Scheduled 需要启动类加 EnableScheduling 才生效cron 表达式「0 0 1 * * ?」表示每天凌晨 1 点执行。参数上offsetMonth 把计划日期设为三个月后符合高血压季度随访的常规。去重判断是关键否则每次扫描都会重复插入随访列表会越滚越长。到期提醒可以做成查询接口查 plan_date 小于等于今天且状态为待执行的计划在医生端首页红点提示。不需要真的发短信答辩演示时能展示「逾期随访列表」就够了。5. 避坑与排查那些让答辩翻车的细节代码能跑不等于能演示能演示不等于能答辩。这一章列几个真实踩过的坑每条按现象、原因、解决写。5.1 登录态丢失刷新页面就退出现象前端登录后跳转到首页正常一按 F5 刷新就跳回登录页。原因登录信息存在 Vuex 或内存里刷新后状态清空而路由守卫检测不到 token 就重定向。解决登录成功后把 token 存 localStorage路由守卫从 localStorage 读同时后端接口用拦截器校验 token前端每次请求在 header 里带上。注意 token 过期时间要设合理演示时设 2 小时别设 5 分钟否则讲到一半就掉线。5.2 中文乱码病历里的主诉变成问号现象数据库里存的中文正常但接口返回给前端后显示乱码。原因MySQL 连接 url 没指定 characterEncoding或者数据库、表的字符集不是 utf8mb4。解决url 加 characterEncodingutf8建库时用 CREATE DATABASE community_health DEFAULT CHARACTER SET utf8mb4建表也指定 utf8mb4。utf8mb4 比 utf8 多支持 emoji 和部分生僻字病历里偶尔会有特殊符号用 utf8mb4 更稳。5.3 分页查询总数不对现象列表分页显示「共 0 条」但数据明明有。原因MyBatis-Plus 的分页插件没配置或者配置了但版本不匹配。解决加一个配置类注册 PaginationInnerInterceptor并确认 MyBatis-Plus 版本在 3.4 以上。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }参数上DbType.MYSQL 要和实际数据库一致用错数据库类型分页 SQL 会拼错。5.4 时间字段差 8 小时现象新建记录的时间比实际时间早 8 小时。原因JVM 时区和数据库时区不一致或者 url 里 serverTimezone 配成了 UTC。解决url 里 serverTimezone 设为 Asia/Shanghai实体类时间字段用 java.util.Date 或 LocalDateTime 都行但要在 application.yml 里配 spring.jackson.time-zoneGMT8保证 JSON 序列化时也按东八区输出。5.5 越权访问居民能查到别人的档案现象把接口 URL 里的 residentId 改一下就能看到别人的健康档案。原因接口只校验了登录没校验数据归属。解决所有涉及居民数据的查询都要在 SQL 里带上当前登录用户的 resident_id 条件或者在 Service 层做归属校验。这是安全底线答辩时如果被问到权限设计能说清「角色 数据归属」双重控制是明显的加分项。6. 从能跑到能答辩论文图表与 PPT 演示的产出技巧项目做完只是及格线论文和 PPT 才是拿分的关键。很多同学代码写得不错论文里却全是截图和流水账图表不规范答辩时讲不出设计取舍。这一章讲几个把工程转化为论文和演示材料的实用技巧。先说论文里的图表。E-R 图不要用截图用 draw.io 或 Visio 画标准 Chen 记法或 Crows foot 记法实体、属性、关系标清楚。系统架构图分三层表现层前端页面、业务层Controller/Service、数据层MySQL每层写清用了什么技术。功能模块图按角色分居民端、医生端、管理端各画一棵树。时序图挑「预约接诊」和「处方开具」两条核心链路画比堆十张截图有说服力。再说 PPT。答辩 PPT 控制在 15 到 20 页结构是选题背景与意义2 页、需求分析2 页、系统设计4 页含架构图和 E-R 图、功能实现5 页每页一个核心功能截图加简短说明、测试与总结2 页。截图要清晰别用手机拍屏幕。演示环节提前录一段 2 分钟的录屏作为备份现场环境出问题时能顶上这是后悔药级别的准备。最后说一个具体技巧论文里的「核心代码」部分不要整段贴挑 3 到 5 段最能体现设计思路的比如事务控制的接诊方法、权限校验的拦截器、随访生成的定时任务每段代码后面用两三句话说明「为什么这么写」。老师看的是你的思考不是代码量。我自己的习惯是项目一跑通就立刻把关键截图和架构图存到一个文件夹按章节命名写论文时直接调用不用回头翻代码。答辩前一晚把演示流程走三遍每一步点哪里、说什么话都固定下来现场就不会慌。希望帮到你。本文还有配套的精品资源点击获取
