--- slug: "medical-health-system" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/neverlbc/-medical-health-system@main/README.md" repo: "https://github.com/neverlbc/-medical-health-system" source_file: "README.md" branch: "main" --- # 智慧医疗健康管理系统 (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="" $Env:REDIS_HOST="localhost" $Env:REDIS_PORT="6379" $Env:REDIS_PASSWORD="" $Env:JWT_SECRET="" $Env: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="" export REDIS_HOST="localhost" export REDIS_PORT="6379" export REDIS_PASSWORD="" export JWT_SECRET="" export 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 支持！