智慧医药

自托管 · Spring Boot 3 · 开源

症状查疾病,
疾病查药品

智慧医药把疾病百科、药品说明、AI 问答和用户反馈放在同一套系统里。 不用登录第三方平台,知识库和数据都在你自己的服务器上。

9
张数据表
2
种角色
1
个 jar 启动

01 — 适用场景

三类人,各查各的

系统没有把功能堆在一个页面上,而是按「谁在查什么」分开。下面是三种最常见的用法。

01

身体不舒服,先查个方向

输入 咳嗽 或 咽痛 低热,返回几个候选病种。每个都列出症状、病因、常用药,以及什么情况下该去医院。给的是资料,不是诊断结论。

02

拿到药,想知道它治什么

药品页按通用名或适应症都能搜到。功效、规格、厂家、参考价、禁忌、不良反应、药物相互作用在一页里,不用来回切。

03

维护内容,看得见效果

疾病、药品、分类、用户、资讯、反馈六个模块。每条内容都记浏览量,哪篇一直没人看、哪类问题反馈最多,后台一眼能看出来。

02 — 系统能力

四块能力,边界写清楚

下面每一条都对应系统里实际存在的功能,没有「即将上线」的占位。

01疾病条目,字段分得清

每个病种按「症状 / 特殊表现 / 病因 / 常用药 / 所属科室」分字段存储,不是一大段没法扫读的文本。列表页可按科室筛选,详情页展开关联药品。

illness 表 · kind_id 外键 · 按分类分页查询

02病和药,双向关联

疾病页列出常用药,药品页反查相关病种。关联关系存在数据里,改一条记录两边同时生效,不需要改代码。

medicine ↔ illness 关联查询 · 批量取数,避免 N+1

03AI 问答,可关可降级

接入通义千问,能结合站内知识库回答。没配 Key 或调用失败时自动退回本地检索,功能不中断,只是答案来自规则匹配而非大模型。

DashScope SDK · 失败降级 · 未配置时隐藏入口

04反馈闭环,有状态可追踪

用户提交问题后进入待处理队列,管理员处理后填写回复。用户在「我的反馈」里能看到处理进度和结果,不是单向提交完就没下文。

feedback 表 · 状态流转 · 回复留痕

03 — 角色权限

两种角色,一条清晰的线

系统只有普通用户和管理员两级,不做复杂的 RBAC。够用,也好审计。

角色 可以做什么 不能做什么
游客 浏览疾病百科、药品信息、医药资讯;使用关键词搜索 提问、提交反馈、修改资料
普通用户 游客的全部能力,加上 AI 问答、提交反馈、查看处理结果、查看浏览历史、维护个人资料与头像 增删改任何知识库内容;查看他人反馈
管理员 疾病、药品、分类、资讯、用户、反馈六个模块的完整管理权限;重置用户密码、调整角色 —

权限判定集中在拦截器里,按请求方法区分页面与接口:页面请求跳转 401,接口请求返回 JSON 错误,前端弹提示而不是白屏。

04 — 部署要求

一台机器,三步跑起来

没有前端构建步骤,不需要 Node 环境。打包产物是一个可执行 jar。

  • 运行环境JDK 17 及以上
  • 数据库MySQL 8.0,导入 smart-medicine.sql 初始化
  • 后端Spring Boot 3.3 · MyBatis-Plus 3.5 · Druid
  • 前端Thymeleaf 服务端渲染 · Bootstrap 5.3 · jQuery 3.7
  • 密码存储BCrypt 加盐哈希,历史 MD5 记录登录时自动升级
  • 文件上传扩展名白名单 + 文件头魔数校验 + 5MB 上限
  • 反向代理Nginx 或 IIS ARR 均可,绑定域名后配 HTTPS
# 环境变量,未设置时使用默认值
DB_URL=jdbc:mysql://127.0.0.1:3306/smart-medicine
DB_USERNAME=root
DB_PASSWORD=******
SERVER_PORT=8080
AI_KEY=sk-**** # 留空则用本地知识库
UPLOAD_DIR=./upload
 
# 启动
java -jar smart-medicine.jar

数据库连接、AI Key、上传目录都走环境变量,配置不写死在代码里。换环境只改环境变量,不用重新打包。

05 — 常见问题

动手之前,先看这几条

没有通义千问的 API Key,还能用吗?
能。AI 问答只是其中一个入口,未配置 AI_KEY 时系统会自动退回本地知识库检索:从疾病和药品数据里按症状关键词匹配,返回相关条目而不是生成式回答。入口仍在,只是答案形态不同。其余功能不受影响。
里面的疾病和药品数据是真实的吗?
初始数据用于演示系统结构,覆盖常见病种和常用药,但不保证完整和最新。正式使用前应由具备资质的药师或医师审核、替换。系统本身不提供诊疗建议,页面上的内容不构成用药依据。
能改成多级权限或者加「医生」角色吗?
当前是两级角色,判定逻辑集中在 AdminHandlerInterceptor 一个类里。要扩展成多角色,改动点是这个拦截器加 user.roleStatus 的取值约定,不需要动业务代码。
为什么用服务端渲染,而不是前后端分离?
这类以内容浏览为主的系统,首屏速度和部署简单比前后端分离更重要。Thymeleaf 直接输出 HTML,搜索引擎能抓到内容,部署时也不需要一个单独的 Node 环境来构建前端产物。