Skip to content

README.md

Latest commit

 

History

History
347 lines (245 loc) · 10.1 KB

README.md

File metadata and controls

347 lines (245 loc) · 10.1 KB

医院管理系统 (HIMS)

项目简介

医院管理系统(HIMS)是一个基于 Spring Boot 和 Vue 3 的全栈应用程序，旨在帮助医院管理预约挂号、医生排班、患者信息等功能。系统采用前后端分离架构，前端使用 Vue 3 + Element Plus 构建用户界面，后端使用 Spring Boot 提供 API 服务。 image

G:\StudentCode\HIMS\PixPin_2025-06-09_20-12-57.png

技术栈

后端

  • Spring Boot 2.7.0
  • Spring Security
  • MyBatis-Plus 3.5.2
  • JWT 认证
  • MySQL 数据库

前端

  • Vue 3
  • TypeScript
  • Element Plus
  • Echarts
  • Pinia (状态管理)
  • Vue Router

系统功能

  • 用户认证与授权
  • 医生管理
  • 患者管理
  • 预约挂号
  • 科室管理
  • 数据统计与可视化

快速开始

环境要求

  • JDK 8+
  • Node.js 14+
  • Maven 3.6+
  • MySQL 5.7+

首次使用

如果您是首次使用本系统，请按照以下步骤操作：

  1. 双击运行create-database.bat创建 MySQL 数据库
  2. 双击运行install-dependencies.bat安装所有必要的依赖
  3. 根据提示完成依赖安装
  4. 安装完成后，使用下方的启动方式启动系统

启动方式

方式一：使用批处理脚本(推荐)

  1. 双击运行项目根目录下的start-hims.bat文件
  2. 系统将自动检查环境并启动前端和后端服务
  3. 如遇问题，请参考脚本提示和下方的常见问题解决方案

方式二：生产环境启动

  1. 双击运行项目根目录下的start-hims-prod.bat文件
  2. 系统将构建前端生产版本并以生产模式启动服务

方式三：自定义配置启动

  1. 编辑start-hims-config.bat文件，根据您的环境设置参数
  2. 双击运行start-hims.bat或start-hims-prod.bat启动系统

方式四：PowerShell 兼容启动（适用于 PowerShell 环境）

  1. 如果在 PowerShell 中遇到"&&"不是有效语句分隔符的错误
  2. 双击运行start-hims-powershell.bat文件启动系统
  3. 此脚本专为 PowerShell 环境优化，解决了命令连接符问题

方式五：手动启动

启动后端:

cd backend
./mvnw spring-boot:run

启动前端:

cd frontend
npm install
npm run dev

常见问题

  1. 如果遇到"&&"不是有效语句分隔符的错误，请使用 PowerShell 兼容版启动脚本：

    start-hims-powershell.bat

  2. 如果需要自动安装依赖：

    install-dependencies.bat

  3. 如果需要创建数据库：

    create-database.bat

  4. 如果遇到文件权限问题：

    fix-permissions.bat

访问系统

系统账号

系统预设了以下账号，可用于测试：

  • 管理员账号:

    • 用户名: admin
    • 密码: admin123

项目结构

HIMS/
├── backend/                # 后端项目
│   ├── src/                # 源代码
│   │   ├── main/
│   │   │   ├── java/com/hims/
│   │   │   │   ├── config/        # 配置类
│   │   │   │   ├── controller/    # 控制器
│   │   │   │   ├── entity/        # 实体类
│   │   │   │   ├── mapper/        # MyBatis映射
│   │   │   │   ├── security/      # 安全配置
│   │   │   │   ├── service/       # 服务层
│   │   │   │   └── HimsApplication.java  # 启动类
│   │   │   └── resources/         # 资源文件
│   │   │       ├── application.yml  # 应用配置
│   │   │       └── mapper/        # MyBatis XML
│   │   │
│   └── pom.xml              # Maven配置
├── frontend/               # 前端项目
│   ├── public/             # 静态资源
│   ├── src/                # 源代码
│   │   ├── assets/         # 资源文件
│   │   ├── components/     # 组件
│   │   ├── router/         # 路由
│   │   ├── stores/         # Pinia状态
│   │   ├── views/          # 视图
│   │   ├── App.vue         # 根组件
│   │   └── main.ts         # 入口文件
│   ├── index.html          # HTML模板
│   └── package.json        # NPM配置
├── start-hims.bat          # 开发环境快速启动脚本
├── start-hims-prod.bat     # 生产环境启动脚本
├── start-hims-config.bat   # 系统配置文件
├── install-dependencies.bat # 依赖安装脚本
├── create-database.bat     # 数据库初始化脚本
└── fix-permissions.bat     # 权限修复工具

辅助脚本说明

系统提供了多个辅助脚本，帮助您更轻松地部署和维护系统：

脚本名称 用途 使用场景
start-hims.bat 开发环境启动脚本 日常开发和测试使用
start-hims-prod.bat 生产环境启动脚本 部署到生产环境使用
start-hims-config.bat 系统配置文件 自定义数据库连接、端口等配置
install-dependencies.bat 依赖安装脚本 首次使用或依赖更新时使用
create-database.bat 数据库初始化脚本 首次使用或需要重建数据库时使用
fix-permissions.bat 权限修复工具 遇到权限相关问题时使用

