Python+Django宿舍维修管理系统开发实战

1. 项目背景与核心价值

宿舍维修管理系统是高校后勤管理中的重要一环，传统纸质报修流程存在效率低下、进度不透明、数据难以统计等问题。这个基于Python开发的系统正是为了解决这些痛点而生。我在实际开发中发现，一个设计良好的维修管理系统可以降低30%以上的沟通成本，同时提高维修响应速度。

系统采用B/S架构，前端使用HTML+CSS+JavaScript基础三件套，后端选择Python+Django框架组合。这种技术选型特别适合毕业设计场景：Django自带admin后台可以快速搭建原型，Python简洁的语法能让学生更专注于业务逻辑实现。数据库选用MySQL社区版，完全免费且性能足够支撑校园级应用。

2. 系统功能模块设计

2.1 用户权限管理模块

采用Django内置的auth模块实现三级权限控制：

• 学生：提交报修单、查看进度、评价服务
• 维修工：接收工单、更新状态、上传维修照片
• 管理员：分配工单、数据统计、人员管理

关键代码片段：

python复制# models.py
class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    ROLE_CHOICES = (
        ('student', '学生'),
        ('worker', '维修工'),
        ('admin', '管理员')
    )
    role = models.CharField(max_length=10, choices=ROLE_CHOICES)

2.2 维修工单流转模块

工单状态机设计是核心难点，我们采用有限状态机模式：

1. 待接单（学生提交后）
2. 已分配（管理员分配维修工）
3. 处理中（维修工开始作业）
4. 已完成（维修工确认完成）
5. 已评价（学生完成评价）

状态转换通过Django信号机制实现：

python复制# signals.py
@receiver(post_save, sender=RepairOrder)
def update_order_status(sender, instance, **kwargs):
    if instance.status == 'assigned' and not instance.worker:
        instance.status = 'pending'
        instance.save()

3. 数据库设计优化

3.1 核心表结构

维修工单表设计时特别注意了以下字段：

• 紧急程度（急/一般/可延缓）
• 故障类型（水电/家具/网络等）
• 位置信息（楼栋+房间号联合索引）
• 图片附件（使用Django FileField存储）

python复制class RepairOrder(models.Model):
    PRIORITY_CHOICES = (
        ('high', '紧急'),
        ('medium', '一般'),
        ('low', '可延缓')
    )
    student = models.ForeignKey(User, related_name='orders')
    worker = models.ForeignKey(User, null=True, related_name='assigned_orders')
    location = models.CharField(max_length=50)  # 格式：3号楼-502
    description = models.TextField()
    images = models.FileField(upload_to='repair_images/')
    status = models.CharField(max_length=20, default='pending')
    created_at = models.DateTimeField(auto_now_add=True)

3.2 查询性能优化

针对高频查询场景做了以下优化：

1. 为location字段添加复合索引
2. 使用select_related减少数据库查询次数
3. 对历史工单实现分页查询

python复制# 优化后的查询示例
orders = RepairOrder.objects.filter(
    location__startswith='3号楼'
).select_related('student', 'worker').order_by('-created_at')[:10]

4. 前端交互实现技巧

4.1 响应式布局方案

使用Bootstrap5实现三端适配：

• PC端：完整功能展示
• 平板：简化操作按钮
• 手机：重点突出提交/查看功能

关键CSS技巧：

css复制/* 移动端优先的媒体查询 */
@media (min-width: 768px) {
    .order-card {
        width: 48%;
        float: left;
        margin: 1%;
    }
}

4.2 AJAX无刷新交互

采用jQuery实现以下异步操作：

• 工单状态实时更新
• 评价提交无需跳转
• 图片预览功能

典型实现代码：

javascript复制$('#submit-repair').on('click', function(){
    $.ajax({
        url: '/api/repair/',
        method: 'POST',
        data: $('#repair-form').serialize(),
        success: function(response){
            $('#status-message').html('<div class="alert alert-success">提交成功！</div>');
        }
    });
});

5. 毕业设计避坑指南

5.1 开发环境配置

常见问题及解决方案：

1. Python版本冲突 → 使用virtualenv创建隔离环境
2. MySQL连接失败 → 检查3306端口和权限设置
3. 静态文件加载404 → 配置DEBUG=False时的收集命令

推荐工具组合：

• 开发工具：VS Code + Python插件
• 数据库管理：DBeaver社区版
• API测试：Postman

