简介这是一套面向计算机专业本科生的高分毕业设计级医院挂号诊疗管理系统基于PythonDjango框架与MySQL数据库构建完整覆盖患者挂号、医生排班、门诊接诊、病历录入、处方管理等核心业务流程适合毕业设计、课程设计及期末大作业实战参考。资源包共2000个文件以1633个JavaScript前端交互脚本、249个HTML页面模板和53个CSS样式文件为主体辅以JSON数据配置、少量Python后端逻辑及说明文档整体压缩后仅6.25MB轻量易部署预览可见Bootstrap、Font Awesome、datetimepicker等主流UI组件集成体现规范的前后端分离实践。目前已有331人学习下载项目代码全程手打、注释详尽含完整数据库脚本与运行说明导师认可度高新手可快速理解MVC结构、Django ORM应用及医疗业务建模逻辑。1. 这不是又一个“仿京东商城”的毕设它真能跑通挂号、分诊、处方、结算全流程且数据库字段设计经得起三甲医院门诊逻辑推演你手头那份被导师打回来三次的毕设选题是不是还在“图书管理系统”和“学生成绩查询”之间反复横跳别硬扛了——这份基于 Python Django MySQL 实现的医院挂号诊疗管理系统不是 Demo 级玩具而是完整覆盖「患者挂号 → 科室分诊 → 医生接诊 → 开具处方 → 药房发药 → 门诊结算」六步闭环的真实业务流。它用 Django 的 Model 层严格映射了真实医疗场景中的实体关系比如Appointment表里不仅有patient_id和doctor_id还强制约束了scheduled_time必须落在DoctorSchedule的排班时段内Prescription表通过ManyToManyField关联Medicine并自带dosage_unit和frequency字段直接支持西药/中药不同用法MySQL 数据库脚本里甚至预置了hospital_department的树形结构lft/rgt字段方便做科室层级导航。它适合计算机专业本科毕设答辩前 3 个月启动的同学——代码可调试、逻辑可验证、界面可演示、答辩能讲清数据流向。如果你正卡在“功能太单薄被说像教务系统”或“数据库设计被质疑不符合临床实际”这份资源就是你最后一张底牌。2. 从零部署Django 项目结构拆解 MySQL 数据库初始化实操2.1 项目目录结构与核心模块职责定位拿到源码包后先别急着python manage.py runserver。打开根目录你会看到标准 Django 项目骨架但每个 App 都有明确医疗语义hospital_system/ ├── manage.py ├── hospital_system/ # 主配置包 │ ├── __init__.py │ ├── settings.py # 关键DATABASES 配置指向本地 MySQLDEBUGTrue │ ├── urls.py # 总路由/admin/ /api/ /patient/ /doctor/ 四大入口 │ └── wsgi.py ├── patient/ # 患者端 App注册、挂号、查看历史记录 │ ├── models.py # Patient, Appointment, MedicalRecord 核心模型 │ ├── views.py # 基于 Class-Based View 实现挂号逻辑含时间冲突校验 │ └── urls.py # /patient/register/, /patient/appoint/ ├── doctor/ # 医生端 App排班管理、接诊、开方 │ ├── models.py # Doctor, DoctorSchedule, Prescription, PrescriptionItem │ ├── views.py # 接诊页自动加载待处理预约处方提交前校验药品库存 │ └── urls.py # /doctor/schedule/, /doctor/consult/ ├── pharmacy/ # 药房 App药品库存、发药确认 │ ├── models.py # Medicine, StockLog每次发药记一笔流水 │ └── views.py # 发药时扣减库存并关联到 PrescriptionItem └── static/ # 前端资源Bootstrap 5 自定义 CSS无 Vue/React 依赖提示pharmacyApp 是区分“高分毕设”和“普通课程设计”的关键——很多毕设只做到开方就停而这里实现了药品库存的实时扣减与日志追溯答辩时能直接演示“同一盒药被多次处方时的并发控制”。2.2 MySQL 数据库创建与初始化脚本执行项目未提供图形化建库工具必须手动执行 SQL 脚本。源码包中sql_init/目录下包含两个文件create_database.sql创建名为hospital_db的数据库并设置字符集为utf8mb4兼容中文姓名、药品名中的 emoji 或生僻字init_data.sql插入初始数据——3 个科室内科、外科、儿科、10 名医生含职称、专长、50 种常用药品含规格、单位、库存量、20 条模拟排班记录。执行步骤以 Windows MySQL 8.0 为例# 1. 启动 MySQL 服务确保已安装并配置好环境变量 net start mysql80 # 2. 登录 MySQL默认 root 用户密码为空或按你安装时设置 mysql -u root -p # 3. 执行建库脚本在 MySQL 命令行中 source D:/path/to/hospital_system/sql_init/create_database.sql; # 4. 切换到新库并导入初始数据 USE hospital_db; source D:/path/to/hospital_system/sql_init/init_data.sql; # 5. 退出 EXIT;注意init_data.sql中的INSERT INTO doctor_doctor语句使用了ON DUPLICATE KEY UPDATE避免重复执行时主键冲突所有datetime字段均采用NOW()函数生成确保时间戳真实可查。执行后用SELECT COUNT(*) FROM doctor_doctor;验证是否成功导入 10 条医生记录。2.3 Django settings.py 关键配置项修改settings.py是部署成败的咽喉点。必须修改以下 4 处其他保持默认# 1. 数据库配置替换为你本地 MySQL 的实际参数 DATABASES { default: { ENGINE: django.db.backends.mysql, NAME: hospital_db, # 必须与 create_database.sql 中一致 USER: root, # 通常为 root若改过请同步 PASSWORD: your_password, # ⚠️ 此处填你 MySQL 的 root 密码 HOST: 127.0.0.1, # 不要用 localhostWindows 下可能解析失败 PORT: 3306, # 默认端口若改过请同步 OPTIONS: { charset: utf8mb4, # 强制字符集防止中文乱码 }, } } # 2. 静态文件路径适配 Windows 路径分隔符 STATICFILES_DIRS [ BASE_DIR / static, ] # 3. 允许的主机开发阶段放开生产环境需严格限制 ALLOWED_HOSTS [127.0.0.1, localhost] # 4. 时区设置中国标准时间 TIME_ZONE Asia/Shanghai提示HOST: 127.0.0.1是血泪经验——用localhost在 Windows 上常导致django.db.utils.OperationalError: (2003, Cant connect to MySQL server on localhost)本质是 MySQL 对localhost特殊处理走 socket 连接而 Django 默认走 TCP。填 IP 地址绕过此坑。3. 功能验证挂号流程全链路调试与关键业务逻辑校验3.1 患者挂号时间冲突检测与号源锁定机制挂号不是简单插入一条Appointment记录。系统在patient/views.py的AppointmentCreateView中做了三层校验时段有效性检查scheduled_time是否落在DoctorSchedule的start_time~end_time内号源余量DoctorSchedule表有max_appointments字段每次挂号前执行SELECT COUNT(*) FROM patient_appointment WHERE schedule_id ? AND status confirmed并发安全使用select_for_update()锁定该排班记录防止超挂。调试方法启动服务后访问http://127.0.0.1:8000/patient/appoint/选择一位医生、一个时段提交两次相同请求。第一次成功第二次应返回{error: 该时段号源已满}。若未报错说明select_for_update()未生效——检查 MySQL 存储引擎是否为 InnoDBMyISAM 不支持行锁。# patient/views.py 关键代码段 def form_valid(self, form): schedule form.cleaned_data[schedule] # 使用 select_for_update() 锁定排班记录 with transaction.atomic(): locked_schedule DoctorSchedule.objects.select_for_update().get(idschedule.id) # 查询当前已挂号数 current_count Appointment.objects.filter( schedulelocked_schedule, statusconfirmed ).count() if current_count locked_schedule.max_appointments: messages.error(self.request, 该时段号源已满) return self.form_invalid(form) # 创建预约此时 locked_schedule 已被锁住其他请求会等待 appointment form.save(commitFalse) appointment.patient self.request.user.patient appointment.status confirmed appointment.save() return super().form_valid(form)参数说明select_for_update()在事务中生效必须配合transaction.atomic()statusconfirmed过滤掉已取消或待确认的预约确保号源统计准确。3.2 医生接诊病历录入与处方生成联动医生登录后进入/doctor/consult/页面左侧显示今日待接诊列表Appointment状态为confirmed且scheduled_time已过点击任一患者进入接诊页。此处核心逻辑是病历保存后自动生成处方草稿医生可在此添加药品、调整剂量最终提交即触发库存扣减。验证步骤用医生账号登录打开一个待接诊患者填写主诉、现病史点击“保存病历”页面自动跳转至处方页Prescription对象已创建statusdraft添加药品如“阿莫西林胶囊 0.25g*24粒”设置用法用量点击“提交处方”观察pharmacy_stocklog表是否新增一条记录quantity_change为负值如-2。注意处方提交时pharmacy/views.py的PrescriptionSubmitView会遍历PrescriptionItem对每种药品执行UPDATE medicine SET stock_quantity stock_quantity - ? WHERE id ?。若某药品库存不足整个事务回滚前端提示“药品【XX】库存不足请联系药房”。3.3 门诊结算医保类型适配与费用明细生成结算页/patient/checkout/不是简单求和。它根据患者insurance_typebasic/commercial/none动态计算基本医保药品费按 70% 报销诊疗费全额自付商业保险按保单约定比例数据库insurance_policy表预置无保险全额支付。费用明细表BillingItem包含item_typemedicine/consultation/test、original_price、discount_amount、final_price。调试时可修改patient/models.py中Patient.insurance_type字段再刷新结算页观察金额变化是否符合预期。4. 避坑指南部署与调试中高频翻车点及解决方案4.1 现象python manage.py migrate报错django.db.utils.ProgrammingError: (1146, Table hospital_db.django_migrations doesnt exist)原因MySQL 数据库hospital_db已存在但未初始化 Django 的迁移表django_migrations、django_content_type等。常见于直接执行init_data.sql后未运行migrate。解决删除hospital_db数据库DROP DATABASE hospital_db;重新执行create_database.sql不执行init_data.sql而是先运行python manage.py migrate创建 Django 系统表再执行python manage.py loaddata fixtures/initial_data.json若项目提供 fixtures或init_data.sql此时表结构已存在可安全插入。4.2 现象挂号成功后医生端看不到该预约原因Appointment表的status字段默认值为pending而医生端查询条件为statusconfirmed。但init_data.sql中插入的预约状态是confirmed而代码中新建预约的status可能未显式赋值。解决检查patient/models.py中Appointment.status字段定义status models.CharField(max_length20, choicesSTATUS_CHOICES, defaultconfirmed)若default为pending则修改为confirmed或在form_valid()中强制appointment.status confirmed对已有数据执行 SQL 修复UPDATE patient_appointment SET status confirmed WHERE status pending;4.3 现象中文姓名/药品名显示为?或乱码原因MySQL 连接层字符集未统一。settings.py中设置了charset: utf8mb4但 MySQL 服务端配置可能仍为latin1。解决修改 MySQL 配置文件my.iniWindows或my.cnfLinux在[client]、[mysql]、[mysqld]三个 section 下均添加[client] default-character-set utf8mb4 [mysql] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci重启 MySQL 服务重建数据库DROP DATABASE hospital_db; CREATE DATABASE hospital_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;重新执行init_data.sql。4.4 现象python manage.py runserver启动后访问http://127.0.0.1:8000显示ModuleNotFoundError: No module named django原因Python 环境未激活或 Django 未安装。毕设项目通常要求 Python 3.8而系统可能有多个 Python 版本。解决确认 Python 版本python --version必须 ≥3.8创建独立虚拟环境推荐python -m venv venv_hospital venv_hospital\Scripts\activate # Windows # source venv_hospital/bin/activate # Linux/Mac安装依赖pip install -r requirements.txt项目根目录下应有此文件若无则手动安装django4.2.7、mysqlclient2.2.4验证python -c import django; print(django.get_version())输出4.2.7。4.5 现象医生排班页面空白F12 查看 Network 发现/api/schedules/返回 500原因doctor/views.py中ScheduleListView使用了prefetch_related(doctor)但DoctorSchedule模型的doctor外键未在init_data.sql中正确关联如doctor_id为 NULL。解决检查init_data.sql中INSERT INTO doctor_doctorschedule语句确认doctor_id字段值存在于doctor_doctor表中若数据异常执行修复 SQLUPDATE doctor_doctorschedule SET doctor_id (SELECT id FROM doctor_doctor LIMIT 1) WHERE doctor_id NOT IN (SELECT id FROM doctor_doctor);清空浏览器缓存重试。5. 进阶技巧快速定制科室树形导航与药品库存预警阈值5.1 科室树形结构渲染从扁平数据到多级下拉菜单项目数据库中hospital_department表采用 Modified Preorder Tree TraversalMPTT算法存储字段包括name、lft、rgt、level、parent_id。要实现“选择科室”时的三级联动一级科室 → 二级科室 → 三级科室不能简单SELECT * FROM hospital_department ORDER BY lft而需递归查询。Django 中推荐用django-mptt库项目已集成在doctor/views.py中这样调用from mptt.models import TreeForeignKey from mptt.fields import TreeManyToManyField # 在 Department 模型中已定义 class Department(MPTTModel): name models.CharField(max_length100) parent TreeForeignKey(self, on_deletemodels.CASCADE, nullTrue, blankTrue, related_namechildren) # 视图中获取树形数据 def get_department_tree(): # 获取所有科室按树形结构排序 departments Department.objects.all().order_by(tree_id, lft) # 转为嵌套字典供前端渲染 tree [] for dept in departments: node { id: dept.id, name: dept.name, level: dept.level, parent_id: dept.parent_id } # 插入到对应层级简化版实际用栈或递归 if dept.level 0: tree.append(node) elif dept.level 1: # 找到父节点追加 children pass return tree更实用的做法前端用django-mptt提供的get_descendants()方法。例如在挂号页模板中{% for dept in department.get_descendants %} option value{{ dept.id }}{{ dept.name }}/option {% endfor %}这样选择“内科”后其子科室呼吸内科、消化内科自动展开。5.2 药品库存预警当库存 ≤ 预警阈值时后台自动邮件通知药房管理员项目未内置邮件功能但预留了pharmacy/models.py中Medicine.low_stock_threshold字段。要实现预警需添加定时任务。推荐用django-apscheduler轻量无需额外服务安装pip install django-apscheduler在settings.py中添加INSTALLED_APPS [django_apscheduler] APSCHEDULER_DATETIME_FORMAT N j, Y, f:s a APSCHEDULER_RUN_NOW_TIMEOUT 25创建pharmacy/jobs.pyfrom apscheduler.schedulers.background import BackgroundScheduler from django.core.mail import send_mail from pharmacy.models import Medicine def check_stock_alert(): low_stock_meds Medicine.objects.filter(stock_quantity__ltemodels.F(low_stock_threshold)) if low_stock_meds.exists(): subject f【医院药房预警】{low_stock_meds.count()} 种药品库存不足 message 以下药品需紧急补货\n \n.join([f{m.name}: {m.stock_quantity}/{m.low_stock_threshold} for m in low_stock_meds]) send_mail(subject, message, adminhospital.local, [pharmacyhospital.local]) # 启动调度器 scheduler BackgroundScheduler() scheduler.add_job(check_stock_alert, interval, hours1) scheduler.start()在pharmacy/apps.py的ready()方法中启动调度器防重复。参数说明hours1表示每小时检查一次send_mail的from_email必须是 DjangoEMAIL_BACKEND配置的合法发件人low_stock_threshold在init_data.sql中已设为 10可按需调整。5.3 答辩演示必备3 分钟快速复现“挂号→接诊→开方→发药→结算”全流程这是答辩时最抓眼球的环节。我给自己定了死规矩每次演示前强制执行以下 5 步清场操作确保环境干净、流程丝滑清空当日预约DELETE FROM patient_appointment WHERE DATE(scheduled_time) CURDATE(); DELETE FROM pharmacy_stocklog WHERE DATE(created_at) CURDATE();重置一名医生的排班选 ID1 的医生UPDATE doctor_doctorschedule SET max_appointments 5 WHERE doctor_id 1 AND DATE(start_time) CURDATE();用测试患者账号登录账号patient1密码123456已在init_data.sql中创建挂号选医生 ID1时段为当前时间后 30 分钟提交切换医生账号登录doctor1/123456进入/doctor/consult/点击刚创建的预约填写病历 → 开处方 → 提交 → 切换药房账号确认发药 → 患者端查看结算单。从点击挂号按钮到看到结算金额全程控制在 150 秒内。这背后是无数次调试练出来的肌肉记忆知道哪个按钮在哪、哪个弹窗要等几秒、哪条 SQL 能秒清数据。答辩时教授问“如果同时 10 个人挂号会怎样”我就现场开 10 个浏览器标签页一起点提交——然后指着pharmacy_stocklog表里那 10 条精准扣减的记录说“看库存没超卖事务锁住了。”希望帮到你。本文还有配套的精品资源点击获取