配置说明

系统配置文件 (start-hims-config.bat)

您可以通过编辑start-hims-config.bat文件来自定义系统配置：

rem MySQL配置
set MYSQL_HOST=localhost
set MYSQL_PORT=3306
set MYSQL_DATABASE=hims
set MYSQL_USERNAME=root
set MYSQL_PASSWORD=65353804778

rem 服务端口配置
set BACKEND_PORT=8080
set FRONTEND_PORT=3002

rem JDK路径配置（如果已设置JAVA_HOME环境变量，可以保留为空）
set JAVA_PATH=

rem Node.js路径配置（如果已添加到PATH环境变量，可以保留为空）
set NODE_PATH=

环境配置文件

系统支持多环境配置：

  • application.yml: 基础配置
  • application-dev.yml: 开发环境配置
  • application-prod.yml: 生产环境配置
  • application-local.yml: 本地环境配置（由启动脚本自动生成）

开发指南

后端开发

  1. 使用 IntelliJ IDEA 或 Eclipse 打开 backend 目录
  2. 修改application.yml中的数据库配置
  3. 运行HimsApplication.java启动应用

前端开发

  1. 使用 VS Code 打开 frontend 目录
  2. 安装依赖: npm install
  3. 启动开发服务器: npm run dev
  4. 构建生产版本: npm run build

Windows 兼容性指南

为了确保系统在 Windows 环境(特别是 Windows 10/11)下正常运行，请注意以下事项：

系统要求

  • Windows 10/11 (64 位)
  • 已安装 JDK 8 或更高版本，并正确配置 JAVA_HOME 环境变量
  • 已安装 Node.js 14 或更高版本
  • 已安装 MySQL 5.7 或 8.0，并启动 MySQL 服务
  • 确保防火墙未阻止应用程序访问网络

常见问题解决方案

1. MySQL 连接问题

如果遇到 MySQL 连接错误，请检查：

  • MySQL 服务是否已启动（可在服务管理中查看）
  • 数据库用户名和密码是否正确（默认为 root/65353804778）
  • 是否已创建 hims 数据库（可使用create-database.bat脚本创建）
  • 修改start-hims-config.bat中的数据库配置以匹配您的环境

2. 端口占用问题

如果 8080 或 3002 端口被占用：

  • 修改start-hims-config.bat中的BACKEND_PORT和FRONTEND_PORT参数
  • 使用netstat -ano | findstr 8080查找占用端口的进程

3. 路径问题

如果遇到路径相关错误：

  • 确保项目路径不包含中文字符或特殊符号
  • 确保使用管理员权限运行命令提示符或 PowerShell
  • 如果使用 IDE，尝试以管理员身份运行 IDE
  • 运行fix-permissions.bat脚本修复文件权限问题

4. Node.js 依赖问题

如果前端依赖安装失败：

  • 运行install-dependencies.bat脚本，它会自动尝试多种方式安装依赖
  • 如果仍然失败，尝试手动执行以下命令： 
    cd frontend
npm cache clean --force
npm install --legacy-peer-deps
  • 如果网络问题导致安装失败，可以尝试使用 cnpm： 
    npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install

5. Java 相关问题

如果后端启动失败：

  • 确认 JDK 版本兼容（推荐 JDK 8 或 JDK 11）
  • 检查 JAVA_HOME 环境变量是否正确设置
  • 在start-hims-config.bat中设置正确的JAVA_PATH

6. 权限问题

如果遇到"拒绝访问"或权限相关错误：

  • 以管理员身份运行fix-permissions.bat脚本
  • 确保当前用户对项目目录有完全控制权限
  • 检查杀毒软件是否阻止了某些操作

注意事项

  • 确保 MySQL 服务已启动且配置正确
  • 首次运行时，系统会自动初始化数据库结构
  • 开发环境下使用的是开发证书，生产环境需要更新安全配置
  • 如需在局域网内访问，请确保防火墙允许相应端口通行

故障排除

如果启动脚本无法正常工作，可以尝试以下步骤：

  1. 运行fix-permissions.bat修复可能的权限问题

  2. 运行create-database.bat确保数据库已正确创建

  3. 运行install-dependencies.bat确保所有依赖已正确安装

  4. 检查 Java 和 Node.js 是否正确安装：

    • 在命令提示符中运行java -version和node -v
    • 确保版本符合要求

  5. 手动启动服务：

    • 打开两个命令提示符窗口
    • 在第一个窗口中，导航到 backend 目录并运行mvnw spring-boot:run
    • 在第二个窗口中，导航到 frontend 目录并运行npm install然后npm run dev

  6. 检查日志：

    • 后端日志位于logs/hims.log
    • 前端日志会显示在命令提示符窗口中

  7. 数据库重置：

    • 如果数据库结构有问题，可以删除 hims 数据库并重新创建
    • 运行create-database.bat脚本重新创建数据库
    • 然后重新启动后端服务