SpringBoot 医疗病历交互系统的设计与实现:192 个 Java 文件、256 个接口、22 张表,附真实运行截图
这是一套基于 B2B 平台的医疗病历交互系统:医院在线注册并审核,医生挂号后写病人病历、开医疗安排,患者在网页上看医院、约科室。本文把包里有什么、四类身份怎么分工、22 张表怎么组织、一条「注册医院到给病人排治疗」的链路怎么走、本地怎么跑起来,一条条讲清楚,附全部真实运行截图。
目录
- 一、项目概览:这套系统是什么
- 二、功能模块:管理员、医院、医生、患者怎么分工
- [三、数据库设计:22 张表怎么组织](#三、数据库设计:22 张表怎么组织)
- 四、核心业务走读:一家医院从注册到给病人排治疗
- 五、本地跑起来:六步到浏览器
- 六、答辩与使用提醒
- 七、这套适合什么样的同学
一、项目概览:这套系统是什么
一句话定性:单体、前后端不分离的医疗行业 B2B 平台 。前台是 layui 静态 HTML,后台是 Vue 2 + ElementUI 的编译产物,两套前端和后端代码放在同一个 Maven 工程里,一个 java -jar 就能全部跑起来。
它做的事是:把「医院、科室、医生、病人」四方的信息搬到线上------医院在网页上提交注册资料,管理员审核通过后医院才能登录;医生接诊后给病人写病历、下医疗安排;患者登录后看医院列表、读医院文章、按科室预约。
规模数字
每个数字都是从源码统计出来的,命令写在最后一列,可以自己复现:
| 指标 | 数值 | 怎么数 |
|---|---|---|
| Java 文件 | 192 个 | `find src -name '*.java' \ |
| Java 代码行数 | 22046 行 | 同上加 -exec cat {} + 后 wc -l |
| Controller | 23 个 | `find src -name '*Controller.java' \ |
| REST 端点 | 256 个 | 数方法级 @RequestMapping/@GetMapping/...,类上的 @RequestMapping 只是路径前缀,不算端点 |
| 前台/后台 HTML | 73 个 | `find src -name '*.html' \ |
| Mapper XML | 23 个 | ls src/main/resources/mapper/ |
| 数据库表 | 22 张 | 数 db.sql 里的 CREATE TABLE |
| 演示数据 | 115 行 | 数 insert into 后面的元组,不是数语句条数 |
工程分层
com 包下按标准三层分:controller 23 个(一个业务表一个)、service 46 个(接口与实现分开)、dao 23 个 MyBatis-Plus Mapper、entity 80 个实体(含 view/vo 变体)、interceptor 一个 token 校验拦截器、annotation 三个(@IgnoreAuth 标在免登录接口上)、config 两个、utils 十三个(R 统一返回、PageUtils 分页、MPUtil 条件构造、MD5Util)。
资源目录里有两套前端:
| 目录 | 内容 |
|---|---|
src/main/resources/front/front/ |
前台 layui 静态站,23 个页面目录,每个业务表一个 pages/xxx/list.html |
src/main/resources/admin/admin/dist/ |
后台 Vue 打好包的产物,登录后走 #/模块名 |
src/main/resources/mapper/ |
23 个 Mapper XML(22 张业务表 + 一个 CommonDao) |
有一处容易踩:目录是双层 的(front/front、admin/admin/dist),但 application.yml 里 static-locations 只写了 classpath:static/,file:static/,前台能打开靠的是 Spring Boot 对 classpath:/ 的默认兜底。所以写 URL 时只写一层:/front/index.html、/admin/dist/index.html,别照着磁盘目录拼成 /front/front/index.html。
系统结构图:浏览器 → 静态页 → Controller → Service → MyBatis-Plus → MySQL,两侧是前台 layui 与后台 Vue 两套前端
二、功能模块:管理员、医院、医生、患者怎么分工
这套系统的用户体系是四套账号表,不是一个用户表加角色字段:
| 表 | 谁在用 | 登录后能做什么 |
|---|---|---|
users |
管理员 | 后台全部 16 个业务菜单,从医院、医院注册到医院文章、科室、医生、病人病历、医疗安排、科室预约、评论、轮播图 |
yiyuan |
医院 | 维护自己的院区、文章、科室、公告、工作人员,把审核通过的医生加进医生展示,管病人病历与医疗安排 |
yisheng |
医生 | 看病人病历、写医疗安排、处理科室预约申请 |
yonghu |
患者 | 前台注册登录,看医院列表与文章、按科室预约、读医生展示 |
四套表用一张 token 表区分:登录成功时把 tablename(users/yiyuan/yisheng/yonghu)和 role 一起写进 token 记录,之后的请求靠这个字段判断「你是哪一套身份」。答辩老师很爱问「你怎么区分管理员和医院?」,答案就在 token 表的 tablename 字段上。
前台能做什么
前台按业务表分页面,顶部导航只有四个模块------院区展示、医院文章、医院科室、医生展示,正好对应医院对外的四件事:不登录也能浏览,登录后多出个人中心和预约入口。
前台首页:顶部导航是院区展示、医院文章、医院科室、医生展示,右侧是个人中心与后台管理入口
医院科室列表:一行一个科室,带科室名称、科室类型和所属医院编号,右侧是查看详情与预约入口
医生展示列表:医生姓名、职称、职务、科室一览,每行是审核通过后才对外展示的信息
后台能做什么
后台是 Vue + ElementUI,左侧菜单跟业务表一一对应(token 和 config 不单独给菜单)。每张表都是同一套页面:列表带搜索条件和分页、新增、编辑、删除、详情。
后台首页:左侧菜单一项对应一张业务表,右侧是统计和快捷入口
医院注册管理:每行是待审核的医院资料,操作列除了查看、修改、删除,还有「审核」和「注册医院」两个按钮
病人病历管理:病人姓名、性别、年龄、入院日期后面接着主诉、现病史、既往史这些长文本字段,是这套系统最核心的业务表
23 个 Controller 对应哪些模块
| Controller | 业务含义 |
|---|---|
YiyuanController |
医院(医院方登录后的主账号表) |
YiyuanzhuceController / YiyuanliebiaoController |
医院注册(待审核申请)/ 医院列表(审核通过后能登录) |
YuanquzhanshiController |
院区展示(名称、地址、电话、面积、专家、科室) |
YiyuanwenzhangController |
医院文章(标题、类型、正文、作者、图片、点赞踩) |
YiyuankeshiController / YiyuankeshiyuyueController |
医院科室 / 科室预约(预约时间、审核位) |
YiyuangonggaoController / YiyuangongzuorenyuanController |
医院公告 / 医院工作人员(部门、职务、科室) |
YishengController / YishengzhanshiController |
医生账号 / 对外展示的医生资料 |
BingrenbingliController / YiliaoanpaiController |
病人病历 / 医疗安排(用药、检查、护理三组进度) |
YonghuController / UserController |
患者 / 管理员两套账号 |
Discuss*Controller(3 个) |
院区展示、医院文章、医生展示的评论 |
WenzhangleixingController / ConfigController |
文章类型字典 / 站点配置(轮播图) |
CommonController / FileController |
通用能力(下拉选项、统计、收藏、跨表查询)/ 图片上传下载 |
三、数据库设计:22 张表怎么组织
db.sql 22 张表、0 条外键。生成器写表不写外键约束,表与表的关系全在字段语义里,所以画 ER 图要按字段名去对,不能指望数据库自己告诉你。
分七组看:
| 分组 | 表 | 干什么 |
|---|---|---|
| 用户与鉴权 | users、token、yonghu、yiyuan、yisheng |
四类身份 + 登录凭证 |
| 医院与院区 | yiyuanzhuce、yiyuanliebiao、yuanquzhanshi |
注册申请、审核通过的医院、院区展示 |
| 文章与科室 | yiyuanwenzhang、yiyuankeshi、yiyuangonggao、wenzhangleixing |
医院发的文章、科室、公告、文章类型字典 |
| 医生与展示 | yisheng、yishengzhanshi、yiyuangongzuorenyuan |
医生账号、对外展示、工作人员 |
| 病历与医疗安排 | bingrenbingli、yiliaoanpai、yiyuankeshiyuyue |
病历、用药/检查/护理安排、科室预约 |
| 评论互动 | discussyuanquzhanshi、discussyiyuanwenzhang、discussyishengzhanshi |
三张同构评论表 |
| 系统配置 | config、storeup |
站点参数、收藏夹 |
几张关键表长什么样
bingrenbingli(病人病历,20 列):病人账号姓名、性别、婚姻、年龄、现住地址、入院日期、医院编号,后面是七个长文本------主诉、现病史、既往史、个人史、家族史、体格检查、病历摘要,最后是初步诊断,再带上医生账号与姓名。
yiliaoanpai(医疗安排,16 列):医院编号、入院日期、入住科室、入住房号、医生账号姓名,后面是三组「安排 + 进度」------用药安排加用药进度、检查项目安排加项目检查进度、护理安排加护理进度。
yiyuanzhuce(医院注册,12 列):医院名称、密码、负责人、负责人手机、邮箱、负责人身份证,加上 sfsh(是否审核)和 shhf(审核回复)两个审核字段。审核通过后,这条记录会被并到 yiyuanliebiao 里------后者多存登录账号、姓名和注册时间,是真正拿去登录的那张表。
yiyuankeshiyuyue(科室预约,10 列):科室类型、医院编号、科室名称、预约时间、预约人账号姓名,外加 sfsh/shhf 审核字段------预约是患者发起、医院审核的一条完整线。
四类身份靠 token.tablename 串成一套登录体系
注册申请审核通过后进医院列表表,院区展示挂在医院编号下
病历、医疗安排、科室预约三条线都带医院编号,表间没有外键,靠字段语义关联
演示数据分布
db.sql 里 21 条 insert into 语句,展开成 115 行数据,21 张表每张都有:
| 表 | 行数 | 表 | 行数 |
|---|---|---|---|
yiyuan / yiyuanzhuce / yiyuanliebiao |
各 6 | yiyuankeshi / yiyuankeshiyuyue |
各 6 |
yiyuanwenzhang / yiyuangonggao |
各 6 | yiyuangongzuorenyuan / yisheng |
各 6 |
yishengzhanshi / yuanquzhanshi |
各 6 | bingrenbingli / yiliaoanpai |
各 6 |
discussyuanquzhanshi / discussyiyuanwenzhang / discussyishengzhanshi |
各 6 | wenzhangleixing |
6 |
yonghu |
7 | config |
4 |
users / token |
各 1 |
导入脚本就有数据,不用自己造。唯一空表是 storeup(收藏夹),它要用户先收藏才会有记录,截图里看到它是空的不用担心。
四、核心业务走读:一家医院从注册到给病人排治疗
这条链路是这套系统的全部价值,讲清楚它,论文的「详细设计」就有一节能写了。
第一步:医院提交注册
医院方在前台注册页填医院名称、负责人、负责人手机、邮箱、身份证,提交到 /yiyuanzhuce/add。落库时主键用「当前时间戳 + 随机数」生成,sfsh 字段默认是「否」,表示还没审核。
第二步:管理员审核
管理员在后台「医院注册管理」点审核,sfsh 改成「是」、shhf 写审核回复。审核通过后,这条注册信息会被拷进 yiyuanliebiao------那张表才是医院方登录用的账号表。
第三步:医院维护自己的资料
医院登录后进后台,能维护院区展示、发医院文章、维护科室、发公告、录工作人员、把审核通过的医生加进「医生展示」。
第四步:医生接诊并写病历
医生登录后在「病人病历管理」里写病历:病人账号姓名、性别、年龄、入院日期、主诉、现病史、既往史、个人史、家族史、体格检查、病历摘要、初步诊断,最后挂上医生账号和姓名。写完在「医疗安排管理」里开三组安排------用药安排加用药进度、检查项目安排加项目检查进度、护理安排加护理进度,每项都能单独跟进。
第五步:患者预约科室
患者在前台「医院科室」点预约,提交科室类型、医院编号、科室名称、预约时间和自己的账号姓名,落到 yiyuankeshiyuyue,同样带 sfsh 审核位,医院方审核后才算数。
完整链路
医院 /yiyuanzhuce/add 提交注册 → 管理员 /yiyuanzhuce/update 审核 → 拷进 /yiyuanliebiao 拿到登录账号 → 医院维护院区文章科室 → 医生 /bingrenbingli/save 写病历 → /yiliaoanpai/save 开用药检查护理三组安排 → 患者 /yiyuankeshiyuyue/add 预约科室。
三段值得贴进论文的代码
第一段:一张表按身份自动过滤。 医院注册列表先看当前登录的是哪套身份,患者只能看到自己提交过的那几条:
@RequestMapping("/page")
public R page(@RequestParam Map<String, Object> params,YiyuanzhuceEntity yiyuanzhuce,
HttpServletRequest request){
String tableName = request.getSession().getAttribute("tableName").toString();
if(tableName.equals("yonghu")) {
yiyuanzhuce.setZhanghao((String)request.getSession().getAttribute("username"));
}
EntityWrapper<YiyuanzhuceEntity> ew = new EntityWrapper<YiyuanzhuceEntity>();
PageUtils page = yiyuanzhuceService.queryPage(params, MPUtil.sort(MPUtil.between(MPUtil.likeOrEq(ew, yiyuanzhuce), params), params));
return R.ok().put("data", page);
}
第二段:一行代码把筛选、区间、排序全接住。 上面那行 queryPage 里的三个工具方法各干一件事:likeOrEq 把实体里的非空字段变成条件(值里带 % 走 LIKE,否则走 =,所以搜索框留空不会查出全表);between 把 xxx_start/xxx_end 翻成区间条件;sort 把 sort/order 翻成 ORDER BY。前端加个筛选框,后端一行都不用改。
第三段:登录取 token。 四类身份共用一个签发方法 generateToken(userid, username, tableName, role),在 TokenServiceImpl 里:先按 userid + role 查有没有旧 token,有就换新值并把过期时间续 1 小时,没有就新插一行;token 是 32 位随机串,存在 token 表。
拦截器 AuthorizationInterceptor 拿请求头里的 Token 查这张表,查到就把 userId/role/tableName/username 塞进 session,后面 Controller 全靠 session 取值;查不到直接返回「请先登录」。标了 @IgnoreAuth 的接口不校验,所以没登录也能浏览医院、科室和文章。
五、本地跑起来:六步到浏览器
环境
- JDK 8(
pom.xml里<java.version>写的就是 1.8) - Maven 3.6+
- MySQL 5.7 或 8.0
- 不需要 Redis、不需要消息队列、不需要 Node(前台是静态页,后台是打好的 dist)
六步
- 建库:
CREATE DATABASE springbootr2r43 DEFAULT CHARACTER SET utf8; - 导入数据:
mysql -uroot -p springbootr2r43 < db.sql - 改连接:
src/main/resources/application.yml里的username/password换成你自己的 - 打包:
mvn clean package -DskipTests - 启动:
java -jar target/springbootr2r43-0.0.1-SNAPSHOT.jar - 打开
http://localhost:8080/springbootr2r43/front/index.html,后台是http://localhost:8080/springbootr2r43/admin/dist/index.html
默认账号写在源码包的 说明文档.txt 和 db.sql 种子数据里,前后台各一套。
配置长什么样
server:
port: 8080
servlet:
context-path: /springbootr2r43
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/springbootr2r43?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8
username: root
password: 你的数据库密码
context-path 决定了所有地址前面那个 /springbootr2r43,改它要一起改三个地方:application.yml、front/front/js/config.js(1 处)、front/front/modules/http/http.js(2 处)。只改 yml 会出现「后台能开、前台一片白」------前台调接口的地址还指着旧路径。
三个常见报错
Access denied for user 'root'@'localhost':yml 里的密码不是你的 MySQL 密码,改 yml。
前台一片白、控制台一堆 404 :先看上面那三个改路径的地方改全了没,再看 config.js 里的接口端口是不是 8080。
说明文档.txt 打开是乱码:这是 GBK 编码的文本,用 VSCode 打开会提示编码,选 GB18030 就正常了。
六、答辩与使用提醒
一、账号写在说明文档和 db.sql 里,公开页面不写。 四类账号的口令都在源码包的 说明文档.txt 和 db.sql 种子数据里,跟着资料一起交付,公开文章里不列。演示前把默认口令改掉,别原样挂着。
二、上传的图片存在运行目录下的 upload 文件夹。 FileController 把图片写到 path.getAbsolutePath() 拼出来的 /upload/ 里。重新 mvn clean package 之后,之前传的图片会跟着旧包一起没了。答辩前重新打过包,记得把演示用的院区图、医生照片重传一遍。想彻底解决,把上传目录指到工程外的绝对路径,或者写进论文改进方向(换成对象存储)。
三、密码是明文存的,这一点可以主动讲。 四张账号表的 mima/password 字段直接存原文,工程里有 MD5Util 这个工具类,但登录流程并没有调用它。答辩老师问到安全性,别硬撑,直接答「当前是明文,改进方案是换 BCrypt 加盐哈希」,再补一句「登录已经用 token + 拦截器做了会话校验」,比被问住强。
四、sfsh 审核字段是这套系统的设计骨架,别忽略。 医院注册、医生、科室预约三张表都有 sfsh(是否审核)和 shhf(审核回复)两个字段,是生成器自带的审核流转位。老师问「注册完为什么不能直接登录」,答「注册先进待审表,管理员审核通过才进登录表,两张表分开」,这是这套 B2B 平台真正的设计意图。
五、技术栈里有一项要注意。 pom.xml 里引了 shiro-spring 这个依赖,但整个 src/main/java 里搜不到任何一行 Shiro 的引用,实际鉴权是自写的 AuthorizationInterceptor 做的。答辩被问「用的什么权限框架」,如实答「用 Spring 拦截器自己实现的 token 校验,Shiro 那个依赖是模板带过来的没实际用到」。
七、这套适合什么样的同学
适合你,如果:
- 选题是「医疗信息管理」「医院预约」「医患交互」这类,需要注册审核 + 业务落库 + 权限区分三层闭环的底子;
- 想要
java -jar就能演示、不用装中间件,且导入即有 115 行演示数据(22 张表,翻页、筛选、长文本详情都有内容); - 需要论文里的功能模块和代码一一对上:23 个 Controller、22 张表,铺满「系统设计」和「详细设计」两章没问题。
可能不太合适,如果:
- 学校要求前后端分离、前端独立 Vue/React 工程(这套前台是 layui 静态页,后台是编译好的 dist);
- 选题必须是移动端或小程序(这套只有 Web 端);
- 需要完整的电子处方、医保结算、在线问诊这类复杂流程(这套是医院、科室、医生、病人四层信息管理,没有支付和医保)。
想在这套上面加东西,三个自然的方向:把病历审核流转补成状态机(草稿 → 医生确认 → 归档);给医院之间加真正的数据隔离(现在是按医院编号冗余,没做行级权限);把上传目录挪出工程并加文件类型校验。
本文基于 springboot01-061 源码逐文件分析,代码片段均为原文摘录,统计数字可复现,截图来自真实运行环境。