高校实验室报修系统：Django+Flask混合架构实践

1. 项目概述高校实验室报修系统的技术选型与实践实验室设备报修管理一直是高校后勤服务的痛点。传统纸质登记或简单Excel表格的方式存在响应慢、流程不透明、数据难追溯等问题。这套基于Python技术栈的小程序报修系统采用DjangoFlask双框架架构实现了从报修申请到处理完成的全流程数字化管理。我在实际开发中发现这种混合框架方案既能发挥Django在后台管理上的优势如自带Admin、完善ORM又能利用Flask的轻量灵活特性处理小程序API请求。系统上线后某高校计算机实验室的报修平均响应时间从72小时缩短至4小时管理员工作效率提升300%。2. 核心需求分析与技术方案2.1 高校实验室的特殊需求场景计算机类实验室的设备故障具有明显特征高频故障类型集中约60%为键盘/鼠标损坏30%为软件环境问题紧急程度差异大教学用主机故障需2小时内响应备用设备可24小时处理多方协作需求涉及学生报修、实验员处理、供应商维修等多个角色2.2 技术栈选型对比需求维度Django方案Flask方案本系统混合方案后台管理自带Admin后台需扩展Flask-Admin使用Django AdminAPI开发DRF稍显笨重路由定义灵活Flask处理小程序API数据库操作完善ORMSQLAlchemy需要更多配置Django ORM为主部署复杂度较高较低需协调两个应用经验提示选择混合架构时建议将Django用于后台管理子系统Flask专注小程序API服务通过Nginx进行路由分发。3. 系统架构设计与实现细节3.1 前后端分离架构设计小程序端(微信) → API网关(Flask) ↗ ↘ 管理后台(Django Admin) ↓ 共用数据库(MySQL)3.2 关键数据模型设计设备表(Equipment)核心字段class Equipment(models.Model): LAB_TYPES ( (A, 人工智能实验室), (B, 网络工程实验室) ) name models.CharField(max_length100) lab_type models.CharField(max_length1, choicesLAB_TYPES) qr_code models.ImageField(upload_toqrcodes/) purchase_date models.DateField() warranty_period models.IntegerField() # 月为单位报修工单表(RepairOrder)状态机设计STATUS_CHOICES ( (submitted, 已提交), (assigned, 已分配), (processing, 处理中), (waiting_parts, 待配件), (completed, 已完成), (cancelled, 已取消) ) class RepairOrder(models.Model): equipment models.ForeignKey(Equipment) reporter models.ForeignKey(User) fault_type models.CharField(max_length50) # 预定义故障类型 urgency models.IntegerField(choices[(1,紧急),(2,普通)]) status models.CharField(max_length20, choicesSTATUS_CHOICES) assigned_to models.ForeignKey(User, related_nameassigned_orders)3.3 小程序端关键技术实现微信登录集成方案# Flask端登录API示例 app.route(/api/wx_login, methods[POST]) def wx_login(): code request.json.get(code) # 调用微信接口获取openid wx_url fhttps://api.weixin.qq.com/sns/jscode2session?appid{APPID}secret{SECRET}js_code{code}grant_typeauthorization_code resp requests.get(wx_url) openid resp.json().get(openid) # 查找或创建用户 user User.query.filter_by(wx_openidopenid).first() if not user: user User(wx_openidopenid) db.session.add(user) # 生成JWT token token create_access_token(identityuser.id) return jsonify(tokentoken)扫码报修功能实现要点为每台设备生成唯一QR码含设备ID信息小程序扫码后自动填充设备基本信息故障类型采用级联选择器// 小程序端示例 Page({ data: { faultTypes: [ {name: 硬件故障, subItems: [键盘失灵, 鼠标损坏]}, {name: 软件故障, subItems: [系统崩溃, 软件无法启动]} ] } })4. 后台管理模块深度优化4.1 Django Admin定制技巧列表页优化class RepairOrderAdmin(admin.ModelAdmin): list_display (id, equipment_name, fault_type, status_badge) list_filter (lab_type, status) actions [export_to_excel] def status_badge(self, obj): colors { submitted: gray, processing: orange, completed: green } return format_html( span stylecolor:{}{}/span, colors.get(obj.status, black), obj.get_status_display() )工单处理看板# admin.py中添加自定义视图 admin.site.register_view(repair_dashboard) def repair_dashboard(request): weekly_stats RepairOrder.objects.filter( create_time__gtetimezone.now()-timedelta(days7) ).values(status).annotate(countCount(id)) return render(request, admin/repair_dashboard.html, { stats: list(weekly_stats) })4.2 自动化处理流程配件库存预警# signals.py 配置信号处理器 receiver(post_save, senderRepairOrder) def check_inventory(sender, instance, **kwargs): if instance.status waiting_parts: part get_related_part(instance.fault_type) if part.stock 2: # 库存阈值 send_email_alert( recipients[purchaserschool.edu], subjectf配件库存预警{part.name}, messagef当前库存仅剩{part.stock}件 )5. 部署与性能优化实战5.1 混合架构部署方案Nginx配置关键点server { listen 80; location /admin/ { proxy_pass http://django_server; proxy_set_header Host $host; } location /api/ { proxy_pass http://flask_server; proxy_set_header Host $host; } location /static/ { alias /path/to/static_files; } }5.2 高频访问接口优化工单状态查询缓存# 使用Flask-Caching扩展 cache Cache(config{CACHE_TYPE: Redis}) app.route(/api/order_status/int:order_id) cache.cached(timeout300, query_stringTrue) def get_order_status(order_id): order RepairOrder.query.get_or_404(order_id) return jsonify(statusorder.status)数据库查询优化技巧# 错误做法N1查询问题 orders RepairOrder.objects.all() for o in orders: print(o.equipment.name) # 每次循环都查询数据库 # 正确做法使用select_related orders RepairOrder.objects.select_related(equipment).all()6. 典型问题排查实录6.1 微信登录失败排查常见错误场景小程序AppID与后台配置不一致服务器时间未同步微信接口要求时间误差5分钟code重复使用或已过期有效期5分钟解决方案# 在Flask中添加时间校验 def verify_wx_code(code): now int(time.time()) if abs(now - int(code[:10])) 300: raise ValueError(Code expired)6.2 文件上传大小限制Django默认限制为2.5MB需调整# settings.py 配置 DATA_UPLOAD_MAX_MEMORY_SIZE 10 * 1024 * 1024 # 10MB FILE_UPLOAD_MAX_MEMORY_SIZE 20 * 1024 * 1024 # 20MBFlask端配置app.config[MAX_CONTENT_LENGTH] 20 * 1024 * 1024 # 20MB7. 扩展功能与二次开发建议7.1 智能派单算法基于维修人员技能标签的自动分配def auto_assign_order(order): qualified_technicians User.objects.filter( skills__containsorder.fault_type, current_orders__lt3 # 每人最多同时处理3单 ).order_by(workload) if qualified_technicians: order.assigned_to qualified_technicians[0] order.status assigned order.save() return True return False7.2 数据可视化分析使用ECharts展示维修数据// 小程序端示例 wx.request({ url: /api/repair_stats, success(res) { this.setData({ stats: res.data, options: { xAxis: { data: [键盘, 鼠标, 显示器] }, series: [{ data: [45, 30, 12] }] } }) } })这套系统在实际运行中我特别建议添加设备生命周期管理模块通过采集维修历史数据可以预测设备故障周期提前安排维护或更换。例如当某批键盘的平均无故障时间(MTBF)低于2000小时时系统会自动触发采购申请流程。