# Outpatient Appointment System **Repository Path**: yangleduo7788/outpatient-appointment-system ## Basic Information - **Project Name**: Outpatient Appointment System - **Description**: 基于 Spring Boot 3 + Vue 3 的现代化门诊挂号管理系统,前后端分离架构 | RESTful API | JWT 双 Token 认证 | 企业级代码规范,智慧门诊挂号管理系统是一款面向中小型医疗机构的综合性信息化解决方案。系统涵盖**患者端(C端)与管理后台(B端)**两大入口,支持在线挂号、科室浏览、医生查询、药品信息查看、排班管理、数据统计等核心功能。 - **Primary Language**: Unknown - **License**: MPL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-05-30 - **Last Updated**: 2026-06-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# 智慧门诊挂号管理系统

Spring Boot Java Vue TypeScript MySQL MyBatis Element Plus License

基于 Spring Boot 3 + Vue 3 的现代化门诊挂号管理系统
前后端分离架构 | RESTful API | JWT 双 Token 认证 | 企业级代码规范

--- ## 目录 - [项目简介](#项目简介) - [系统架构](#系统架构) - [技术栈](#技术栈) - [功能模块](#功能模块) - [项目结构](#项目结构) - [快速开始](#快速开始) - [数据库设计](#数据库设计) - [API 文档](#api-文档) - [部署方案](#部署方案) - [开发规范](#开发规范) - [贡献指南](#贡献指南) - [许可证](#许可证) --- ## 项目简介 智慧门诊挂号管理系统是一款面向中小型医疗机构的综合性信息化解决方案。系统涵盖**患者端(C端)**与**管理后台(B端)**两大入口,支持在线挂号、科室浏览、医生查询、药品信息查看、排班管理、数据统计等核心功能。 ### 核心特性 | 特性 | 说明 | |------|------| | **双端分离** | 患者端(用户预约)与管理端(运营管控)独立部署,权限隔离 | | **JWT 双 Token** | 用户端与管理员端分别使用独立密钥签发 Token,安全隔离 | | **雪花 ID** | 全库采用雪花算法生成分布式唯一主键,支撑高并发场景 | | **统一响应** | 后端统一返回 `Result` 结构,前端统一拦截处理 | | **分层架构** | Controller / Service / Mapper 三层分离,DTO / VO / Entity 职责清晰 | | **数据安全** | 密码 BCrypt 加密存储,身份证号脱敏展示,SQL 注入防护 | | **日志追踪** | 完整记录操作日志,支持审计回溯 | --- ## 系统架构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 客户端层 │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 用户浏览器 │ │ 管理员浏览器 │ │ 移动端 H5 │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ └─────────┼─────────────────┼─────────────────┼──────────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 前端应用层 │ │ ┌────────────────────────┐ ┌────────────────────────┐ │ │ │ clinic-web (Vue3) │ │ clinic-web (Vue3) │ │ │ │ 患者端:5173端口 │ │ 管理端:同应用路由隔离 │ │ │ │ Vite + TS + ElementPlus│ │ Pinia + VueRouter + Axios│ │ │ └───────────┬────────────┘ └───────────┬────────────┘ │ └──────────────┼───────────────────────────┼─────────────────────┘ │ │ └───────────┬───────────────┘ │ RESTful API / JSON ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 后端服务层 │ │ ┌─────────────────────────────┐ │ │ │ clinic-server (Spring Boot) │ │ │ │ 端口:8080 │ │ │ │ ┌─────┐ ┌─────┐ ┌─────┐ │ │ │ │ │Controller│ │Service│ │Mapper│ │ │ │ │ └─────┘ └─────┘ └─────┘ │ │ │ │ JWT拦截器 │ 全局异常 │ AOP日志 │ │ │ └──────────────┬──────────────┘ │ └─────────────────────────────┼───────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 数据存储层 │ │ ┌────────────────┐ ┌────────────────┐ │ │ │ MySQL 8.0 │ │ (可扩展 Redis) │ │ │ │ clinic_db │ │ 缓存/会话/限流 │ │ │ └────────────────┘ └────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## 技术栈 ### 后端技术栈 | 技术 | 版本 | 用途 | |------|------|------| | Spring Boot | 3.2.0 | 核心框架 | | Java | 21 | 开发语言 | | MyBatis Spring Boot Starter | 3.0.3 | ORM 框架 | | MySQL Connector/J | 8.x | 数据库驱动 | | Spring Security Crypto | 6.x | BCrypt 密码加密 | | JJWT | 0.12.3 | JWT Token 生成与校验 | | Hutool | 5.8.25 | 工具类库 | | Knife4j (OpenAPI3) | 4.4.0 | API 文档 | | Lombok | 1.18.x | 代码简化 | | Maven | 3.9+ | 构建工具 | ### 前端技术栈 | 技术 | 版本 | 用途 | |------|------|------| | Vue | 3.4.x | 前端框架 | | TypeScript | 5.3.x | 类型系统 | | Vite | 5.1.x | 构建工具 | | Element Plus | 2.5.x | UI 组件库 | | Vue Router | 4.3.x | 路由管理 | | Pinia | 2.1.x | 状态管理 | | Pinia Persistedstate | 3.2.x | 状态持久化 | | Axios | 1.6.x | HTTP 客户端 | | ECharts | 5.5.x | 数据可视化 | | Dayjs | 1.11.x | 日期处理 | --- ## 功能模块 ### 患者端(C端) | 模块 | 功能描述 | |------|----------| | **用户认证** | 注册、登录、JWT Token 管理、个人资料修改、密码修改 | | **科室浏览** | 科室列表展示、科室详情查看、按科室筛选医生 | | **医生查询** | 医生列表、医生详情、擅长领域、挂号费用 | | **在线挂号** | 选择科室/医生/日期/时段、填写就诊人信息、提交挂号 | | **我的挂号** | 挂号记录列表、取消挂号、查看挂号详情 | | **药品信息** | 药品列表浏览、药品详情(规格、价格、库存、厂家) | | **个人中心** | 个人信息管理、实名认证、就诊人管理 | ### 管理后台(B端) | 模块 | 功能描述 | |------|----------| | **管理员登录** | 独立登录入口、JWT 管理员 Token、权限控制 | | **仪表盘** | 数据概览卡片、近7日挂号趋势柱状图、挂号状态分布饼图、本月趋势折线图 | | **用户管理** | 用户列表、关键词搜索(用户名/姓名/手机号)、用户详情、删除用户 | | **医生管理** | 医生 CRUD、科室关联、职称选择、状态管理 | | **科室管理** | 科室 CRUD、排序管理、状态管理 | | **药品管理** | 药品 CRUD、库存管理、分类管理、状态管理 | | **排班管理** | 医生排班设置、时段管理(上午/下午/晚上)、号源数配置 | | **挂号管理** | 挂号记录列表、状态管理、数据统计 | | **统计分析** | 多维度数据统计、可视化图表展示 | --- ## 项目结构 ``` Outpatient Appointment System/ ├── clinic-server/ # 后端服务 │ ├── src/main/java/com/clinic/ │ │ ├── ClinicApplication.java # 启动类 │ │ ├── common/ # 通用类 │ │ │ ├── PageResult.java # 分页结果封装 │ │ │ ├── Result.java # 统一响应封装 │ │ │ └── ResultCode.java # 响应码枚举 │ │ ├── config/ # 配置类 │ │ │ ├── CorsConfig.java # 跨域配置 │ │ │ ├── JacksonConfig.java # JSON 序列化配置 │ │ │ ├── PasswordEncoderConfig.java # 密码加密配置 │ │ │ ├── SwaggerConfig.java # API 文档配置 │ │ │ └── WebMvcConfig.java # WebMVC 配置 │ │ ├── controller/ # 控制层 │ │ │ ├── AdminController.java │ │ │ ├── DashboardController.java │ │ │ ├── DepartmentController.java │ │ │ ├── DoctorController.java │ │ │ ├── MedicineController.java │ │ │ ├── RegistrationController.java │ │ │ ├── ScheduleController.java │ │ │ └── UserController.java │ │ ├── dto/ # 数据传输对象 │ │ │ ├── DepartmentDto.java │ │ │ ├── DoctorDto.java │ │ │ ├── LoginDto.java │ │ │ ├── MedicineDto.java │ │ │ ├── PasswordDto.java │ │ │ ├── RegisterDto.java │ │ │ ├── RegistrationDto.java │ │ │ ├── ScheduleDto.java │ │ │ └── UserUpdateDto.java │ │ ├── entity/ # 实体类 │ │ │ ├── Admin.java │ │ │ ├── BaseEntity.java # 基础实体(ID、时间戳、逻辑删除) │ │ │ ├── Department.java │ │ │ ├── Doctor.java │ │ │ ├── Log.java │ │ │ ├── Medicine.java │ │ │ ├── Registration.java │ │ │ ├── Schedule.java │ │ │ └── User.java │ │ ├── exception/ # 异常处理 │ │ │ ├── BusinessException.java │ │ │ └── GlobalExceptionHandler.java │ │ ├── interceptor/ # 拦截器 │ │ │ ├── AdminAuthInterceptor.java # 管理员权限拦截 │ │ │ └── JwtAuthInterceptor.java # 用户权限拦截 │ │ ├── mapper/ # Mapper 接口 │ │ ├── service/ # 服务接口 │ │ ├── serviceImpl/ # 服务实现 │ │ ├── utils/ # 工具类 │ │ │ ├── JwtUtils.java # JWT 工具 │ │ │ └── SnowflakeIdUtils.java # 雪花 ID 生成器 │ │ └── vo/ # 视图对象 │ ├── src/main/resources/ │ │ ├── mapper/ # MyBatis XML 映射文件 │ │ └── application.yml # 应用配置 │ └── pom.xml # Maven 配置 │ ├── clinic-web/ # 前端应用 │ ├── src/ │ │ ├── api/ # API 接口封装 │ │ │ ├── admin.ts │ │ │ ├── dashboard.ts │ │ │ ├── department.ts │ │ │ ├── doctor.ts │ │ │ ├── index.ts # Axios 实例配置 │ │ │ ├── medicine.ts │ │ │ ├── registration.ts │ │ │ ├── schedule.ts │ │ │ └── user.ts │ │ ├── assets/styles/ # 全局样式 │ │ ├── layout/ # 布局组件 │ │ │ ├── AdminLayout.vue # 管理后台布局 │ │ │ └── UserLayout.vue # 用户端布局 │ │ ├── router/ # 路由配置 │ │ │ └── index.ts │ │ ├── store/ # Pinia 状态管理 │ │ │ ├── admin.ts # 管理员状态 │ │ │ └── user.ts # 用户状态 │ │ ├── utils/ # 工具函数 │ │ │ └── auth.ts # 认证相关工具 │ │ ├── views/ # 页面视图 │ │ │ ├── admin/ # 管理后台页面 │ │ │ │ ├── AdminDashboard.vue # 仪表盘 │ │ │ │ ├── AdminLogin.vue # 管理员登录 │ │ │ │ ├── DepartmentManagement.vue # 科室管理 │ │ │ │ ├── DoctorManagement.vue # 医生管理 │ │ │ │ ├── MedicineManagement.vue # 药品管理 │ │ │ │ ├── RegistrationManagement.vue # 挂号管理 │ │ │ │ ├── ScheduleManagement.vue # 排班管理 │ │ │ │ ├── Statistics.vue # 统计分析 │ │ │ │ └── UserManagement.vue # 用户管理 │ │ │ └── user/ # 患者端页面 │ │ │ ├── DepartmentList.vue # 科室列表 │ │ │ ├── DoctorDetail.vue # 医生详情 │ │ │ ├── MedicineList.vue # 药品列表 │ │ │ ├── MyRegistrations.vue # 我的挂号 │ │ │ ├── OnlineRegistration.vue # 在线挂号 │ │ │ ├── UserHome.vue # 首页 │ │ │ ├── UserLogin.vue # 用户登录 │ │ │ ├── UserProfile.vue # 个人中心 │ │ │ └── UserRegister.vue # 用户注册 │ │ ├── App.vue # 根组件 │ │ ├── env.d.ts # 类型声明 │ │ └── main.ts # 入口文件 │ ├── index.html │ ├── package.json │ ├── tsconfig.json │ ├── tsconfig.node.json │ └── vite.config.ts │ ├── sql/ │ └── init.sql # 数据库初始化脚本 │ └── README.md # 项目文档 ``` --- ## 快速开始 ### 环境要求 | 环境 | 版本要求 | |------|----------| | JDK | 21+ | | Node.js | 18+ | | MySQL | 8.0+ | | Maven | 3.9+ | ### 1. 克隆项目 ```bash git clone cd "Outpatient Appointment System" ``` ### 2. 初始化数据库 ```bash # 登录 MySQL mysql -u root -p # 执行初始化脚本 source sql/init.sql ``` > 脚本会自动创建 `clinic_db` 数据库及全部表结构,并插入默认管理员(admin/admin123)、科室、医生、药品、排班和测试用户数据。 ### 3. 启动后端服务 ```bash cd clinic-server # 编译打包 mvn clean package -DskipTests # 运行 mvn spring-boot:run # 或运行 jar java -jar target/clinic-server-1.0.0.jar ``` 后端服务默认运行在 `http://localhost:8080` ### 4. 启动前端应用 ```bash cd clinic-web # 安装依赖 npm install # 开发模式启动 npm run dev # 生产构建 npm run build ``` 前端应用默认运行在 `http://localhost:5173` ### 5. 访问系统 | 入口 | 地址 | 默认账号 | |------|------|----------| | 患者端 | http://localhost:5173 | zhangsan / 任意密码(测试用户) | | 管理后台 | http://localhost:5173/admin/login | admin / admin123 | | API 文档 | http://localhost:8080/doc.html | - | --- ## 数据库设计 ### 核心表结构 | 表名 | 说明 | 记录数(初始) | |------|------|---------------| | t_admin | 管理员表 | 1 | | t_user | 用户表(患者) | 2 | | t_department | 科室表 | 10 | | t_doctor | 医生表 | 12 | | t_medicine | 药品表 | 10 | | t_schedule | 排班表 | 30 | | t_registration | 挂号表 | 0 | | t_log | 系统日志表 | 0 | ### 索引设计规范 - 所有表均建立 `idx_status` 和 `idx_is_deleted` 索引 - 业务关联字段建立外键索引(如 `idx_dept_id`、`idx_doctor_id`) - 唯一业务编码建立唯一索引(如 `uk_username`、`uk_doctor_code`) - 搜索字段建立普通索引(如 `idx_real_name`、`idx_medicine_name`) ### ER 关系图 ``` ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ t_department│◄──────│ t_doctor │ │ t_user │ │ (科室) │ 1:N │ (医生) │ │ (用户) │ └─────────────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ │ ┌────┴────┐ ┌────┴────┐ │t_schedule│ │t_registration│ │ (排班) │ │ (挂号) │ └─────────┘ └─────────┘ ``` --- ## API 文档 系统集成 **Knife4j (OpenAPI 3)** 自动生成 API 文档。 启动后端服务后访问: ``` http://localhost:8080/doc.html ``` ### 接口规范 - **基础路径**: `/api` - **请求方式**: RESTful(GET / POST / PUT / DELETE) - **Content-Type**: `application/json` - **认证方式**: Header 携带 `Authorization: Bearer ` - **响应格式**: ```json { "code": 200, "message": "操作成功", "data": {} } ``` ### 主要接口分组 | 分组 | 路径前缀 | 说明 | |------|----------|------| | 用户接口 | `/api/user/**` | 注册、登录、资料管理 | | 管理员接口 | `/api/admin/**` | 管理员登录、Dashboard | | 科室接口 | `/api/department/**` | 科室 CRUD | | 医生接口 | `/api/doctor/**` | 医生 CRUD、分页查询 | | 药品接口 | `/api/medicine/**` | 药品 CRUD、分页查询 | | 排班接口 | `/api/schedule/**` | 排班管理 | | 挂号接口 | `/api/registration/**` | 挂号、取消、统计 | --- ## 部署方案 ### 开发环境 ```bash # 后端 mvn spring-boot:run # 前端 npm run dev ``` ### 生产环境 ```bash # 后端打包 mvn clean package -DskipTests nohup java -jar clinic-server/target/clinic-server-1.0.0.jar > server.log 2>&1 & # 前端打包 npm run build # 将 dist/ 目录部署到 Nginx ``` ### Nginx 配置示例 ```nginx server { listen 80; server_name clinic.example.com; location / { root /var/www/clinic-web/dist; try_files $uri $uri/ /index.html; } location /api { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ``` --- ## 开发规范 ### 后端规范 - 严格遵循阿里巴巴 Java 开发规范 - Controller 层只做参数校验和结果封装 - Service 层处理业务逻辑,禁止直接操作 SQL - Mapper 层负责数据访问,复杂查询使用 XML - DTO 用于接收请求参数,VO 用于返回视图数据 - 全局异常统一由 `GlobalExceptionHandler` 处理 - 密码必须使用 `BCryptPasswordEncoder` 加密 - 所有实体继承 `BaseEntity`,统一 ID 和时间戳管理 ### 前端规范 - 组件使用 Vue 3 Composition API + `