medical-health-system

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 智慧医疗健康管理系统 (Smart Medical Health System) ✨

[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.7.x-6DB33F?logo=springboot&logoColor=white)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue-3.x-4FC08D?logo=vuedotjs&logoColor=white)](https://vuejs.org/)
[![DeepSeek](https://img.shields.io/badge/AI-DeepSeek-blue?logo=openai&logoColor=white)](https://www.deepseek.com/)

> **温暖 · 临床 · 智能** —— 基于 Spring Boot 2.7 与 DeepSeek AI 生态构建的现代化智慧医疗管理解决方案。

---

## 🎨 视觉美学 (Digital Clinical Design)

本项目采用 **“温暖高级医疗 (Warm Premium Clinical)”** 视觉体系，追求可信、克制、有人情味的交互体验：
- **高端医疗色调**：暖棕、米白、鼠尾草绿与柔和玫瑰色统一替代大面积蓝白配色。
- **动态交互**：登录页医学动效、AI 机器人微表情、首页云小医浮窗、流畅的页面过渡。
- **数字化看板**：立体化统计卡片、角色化首页工作台、专业医学图表与健康提醒对话化呈现。

## ✨ 核心功能

### 1. 数字化健康档案 📋
- **全生命周期管理**：电子病历、体检报告、用药史、过敏史的一站式存储与回溯。
- **智能化检索**：支持关键词多维度搜索与附件在线预览。

### 2. AI 临床级智能问诊 🤖
- **深度症状分析**：利用 DeepSeek 大模型进行多轮对话，提供精准的健康咨询与科室引导。
- **医学验证保障**：AI 回复经过预设医学逻辑校验，提供专业化建议。
- **情感化交互**：定制化医疗机器人形象，具备实时录入反馈与打字机效果。
- **云小医 Agent**：登录后首页展示角色化机器人浮窗，将健康提醒、用药提醒、检查复查、接诊提醒和管理提醒放入对话中处理。

### 3. 健康预测与实时监测 📈
- **体征趋势可视化**：血压、血糖、心率、体温等关键指标的动态对比看板。
- **异常智能预警**：基于临床标准的 5 级状态自动判定（正常、注意、警告、严重、危险）。
- **AI 健康周报**：自动汇总监测数据，生成个性化健康建议。

### 4. 智慧挂号与导诊 📅
- **动态排班系统**：医生工作模式与号源实时同步。
- **冲突检测机制**：智能识别重叠预约，保障挂号流程丝滑无阻。




## 🛠️ 技术栈

### 后端技术
- **核心框架**: Spring Boot 2.7.x
- **安全框架**: Spring Security + JWT
- **持久层**: MyBatis-Plus 3.5.x
- **数据库**: MySQL 8.0
- **缓存**: Redis 7.x
- **API文档**: Knife4j (Swagger3)
- **日志**: Logback + SLF4J
- **定时任务**: Quartz
- **实时通信**: WebSocket
- **AI集成**: DeepSeek API

### 前端技术
- **框架**: Vue 3.x
- **UI组件**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router 4.x
- **HTTP客户端**: Axios
- **图表**: ECharts
- **构建工具**: Vite

### 开发工具
- **项目管理**: Maven 3.8+
- **版本控制**: Git
- **开发IDE**: IntelliJ IDEA / VSCode
- **接口测试**: Postman / Apifox

## 📦 项目结构

```
medical-health-system/
├── docs/                           # 项目文档
│   ├── sql/                       # 数据库脚本
│   ├── api/                       # API接口文档
│   └── design/                    # 设计文档
├── medical-backend/                # 后端项目
│   ├── medical-common/            # 公共模块
│   │   ├── common-core/          # 核心工具类
│   │   ├── common-security/      # 安全配置
│   │   └── common-redis/         # Redis配置
│   ├── medical-system/            # 系统服务模块
│   │   ├── controller/           # 控制器
│   │   ├── service/              # 业务层
│   │   ├── mapper/               # 数据访问层
│   │   ├── entity/               # 实体类
│   │   └── dto/                  # 数据传输对象
│   ├── medical-ai/                # AI服务模块
│   │   ├── deepseek/             # DeepSeek集成
│   │   ├── analyzer/             # 数据分析
│   │   └── recommender/          # 推荐引擎
│   ├── medical-schedule/          # 定时任务模块
│   └── medical-admin/             # 系统管理模块
├── medical-frontend/               # 前端项目
│   ├── src/
│   │   ├── api/                  # API接口
│   │   ├── components/           # 公共组件
│   │   ├── views/                # 页面
│   │   ├── router/               # 路由
│   │   ├── store/                # 状态管理
│   │   ├── utils/                # 工具类
│   │   └── assets/               # 静态资源
│   └── public/
├── .gitignore
├── README.md
└── pom.xml                         # Maven父项目配置
```

## 🚀 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 6.0+
- Node.js 18+

### 配置敏感信息（环境变量）
后端 `application.yml` 通过环境变量读取数据库、Redis、JWT 与 DeepSeek 配置。启动前请设置以下变量（示例值可按需调整）：

```powershell
# Windows PowerShell
$Env:DB_URL="jdbc:mysql://localhost:3306/medical_health?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true"
$Env:DB_USERNAME="root"
$Env:DB_PASSWORD="<your_db_password>"
$Env:REDIS_HOST="localhost"
$Env:REDIS_PORT="6379"
$Env:REDIS_PASSWORD=""
$Env:JWT_SECRET="<generate_a_strong_secret>"
$Env:DEEPSEEK_API_KEY="<your_deepseek_api_key>"
# 可选覆盖
$Env:DEEPSEEK_API_URL="https://api.deepseek.com/v1/chat/completions"
$Env:DEEPSEEK_MODEL="deepseek-chat"
```

```bash
# macOS / Linux
export DB_URL="jdbc:mysql://localhost:3306/medical_health?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true"
export DB_USERNAME="root"
export DB_PASSWORD="<your_db_password>"
export REDIS_HOST="localhost"
export REDIS_PORT="6379"
export REDIS_PASSWORD=""
export JWT_SECRET="<generate_a_strong_secret>"
export DEEPSEEK_API_KEY="<your_deepseek_api_key>"
# 可选覆盖
export DEEPSEEK_API_URL="https://api.deepseek.com/v1/chat/completions"
export DEEPSEEK_MODEL="deepseek-chat"
```

也可以复制 `medical-backend/.env.example` 为本地 `.env` 管理变量；`.env` 已被 Git 忽略。Spring Boot 默认读取系统环境变量，若使用 `.env` 文件，请通过 IDE EnvFile 插件、启动脚本或终端命令先加载变量后再启动。

如果未设置某个变量，应用会使用 `application.yml` 中定义的安全默认值；其中数据库密码默认为空，生产环境请务必覆盖 `DB_PASSWORD` 和 `JWT_SECRET`。

### 后端启动

1. **克隆项目**
```bash
git clone [项目地址]
cd medical-health-system
```

2. **创建数据库**
```bash
# 执行数据库脚本
mysql -u root -p < docs/sql/medical_health.sql
```

3. **配置敏感信息**
确保已按上文设置环境变量，或在本地新增 `application-local.yml` 并通过 `spring.profiles.active=local` 方式覆盖默认值。

4. **编译运行**
```bash
# 编译项目
mvn clean install

# 运行主程序
cd medical-backend/medical-admin
mvn spring-boot:run
```

后端服务默认运行在: http://localhost:8080

### 前端启动

1. **安装依赖**
```bash
cd medical-frontend
npm install
```

2. **修改配置**
```javascript
// .env.development
VITE_APP_BASE_API=http://localhost:8080
```

3. **运行项目**
```bash
npm run dev
```


前端服务默认运行在: http://localhost:3000

## 📚 文档说明

- [数据库设计文档](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/DATABASE.md)
- [API接口文档](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/API.md)
- [DeepSeek集成指南](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/DEEPSEEK_INTEGRATION.md)
- [部署文档](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/DEPLOYMENT.md)
- [开发规范](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/DEVELOPMENT.md)
- [文档索引（建议从这里开始）](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/README.md)
- [迭代计划（进行中）](https://github.com/neverlbc/-medical-health-system/blob/HEAD/docs/plans/README.md)

## 🔑 默认账号

### 管理员
- 账号: admin
- 密码: admin123

### 医生
- 账号: doctor
- 密码: doctor123

### 患者
- 账号: patient
- 密码: patient123

## 🌍 在线演示 (Live Demo)

系统已部署至全球公网，欢迎体验：
- **主入口 (HTTPS)**：[https://lbc-ai.top](https://lbc-ai.top)
- **业务备用**：[https://medical.lbc-ai.top](https://medical.lbc-ai.top)
> *注：演示环境采用美国节点，国内访问无需翻墙，体验如丝般顺滑。*

## 📝 开发进度 (截至 2026-01-27)

- [x] **项目架构设计** - 后端多模块 Spring Boot + 前端 Vue 3 生态
- [x] **数据库设计** - 12张核心业务表 + 视图 + 触发器
- [x] **用户认证模块** - JWT 全局认证 + 角色动态路由
- [x] **Premium UI/UX 重塑** ⭐ - "Digital Clinical" 视觉体系，全系统高端化优化
- [x] **DeepSeek AI 集成** - 症状分析、健康问答、用药指导
- [x] **健康档案模块** - 电子病历存储、附件管理、历史回溯
- [x] **健康监测模块** - ECharts 趋势图、5级临床状态自动判定、异常智能预警
- [x] **智能问诊功能完善** - 定制化 AI 机器人、Markdown 渲染、对话历史保存
- [x] **预约挂号模块** ⭐ - **100% 完成**，支持动态排班、实时号源监控、冲突校验
- [x] **公网部署发布** - **100% 完成**，支持 HTTPS 加密、Systemd 守护、Nginx 动静分离
- [x] **Git 仓库管理** - 代码已同步至远程仓库 (GitHub)
- [x] **多端适配优化** - 基础适配已完成，支持主流浏览器

## ⚠️ 重要说明

1. **医疗免责声明**: 本系统提供的 AI 诊断建议仅供参考，不能替代专业医生的诊断。如有不适，请及时就医。

2. **数据安全**: 系统涉及个人健康隐私数据，已采取加密存储、访问控制等安全措施。

3. **API 限制**: DeepSeek API 调用有频率限制，建议合理使用并做好缓存策略。

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request

## 📄 开源协议

本项目采用 MIT 协议

## 👨‍💻 作者信息

- 作者: lbc
- 项目类型: 毕业设计
- 完成时间: 2025年

## 📞 联系方式

如有问题，欢迎通过以下方式联系：
- Email: [您的邮箱]
- GitHub: [您的GitHub]

---

⭐ 如果这个项目对你有帮助，欢迎 Star 支持！

智慧医疗健康管理系统 (Smart Medical Health System) ✨

温暖 · 临床 · 智能 —— 基于 Spring Boot 2.7 与 DeepSeek AI 生态构建的现代化智慧医疗管理解决方案。

🎨 视觉美学 (Digital Clinical Design)

本项目采用 “温暖高级医疗 (Warm Premium Clinical)” 视觉体系，追求可信、克制、有人情味的交互体验：

高端医疗色调：暖棕、米白、鼠尾草绿与柔和玫瑰色统一替代大面积蓝白配色。
动态交互：登录页医学动效、AI 机器人微表情、首页云小医浮窗、流畅的页面过渡。
数字化看板：立体化统计卡片、角色化首页工作台、专业医学图表与健康提醒对话化呈现。

✨ 核心功能

1. 数字化健康档案 📋

全生命周期管理：电子病历、体检报告、用药史、过敏史的一站式存储与回溯。
智能化检索：支持关键词多维度搜索与附件在线预览。

2. AI 临床级智能问诊 🤖

深度症状分析：利用 DeepSeek 大模型进行多轮对话，提供精准的健康咨询与科室引导。
医学验证保障：AI 回复经过预设医学逻辑校验，提供专业化建议。
情感化交互：定制化医疗机器人形象，具备实时录入反馈与打字机效果。
云小医 Agent：登录后首页展示角色化机器人浮窗，将健康提醒、用药提醒、检查复查、接诊提醒和管理提醒放入对话中处理。

3. 健康预测与实时监测 📈

体征趋势可视化：血压、血糖、心率、体温等关键指标的动态对比看板。
异常智能预警：基于临床标准的 5 级状态自动判定（正常、注意、警告、严重、危险）。
AI 健康周报：自动汇总监测数据，生成个性化健康建议。

4. 智慧挂号与导诊 📅

动态排班系统：医生工作模式与号源实时同步。
冲突检测机制：智能识别重叠预约，保障挂号流程丝滑无阻。

🛠️ 技术栈

后端技术

核心框架: Spring Boot 2.7.x
安全框架: Spring Security + JWT
持久层: MyBatis-Plus 3.5.x
数据库: MySQL 8.0
缓存: Redis 7.x
API文档: Knife4j (Swagger3)
日志: Logback + SLF4J
定时任务: Quartz
实时通信: WebSocket
AI集成: DeepSeek API

前端技术

框架: Vue 3.x
UI组件: Element Plus
状态管理: Pinia
路由: Vue Router 4.x
HTTP客户端: Axios
图表: ECharts
构建工具: Vite

开发工具

项目管理: Maven 3.8+
版本控制: Git
开发IDE: IntelliJ IDEA / VSCode
接口测试: Postman / Apifox

📦 项目结构

medical-health-system/
├── docs/                           # 项目文档
│   ├── sql/                       # 数据库脚本
│   ├── api/                       # API接口文档
│   └── design/                    # 设计文档
├── medical-backend/                # 后端项目
│   ├── medical-common/            # 公共模块
│   │   ├── common-core/          # 核心工具类
│   │   ├── common-security/      # 安全配置
│   │   └── common-redis/         # Redis配置
│   ├── medical-system/            # 系统服务模块
│   │   ├── controller/           # 控制器
│   │   ├── service/              # 业务层
│   │   ├── mapper/               # 数据访问层
│   │   ├── entity/               # 实体类
│   │   └── dto/                  # 数据传输对象
│   ├── medical-ai/                # AI服务模块
│   │   ├── deepseek/             # DeepSeek集成
│   │   ├── analyzer/             # 数据分析
│   │   └── recommender/          # 推荐引擎
│   ├── medical-schedule/          # 定时任务模块
│   └── medical-admin/             # 系统管理模块
├── medical-frontend/               # 前端项目
│   ├── src/
│   │   ├── api/                  # API接口
│   │   ├── components/           # 公共组件
│   │   ├── views/                # 页面
│   │   ├── router/               # 路由
│   │   ├── store/                # 状态管理
│   │   ├── utils/                # 工具类
│   │   └── assets/               # 静态资源
│   └── public/
├── .gitignore
├── README.md
└── pom.xml                         # Maven父项目配置

🚀 快速开始

环境要求

JDK 17+
Maven 3.8+
MySQL 8.0+
Redis 6.0+
Node.js 18+

配置敏感信息（环境变量）

后端 application.yml 通过环境变量读取数据库、Redis、JWT 与 DeepSeek 配置。启动前请设置以下变量（示例值可按需调整）：

# Windows PowerShell
$Env:DB_URL="jdbc:mysql://localhost:3306/medical_health?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true"
$Env:DB_USERNAME="root"
$Env:DB_PASSWORD="<your_db_password>"
$Env:REDIS_HOST="localhost"
$Env:REDIS_PORT="6379"
$Env:REDIS_PASSWORD=""
$Env:JWT_SECRET="<generate_a_strong_secret>"
$Env:DEEPSEEK_API_KEY="<your_deepseek_api_key>"
# 可选覆盖
$Env:DEEPSEEK_API_URL="https://api.deepseek.com/v1/chat/completions"
$Env:DEEPSEEK_MODEL="deepseek-chat"

# macOS / Linux
export DB_URL="jdbc:mysql://localhost:3306/medical_health?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true"
export DB_USERNAME="root"
export DB_PASSWORD="<your_db_password>"
export REDIS_HOST="localhost"
export REDIS_PORT="6379"
export REDIS_PASSWORD=""
export JWT_SECRET="<generate_a_strong_secret>"
export DEEPSEEK_API_KEY="<your_deepseek_api_key>"
# 可选覆盖
export DEEPSEEK_API_URL="https://api.deepseek.com/v1/chat/completions"
export DEEPSEEK_MODEL="deepseek-chat"

也可以复制 medical-backend/.env.example 为本地 .env 管理变量；.env 已被 Git 忽略。Spring Boot 默认读取系统环境变量，若使用 .env 文件，请通过 IDE EnvFile 插件、启动脚本或终端命令先加载变量后再启动。

如果未设置某个变量，应用会使用 application.yml 中定义的安全默认值；其中数据库密码默认为空，生产环境请务必覆盖 DB_PASSWORD 和 JWT_SECRET。

后端启动

克隆项目

git clone [项目地址]
cd medical-health-system

创建数据库

# 执行数据库脚本
mysql -u root -p < docs/sql/medical_health.sql

配置敏感信息 确保已按上文设置环境变量，或在本地新增 application-local.yml 并通过 spring.profiles.active=local 方式覆盖默认值。
编译运行

# 编译项目
mvn clean install

# 运行主程序
cd medical-backend/medical-admin
mvn spring-boot:run

后端服务默认运行在: http://localhost:8080

前端启动

安装依赖

cd medical-frontend
npm install

修改配置

// .env.development
VITE_APP_BASE_API=http://localhost:8080

运行项目

npm run dev

前端服务默认运行在: http://localhost:3000

📚 文档说明

🔑 默认账号

管理员

账号: admin
密码: admin123

医生

账号: doctor
密码: doctor123

患者

账号: patient
密码: patient123

🌍 在线演示 (Live Demo)

系统已部署至全球公网，欢迎体验：

主入口 (HTTPS)：https://lbc-ai.top
业务备用：https://medical.lbc-ai.top

注：演示环境采用美国节点，国内访问无需翻墙，体验如丝般顺滑。

📝 开发进度 (截至 2026-01-27)

项目架构设计 - 后端多模块 Spring Boot + 前端 Vue 3 生态
数据库设计 - 12张核心业务表 + 视图 + 触发器
用户认证模块 - JWT 全局认证 + 角色动态路由
Premium UI/UX 重塑 ⭐ - "Digital Clinical" 视觉体系，全系统高端化优化
DeepSeek AI 集成 - 症状分析、健康问答、用药指导
健康档案模块 - 电子病历存储、附件管理、历史回溯
健康监测模块 - ECharts 趋势图、5级临床状态自动判定、异常智能预警
智能问诊功能完善 - 定制化 AI 机器人、Markdown 渲染、对话历史保存
预约挂号模块 ⭐ - 100% 完成，支持动态排班、实时号源监控、冲突校验
公网部署发布 - 100% 完成，支持 HTTPS 加密、Systemd 守护、Nginx 动静分离
Git 仓库管理 - 代码已同步至远程仓库 (GitHub)
多端适配优化 - 基础适配已完成，支持主流浏览器

⚠️ 重要说明

医疗免责声明: 本系统提供的 AI 诊断建议仅供参考，不能替代专业医生的诊断。如有不适，请及时就医。
数据安全: 系统涉及个人健康隐私数据，已采取加密存储、访问控制等安全措施。
API 限制: DeepSeek API 调用有频率限制，建议合理使用并做好缓存策略。

🤝 贡献指南

欢迎提交 Issue 和 Pull Request

📄 开源协议

本项目采用 MIT 协议

👨‍💻 作者信息

作者: lbc
项目类型: 毕业设计
完成时间: 2025年

📞 联系方式

如有问题，欢迎通过以下方式联系：

Email: [您的邮箱]
GitHub: [您的GitHub]

⭐ 如果这个项目对你有帮助，欢迎 Star 支持！