星点匠心建站 星点匠心建站XD JIANXIN STUDIO
400-883-9527 免费定制方案
ARTICLE DETAIL

资讯详情

深耕新锐建站与运营推广的一线实战洞察。

微信小程序医院预约挂号系统:Spring Boot+MySQL全流程设计与实现

微信小程序医院预约挂号系统:Spring Boot+MySQL全流程设计与实现 简介这份资源是面向计算机专业毕业设计场景的微信小程序医院预约挂号系统配套文档适合正在做 Java 方向毕设、需要参考完整项目方案与论文写作思路的学生。压缩包内共 1 个 docx 文件约 883KB内容围绕系统关键技术点展开涵盖项目背景与意义、微信小程序与 Java、Spring Boot、SSM、MySQL 的技术选型分析以及系统架构、用户管理、医生管理、预约管理、通知提醒等模块设计与数据安全、高并发、稳定性等难点的解决思路并附摘要与目录结构可作为论文撰写与项目实现的参考蓝本。目前已有 385 人学习适合需要快速理清选题逻辑、搭建技术框架与完善文档内容的读者借鉴。1. 从窗口排队到手机预约这套挂号小程序到底解决什么问题医院挂号窗口前的长队本质上是信息不对称造成的资源空转。患者不知道当天还有没有号、哪个医生出诊、排队要等多久只能先到现场再说挂号处的工作人员则被重复问询和手工录入拖住出错率居高不下。这套基于微信小程序的医院预约挂号系统要解决的就是把“号源信息”和“患者需求”在线上对齐——患者打开微信就能查科室、看医生、选时段、提交预约后台管理员统一维护医生排班与预约记录。它适合两类人直接参考一是正在做毕设或课设、需要一套完整前后端结构的学生二是要快速交付一个预约类业务原型、想拿现成模块改的开发者。技术栈上前端是微信小程序原生开发后端走 Java Spring Boot也兼容 SSM 分层思路数据库用 MySQL整体是典型的 B/S 三层结构改动成本低、答辩时也讲得清。2. 需求与角色拆解两类用户、六个核心用例怎么定2.1 先分清谁在用系统患者端与管理端的职责边界这套系统只有两类角色但职责必须切干净否则后面写接口会反复返工。患者端面向微信用户核心动作是“查”和“约”查看科室列表、查看某科室下的医生详情、选择医生提交预约、查看自己的预约记录、维护个人资料。管理端面向医院工作人员核心动作是“维护”和“审核”医生信息增删改、科室信息维护、预约记录查看与状态处理、公告发布、用户反馈处理。我一般会把权限设计成单管理员模式这是毕设场景下最稳妥的选择。原文里也明确写了“仅有一个管理员权限”管理员拥有系统最高权限负责医生管理、科室管理、病患管理、挂号管理和系统管理。不要一上来就设计多角色 RBAC那会把表结构和拦截器复杂度拉高一大截答辩时反而讲不清楚。单管理员的好处是登录鉴权只需要一张管理员表加一个会话标记小程序端用户走微信授权或简单注册登录即可两条线互不干扰。职责边界定清楚之后用例图就好画了。管理员用例包括登录、医生管理、科室管理、病患管理、挂号管理、系统管理患者用例包括浏览科室、查看医生、在线预约、查看预约、维护资料。这里有个容易被忽略的点预约的“审核”动作归管理员患者提交后状态是“待确认”管理员确认后才算预约成功。这个状态机是后面数据库设计和接口设计的骨架先定下来。2.2 功能需求落到模块前台展示与后台管理的功能清单把用例翻译成模块前台和后台各成一套。前台小程序端按页面划分首页/科室列表页、医生列表页、医生详情与预约页、我的预约页、个人中心页。后台管理端按菜单划分登录页、医生管理页、科室管理页、预约管理页、用户管理页、公告与反馈页。功能需求分析里原文提到前台还要支持“评价和错误内容上报”这个点很多同类项目会漏掉。我的做法是在医生详情页底部放一个评价入口在个人中心放一个意见反馈入口两者都落到同一张反馈表里管理员在后台统一查看。这样既满足了原文的功能描述又不会让表结构膨胀。数据需求方面核心表就四张管理员表、患者用户表、科室表、医生表外加一张预约表和一张反馈表。原文的数据需求分析里列了管理员表、挂号表、科室表、医生表我在此基础上补了反馈表因为功能需求里明确有评价与上报。表不在多在于字段能撑住业务流程。比如预约表里必须有患者 ID、医生 ID、预约时段、状态、创建时间状态字段用枚举值待确认/已确认/已取消/已完成这是后面所有查询和统计的基础。2.3 非功能需求界面适配、输入输出与可行性约束界面需求上小程序端屏幕小菜单必须收敛。原文说“将各个菜单简化并且能够完整的显示在一个屏幕内”落到设计上就是底部 TabBar 只放三个首页、预约、我的。科室和医生信息用左右分栏或列表卡片呈现避免多层跳转。后台管理端则相反菜单要展开、层级要清晰左侧导航加顶部面包屑管理员能快速定位到具体管理项。输入输出设计上患者在小程序端提交的预约信息经服务器写入 MySQL数据库做字段校验非空、格式、外键存在性写入成功后返回预约编号和状态。这里要注意跨端数据传递的完整性小程序请求走 HTTPS后端接口统一返回 JSON前端根据 code 字段判断成功与否不要用 HTTP 状态码硬扛业务错误。可行性分析在方案文里不是走过场。经济可行性上开发工具全部免费开源微信开发者工具、MySQL、Spring Boot 生态都不产生授权费用技术可行性上小程序原生框架加 Spring Boot 是成熟组合社区资料充足操作可行性上微信的操作习惯用户已经具备后台是标准 Web 表单操作学习成本低。这三点写进方案里答辩时被问到“为什么选这套技术”就有据可依。3. 总体架构与数据库设计三层结构如何落到表与接口3.1 三层架构与目录组织小程序端、服务端、数据层各管什么整体走 B/S 三层结构表现层是微信小程序和后台管理网页业务逻辑层是 Spring Boot 服务数据层是 MySQL。小程序端负责页面渲染和用户交互所有业务判断都发给服务端服务端按 Controller-Service-Mapper 分层Controller 收参数、做基础校验Service 写业务规则比如预约时段是否已被占、医生是否出诊Mapper 走 MyBatis 操作数据库MySQL 只负责存储和约束。目录组织上后端按模块分包controller、service、mapper、entity、config。小程序端按页面分包pages/department、pages/doctor、pages/appointment、pages/user。这样分包的好处是答辩演示时能快速定位代码也方便后续把某个模块单独抽出来复用。原文提到系统还用了 Tomcat 服务器这在 Spring Boot 内嵌容器场景下其实可以省略——Spring Boot 自带 Tomcat打成 jar 直接跑。如果课程要求必须外置 Tomcat那就把项目打成 war 包部署两种方式都行但方案里建议统一用内嵌方式减少环境配置的坑。3.2 核心数据表设计六张表撑起挂号全流程数据库设计是这套系统的地基。下面给出核心表结构字段类型按 MySQL 8.0 常用类型选取实际建表时按需调整长度。-- 管理员表单管理员模式密码加盐存储 CREATE TABLE admin ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(128) NOT NULL COMMENT 加密后的密码, salt VARCHAR(32) NOT NULL COMMENT 密码盐, real_name VARCHAR(50) COMMENT 真实姓名, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) COMMENT 管理员信息表; -- 患者用户表小程序端注册用户 CREATE TABLE patient ( id INT PRIMARY KEY AUTO_INCREMENT, open_id VARCHAR(64) UNIQUE COMMENT 微信openid用于免登录识别, nickname VARCHAR(50) COMMENT 昵称, phone VARCHAR(20) COMMENT 联系电话, gender TINYINT COMMENT 性别 0未知 1男 2女, id_card VARCHAR(32) COMMENT 身份证号, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) COMMENT 患者信息表; -- 科室表 CREATE TABLE dept ( id INT PRIMARY KEY AUTO_INCREMENT, dept_name VARCHAR(50) NOT NULL COMMENT 科室名称, dept_desc VARCHAR(255) COMMENT 科室简介, sort_no INT DEFAULT 0 COMMENT 排序号 ) COMMENT 科室信息表; -- 医生表关联科室含出诊信息 CREATE TABLE doctor ( id INT PRIMARY KEY AUTO_INCREMENT, dept_id INT NOT NULL COMMENT 所属科室, doctor_name VARCHAR(50) NOT NULL COMMENT 医生姓名, title VARCHAR(30) COMMENT 职称, specialty VARCHAR(255) COMMENT 擅长方向, intro TEXT COMMENT 医生简介, avatar VARCHAR(255) COMMENT 头像地址, status TINYINT DEFAULT 1 COMMENT 状态 1出诊 0停诊, FOREIGN KEY (dept_id) REFERENCES dept(id) ) COMMENT 医生信息表; -- 预约表核心业务表状态机驱动 CREATE TABLE appointment ( id INT PRIMARY KEY AUTO_INCREMENT, patient_id INT NOT NULL COMMENT 患者ID, doctor_id INT NOT NULL COMMENT 医生ID, appoint_date DATE NOT NULL COMMENT 预约日期, time_slot VARCHAR(20) NOT NULL COMMENT 时段如上午/下午, status TINYINT DEFAULT 0 COMMENT 0待确认 1已确认 2已取消 3已完成, remark VARCHAR(255) COMMENT 患者备注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (patient_id) REFERENCES patient(id), FOREIGN KEY (doctor_id) REFERENCES doctor(id) ) COMMENT 预约挂号表; -- 反馈表承接评价与错误上报 CREATE TABLE feedback ( id INT PRIMARY KEY AUTO_INCREMENT, patient_id INT COMMENT 提交人, content VARCHAR(500) NOT NULL COMMENT 反馈内容, type TINYINT DEFAULT 1 COMMENT 1评价 2问题上报, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) COMMENT 意见反馈表;建表时有几个参数值得说明。appointment表里status用 TINYINT 而不是字符串是为了查询和统计方便前端展示时再做映射appoint_date和time_slot拆成两个字段而不是存一个完整时间戳是因为挂号业务天然按“日期时段”组织拆开后查某天某时段余量只需一个联合条件。patient表留了open_id字段如果小程序走微信授权登录这个字段就是免登录识别的钥匙如果课程要求账号密码登录那就再加username和password字段两种方式不冲突。E-R 关系上科室与医生是一对多医生与预约是一对多患者与预约是一对多反馈与患者是多对一。画 E-R 图时把这三个一对多关系标清楚答辩时老师一看就知道你理解业务。3.3 接口约定与数据流一次预约请求怎么走完全程数据流要能讲成一条线。患者在小程序点“确认预约”前端收集doctorId、appointDate、timeSlot带上登录态请求后端/api/appointment/create。后端 Controller 先校验参数非空和日期格式Service 层做三件事查该医生该时段是否已有有效预约状态非取消、查该患者是否重复预约同一时段、写入预约记录并置状态为待确认。Mapper 执行 insert 后返回主键Service 包装成统一响应体返回前端。// 预约创建的核心业务逻辑Service 层示意 public Result createAppointment(AppointmentDTO dto, Integer patientId) { // 1. 校验医生是否存在且出诊 Doctor doctor doctorMapper.selectById(dto.getDoctorId()); if (doctor null || doctor.getStatus() 0) { return Result.fail(该医生当前不出诊); } // 2. 校验同一患者同一时段是否重复预约 int repeat appointmentMapper.countByPatientAndSlot( patientId, dto.getDoctorId(), dto.getAppointDate(), dto.getTimeSlot()); if (repeat 0) { return Result.fail(您已预约该时段请勿重复提交); } // 3. 写入预约记录初始状态待确认 Appointment app new Appointment(); app.setPatientId(patientId); app.setDoctorId(dto.getDoctorId()); app.setAppointDate(dto.getAppointDate()); app.setTimeSlot(dto.getTimeSlot()); app.setStatus(0); appointmentMapper.insert(app); return Result.ok(预约提交成功等待确认); }这段代码的关键不在写法而在校验顺序先查医生状态再查重复预约最后才写库。顺序反了会出现“先写进去再回滚”的浪费高并发下还容易产生脏数据。参数上patientId不从请求体取而是从登录态解析防止前端伪造他人身份提交预约——这是安全设计里最基础的一条答辩时能主动提出来是加分项。4. 关键模块实现从科室浏览到后台管理的落地细节4.1 科室与医生展示左右分栏与搜索的配合科室查看是小程序端的第一入口。原文描述的设计是“左侧科室名称右侧该科室下医生姓名、研究方向、等级”这是典型的左右分栏布局适合科室数量不多通常十几个的场景。实现上页面加载时先请求科室列表渲染左侧默认选中第一个科室并请求其医生列表渲染右侧点击左侧切换时重新请求右侧数据。// 科室页切换逻辑小程序端示意 Page({ data: { deptList: [], currentDeptId: null, doctorList: [] }, onLoad() { this.loadDepts(); }, loadDepts() { wx.request({ url: ${baseUrl}/api/dept/list, success: (res) { const list res.data.data || []; this.setData({ deptList: list }); if (list.length 0) { this.switchDept(list[0].id); // 默认加载第一个科室 } } }); }, switchDept(deptId) { this.setData({ currentDeptId: deptId }); wx.request({ url: ${baseUrl}/api/doctor/listByDept?deptId${deptId}, success: (res) { this.setData({ doctorList: res.data.data || [] }); } }); } });这里有个体验细节切换科室时右侧列表会闪一下空白通常的做法是加一个 loading 状态或者把已加载过的科室医生列表缓存在页面 data 里切回来直接读缓存。搜索栏则同时支持科室名和医生名模糊查询后端用LIKE拼接注意对入参做转义防止特殊字符导致 SQL 异常。4.2 预约挂号流程状态机与防重复提交预约流程是整套系统的核心。患者从医生详情页点“预约”进入预约页选择日期和时段提交后生成一条待确认记录。状态流转是待确认0→ 管理员确认 → 已确认1患者可取消 → 已取消2就诊完成后管理员置为已完成3。这个状态机要写进 Service 层任何状态变更都走统一方法不允许在 Controller 里直接改字段。防重复提交有两层前端在提交按钮上做防抖和置灰后端在 Service 里查重。只做前端防抖是不够的网络重试或用户多端操作都会绕过前端。后端查重条件用“患者医生日期时段状态非取消”命中就拒绝。另外预约日期要限制范围原文提到“可提前约 1 周内、1 个月内”实现时在接口层校验日期不得早于今天、不得晚于今天加 30 天超出范围直接返回错误提示。4.3 个人中心与预约记录数据聚合与状态映射个人中心页面承载五类入口我的预约、个人资料、诊断结果查看、联系客服、意见反馈。其中“我的预约”是数据聚合的重点后端按患者 ID 查预约表关联医生表和科室表返回医生姓名、科室名、预约日期、时段、状态。状态在数据库里是数字前端展示要映射成中文这个映射建议放在前端统一工具函数里而不是后端返回中文——后端返回码值更利于多端复用。// 预约状态映射前端工具函数 const STATUS_MAP { 0: { text: 待确认, color: #faad14 }, 1: { text: 已确认, color: #52c41a }, 2: { text: 已取消, color: #999999 }, 3: { text: 已完成, color: #1890ff } }; function formatStatus(status) { return STATUS_MAP[status] || { text: 未知, color: #999999 }; }个人资料维护走更新接口只允许改昵称、电话、性别等非关键字段身份证号这类敏感信息一旦提交不允许患者自行修改需要联系管理员处理。这是数据安全上的常见做法方案里写清楚能体现你考虑过边界。4.4 后台管理端医生信息维护与预约审核后台管理端是管理员的主战场。医生信息管理支持新增、编辑、停诊/复诊切换表单字段对应医生表的列科室用下拉选择数据来自科室表。预约管理页按状态筛选默认展示待确认列表管理员逐条确认或批量确认确认动作就是把状态从 0 改成 1同时记录操作时间。后台登录用账号密码加会话密码存储必须加盐哈希不能明文。原文提到“密码加密盐”这个设计要落到代码里注册或初始化管理员时生成随机盐密码存hash(password salt)登录时用同样方式计算比对。会话可以用简单的 token 方案登录成功返回 token后续请求在请求头带上后端拦截器校验。不要用前端存明文密码的方式做“记住密码”那是血泪教训里最常见的翻车点。5. 避坑与排查这套挂号系统最容易翻车的五个点5.1 预约超卖同一时段被多人抢到现象是管理员确认时发现同一医生同一时段出现多条有效预约患者到院后无法就诊。原因通常是查重和写入之间没有事务保护两个请求同时通过查重后都执行了插入。解决方式是在 Service 方法上加事务注解并把查重条件收紧到“状态非取消”同时在数据库层给appointment表加一个联合唯一索引医生日期时段状态为有效的组合用数据库约束兜底。索引设计要谨慎如果允许同一时段多人预约比如普通门诊就不能加唯一索引这时改用乐观锁或排队机制方案里要按业务类型区分。5.2 日期时区错乱预约日期差一天现象是患者选的是明天后台看到的是今天或后天。原因是小程序端传日期字符串、后端用Date接收时按服务器时区解析跨时区或格式化不当就会偏移。解决方式是前后端统一用yyyy-MM-dd字符串传输后端用LocalDate接收数据库字段用DATE类型全程不经过时间戳转换。这个坑在答辩演示时一旦出现非常尴尬建议在接口文档里把日期格式写死。5.3 登录态丢失小程序切后台再回来请求全失败现象是用户从预约页切到微信聊天再切回来点提交提示未登录。原因是 token 存在页面内存里页面重建后丢失。解决方式是把 token 存到wx.setStorageSync请求封装里统一从本地存储读取并塞进请求头同时后端对 token 设置合理有效期比如 7 天过期后引导重新授权。不要每次请求都重新登录那样体验很差。5.4 后台菜单权限形同虚设未登录也能调接口现象是直接拿接口地址在浏览器里请求不登录也能返回数据。原因是拦截器只拦了页面路由没拦 API。解决方式是在后端加统一拦截器除登录接口外所有/api/admin/**路径都校验 token校验失败返回 401。小程序端接口同理涉及个人数据的接口必须从 token 解析患者 ID不能信任前端传的 ID。5.5 数据库连接泄漏跑一段时间后接口全超时现象是系统刚启动正常演示到一半开始卡顿甚至报连接池耗尽。原因多是 Mapper 里手写连接未关闭或者事务方法里做了远程调用导致连接持有时间过长。解决方式是统一用框架管理的连接池Spring Boot 默认 HikariCP检查所有数据库操作是否走 Mapper事务方法里不要做 HTTP 请求或文件上传这类耗时操作。演示前用压测工具跑一轮并发预约观察连接池活跃数能提前暴露问题。6. 验收与答辩怎么证明这套挂号系统真的能用验收不是把页面点一遍就完事要按“功能覆盖 异常路径 数据一致性”三条线走。功能覆盖上对照需求清单逐项打勾患者端能注册登录、能按科室查医生、能提交预约、能看预约记录、能改个人资料、能提交反馈管理端能登录、能增删改医生、能维护科室、能确认和取消预约、能查看反馈。每项至少走一遍正常流程并截图存档。异常路径是答辩时最能体现深度的部分。我一般会准备五个必测场景未登录直接调预约接口应返回未授权、重复提交同一时段预约应被拒绝、预约超出 30 天范围应提示超期、管理员取消已完成的预约应限制状态流转、数据库断开后前端请求应给出友好提示而不是白屏。这五个场景对应前面避坑章节的问题测通了说明系统有基本的健壮性。数据一致性用一条 SQL 就能验证查预约表中状态为“已确认”但医生已停诊的记录正常应为零查同一患者同一时段存在多条有效预约的记录正常应为零。把这两条校验 SQL 写进验收文档比口头说“数据没问题”有说服力。验收项操作路径预期结果判定标准预约主流程选科室→选医生→选日期时段→提交生成待确认记录后台可见且状态正确重复预约拦截同一患者同时段再次提交提示已预约数据库无新增记录越权访问未带 token 调管理接口返回 401不泄露任何数据状态流转管理员确认→患者取消状态按序变更非法流转被拒绝日期边界提交今天之前或 30 天之后提示范围错误不写入数据库答辩陈述控制在八到十分钟结构按“痛点—方案—演示—验证”走。开场用一句话说清传统挂号的低效接着展示小程序端三个核心页面和管理端两个核心页面演示时故意走一次重复预约被拦截的路径最后用验收表格收尾。老师常问的三个问题提前准备好答案为什么选小程序而不是 App免安装、微信入口、开发成本低、预约并发怎么处理事务加查重加索引兜底、数据安全怎么保证密码加盐、接口鉴权、敏感字段不返前端。从那以后我每次带人做这类预约系统都强制先跑一遍“重复提交 越权访问 日期边界”这三条异常路径再谈页面好不好看。功能演示翻车多半不是主流程写错了而是边界没兜住。希望这套结构和验收方法能帮到你把方案里的模块按自己的业务替换骨架可以直接用。本文还有配套的精品资源点击获取
返回列表