5.2 答辩演示技巧

三个必须演示的核心功能点：

1. 完整的工单流转过程（提交→分配→处理→评价）
2. 不同角色的权限控制演示
3. 数据统计报表生成

演示前务必准备：

• 测试账号（学生/维修工/管理员各一个）
• 预设几种典型故障场景
• 备用演示视频（防止现场网络问题）

6. 系统扩展方向

6.1 微信小程序接入

通过Django REST framework提供API：

python复制# serializers.py
class RepairOrderSerializer(serializers.ModelSerializer):
    class Meta:
        model = RepairOrder
        fields = '__all__'

# views.py
class RepairOrderViewSet(viewsets.ModelViewSet):
    queryset = RepairOrder.objects.all()
    serializer_class = RepairOrderSerializer

6.2 智能派单算法

基于维修工位置和专长的分配逻辑：

1. 获取维修工当前定位（高德地图API）
2. 计算与故障地点的距离
3. 匹配技能标签（水电/木工等）
4. 综合评分自动分配

实现示例：

python复制def assign_worker(order):
    workers = User.objects.filter(role='worker')
    ranked_workers = []
    for worker in workers:
        score = calculate_match_score(worker, order)
        ranked_workers.append((worker, score))
    best_worker = max(ranked_workers, key=lambda x: x[1])[0]
    order.worker = best_worker
    order.save()

7. 源码结构说明

标准Django项目结构优化建议：

code复制dorm_repair/
├── apps/
│   ├── account/      # 用户相关
│   ├── repair/       # 核心业务
│   └── stats/        # 数据统计
├── static/           # 静态文件
│   ├── css/
│   ├── js/
│   └── images/
├── templates/        # 前端模板
│   ├── base.html
│   └── repair/
└── utils/            # 工具函数
    ├── sms.py        # 短信通知
    └── report.py     # 报表生成

关键配置文件：

python复制# settings.py重要配置
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

# 生产环境必须设置
SECRET_KEY = os.environ.get('SECRET_KEY')
DEBUG = False
ALLOWED_HOSTS = ['yourdomain.com']

8. 部署上线实战

8.1 Linux生产环境部署

Ubuntu服务器推荐配置：

1. Nginx + uWSGI组合
2. 使用systemd管理服务
3. 配置自动化备份脚本

uWSGI配置示例：

ini复制[uwsgi]
chdir = /path/to/project
module = dorm_repair.wsgi:application
master = true
processes = 4
socket = /tmp/dorm_repair.sock
vacuum = true

8.2 性能监控方案

免费监控工具组合：

• Prometheus + Grafana监控系统指标
• Sentry收集错误日志
• Django-debug-toolbar开发时使用

关键监控指标：

1. 平均响应时间(<500ms)
2. 并发处理能力(>50req/s)
3. 数据库查询耗时(<100ms)

9. 毕业设计文档要点

技术文档必须包含的章节：

1. 需求分析（含用例图）
2. 系统设计（架构图+数据库ER图）
3. 核心功能实现（关键代码+流程图）
4. 测试方案（单元测试+界面截图）
5. 总结与展望

特别提醒：

• 所有图表必须添加编号和标题
• 代码片段要说明所在文件和功能
• 参考文献格式必须统一（建议GB/T 7714）

10. 常见问题解决方案

10.1 图片上传失败

排查步骤：

1. 检查MEDIA_ROOT权限
2. 确认表单enctype="multipart/form-data"
3. 测试文件大小限制（默认2.5MB）

python复制# 调整上传大小限制
DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 5  # 5MB

10.2 并发修改冲突

使用select_for_update解决：

python复制from django.db import transaction

@transaction.atomic
def assign_order(order_id, worker_id):
    order = RepairOrder.objects.select_for_update().get(pk=order_id)
    if order.status == 'pending':
        order.worker_id = worker_id
        order.status = 'assigned'
        order.save()

11. 项目心得与建议

在实际开发过程中，我总结了几个关键经验：

1. 不要过早优化，先确保核心流程跑通
2. 每天提交代码前运行基础测试用例
3. 使用Git分支管理不同功能开发
4. 文档和注释要随着开发同步更新

对于学弟学妹的建议：

• 提前规划好开发里程碑
• 遇到问题先查官方文档
• 合理使用ChatGPT等工具辅助调试
• 保留完整的开发过程记录（方便写论文）