锦中迎新管理系统

小李：最近学校要上线一个迎新管理系统，我负责前端部分，但对后端不太熟悉，你能帮我看看吗？

小王：当然可以。你先说说这个系统的功能需求是什么？

小李：我们学校今年要推行数字化迎新，所以需要一个能处理新生信息录入、宿舍分配、缴费管理等功能的系统。

小王：那这个系统应该包括哪些模块呢？

小李：主要有：新生信息录入、学籍审核、宿舍分配、缴费管理、通知公告、数据统计等。

小王：听起来功能挺全面的。那你们用什么语言来开发呢？

小李：后端用的是Python，框架是Django，数据库用的是MySQL，前端用的是Vue.js。

小王：很好，Django确实适合做这种管理系统。那我们可以从功能清单入手，逐步讲解。

小李：好的，那我们就先从新生信息录入模块开始吧。

小王：这个模块的主要功能是让新生填写基本信息，比如姓名、身份证号、联系方式、专业等。然后系统会进行初步验证，比如身份证号格式是否正确，手机号是否有效。

小李：对，这部分我用Vue做了表单页面，现在想写后端的接口。

小王：那我可以给你一个简单的Django模型和视图代码示例。

小李：太好了！请给我看看。

小王：这是新生信息的模型定义：

from django.db import models

class NewStudent(models.Model):
    name = models.CharField(max_length=100)
    id_number = models.CharField(max_length=20, unique=True)
    phone = models.CharField(max_length=20)
    major = models.CharField(max_length=100)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name
    

小李：明白了，那对应的视图呢？

小王：这里是一个简单的POST接口，接收新生信息并保存到数据库中：

from django.http import JsonResponse
from .models import NewStudent
import json

def add_new_student(request):
    if request.method == 'POST':
        data = json.loads(request.body)
        name = data.get('name')
        id_number = data.get('id_number')
        phone = data.get('phone')
        major = data.get('major')

        # 简单的字段校验
        if not all([name, id_number, phone, major]):
            return JsonResponse({'status': 'error', 'message': '缺少必要字段'})

        # 检查身份证号是否唯一
        if NewStudent.objects.filter(id_number=id_number).exists():
            return JsonResponse({'status': 'error', 'message': '身份证号已存在'})

        student = NewStudent(name=name, id_number=id_number, phone=phone, major=major)
        student.save()
        return JsonResponse({'status': 'success', 'message': '信息添加成功'})
    return JsonResponse({'status': 'error', 'message': '请求方法错误'})
    

小李：这个接口看起来没问题。那接下来是学籍审核模块，这个怎么实现呢？

小王：学籍审核主要是管理员查看新生信息，并决定是否通过审核。你可以设计一个审核状态字段，比如“待审核”、“已通过”、“未通过”。

小李：对，那我可以在模型里加一个status字段。

小王：没错，以下是更新后的模型代码：

class NewStudent(models.Model):
    name = models.CharField(max_length=100)
    id_number = models.CharField(max_length=20, unique=True)
    phone = models.CharField(max_length=20)
    major = models.CharField(max_length=100)
    status = models.CharField(max_length=20, default='待审核')
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name
    

小李：这样就可以记录审核状态了。那对应的视图是不是也要改一下？

小王：是的，比如增加一个审核接口，供管理员使用：

def update_student_status(request, student_id):
    if request.method == 'POST':
        data = json.loads(request.body)
        status = data.get('status')
        try:
            student = NewStudent.objects.get(id=student_id)
            student.status = status
            student.save()
            return JsonResponse({'status': 'success', 'message': '状态更新成功'})
        except NewStudent.DoesNotExist:
            return JsonResponse({'status': 'error', 'message': '学生不存在'})
    return JsonResponse({'status': 'error', 'message': '请求方法错误'})
    

小李：明白了，这样管理员就可以在后台修改学生的审核状态了。

小王：接下来是宿舍分配模块，这个可能需要更复杂的逻辑。

小李：是的，宿舍分配要考虑专业、性别、人数等因素。

小王：我们可以设计一个宿舍模型，包含宿舍编号、床位数、已分配人数等信息，然后根据新生信息进行自动匹配。

小李：那我该怎么实现自动分配呢？

小王：可以写一个函数，根据专业和性别筛选可用宿舍，然后按顺序分配床位。以下是一个简单的示例：

class Dormitory(models.Model):
    dorm_number = models.CharField(max_length=10, unique=True)
    capacity = models.IntegerField(default=4)
    occupied = models.IntegerField(default=0)

    def __str__(self):
        return self.dorm_number

def assign_dormitory(student):
    # 根据专业和性别筛选宿舍
    dorms = Dormitory.objects.filter(capacity__gt=models.F('occupied'))

    for dorm in dorms:
        if dorm.occupied < dorm.capacity:
            dorm.occupied += 1
            dorm.save()
            return dorm.dorm_number
    return None
    

小李：这样就能根据宿舍容量自动分配了，不错。

小王：接下来是缴费管理模块，这个通常涉及支付接口。

小李：是的，我们计划接入微信支付或支付宝。

小王：那你可以用Django的中间件或者第三方库来集成支付接口。不过这部分可能比较复杂，建议参考官方文档。

小李：明白了，那我先完成其他模块。

小王：最后是通知公告模块，这个比较简单，主要是发布通知给新生。

小李：对，可以用Django的admin界面直接发布内容。

小王：另外，数据统计模块也是重要的，比如统计各专业的新生数量、缴费情况等。

小李：是的，我们可以用Django的聚合查询来实现。

小王：总之，这个系统的核心在于功能清单的实现和数据的高效管理。

小李：谢谢你，我现在对整个系统有了更清晰的认识。

小王：不客气，如果还有问题随时问我。