Django框架开发学生管理系统

Django框架开发学生管理系统

学生管理系统是针对学校的大量业务处理工作而开发的管理软件，主要用于学生信息和学生分数的管理。总体任务，是实现学生信息管理关系的科学化、系统化、规范化和自动化，方便教务人员使用计算机对学生各种信息进行日常管理，如查询、修改、增加、删除等，此外还涉及学生自主查询成绩等功能。

13.1需求分析

学生管理系统包含3个角色，分别是后台管理员、老师和学生。所以该系统应该具备以下功能：

1.后台管理员拥有本系统的最高权限，可以创建分组、设定权限、管理老师信息等。

2.老师具备登陆后台功能，并且可以修改原始密码。

3.老师具备管理学生功能，可以对学生信息进行增删改查。

4.老师具备管理成绩功能，可以对学生成绩进行增删改查。

5.老师具备批量上传功能，可以批量上传学生信息，批量上传成绩信息等。

5.学生具备查看成绩功能，可以查看所有参加考试的成绩。

13.2系统功能是设计

13.2.1系统功能结构

13.2.2系统业务流程

13.2.3系统预览

系统分为前台后台。前台主要用于学生帐户查询成绩，后台系统主要用于老师账户上传学生信息和成绩信息，以及管理员账户添加老师信息和设置权限组。

在前台登录页面，学生账户通过学号和密码等登录成功后，进入前台首页，首页主要展示该学生的所有成绩信息。单机某门课程考试选项，即可查看该门课程成绩信息。

在后台登陆页面，老师账户通过邮箱密码登陆后，即可进入老师管理页面。

在后台登陆页面，管理员团账户通过邮箱密码登陆成功后即可进入管理员管理页面。

13.3系统开发必备

13.3.1系统开发环境

本系统的软件开发及运行环境如下：

操作系统：Windows7及以上、linux

数据库和驱动;MySQL+PyMySQL

开发IDE：pycharm

开发框架:Django3 + Bootstrap + jQuery

浏览器：Chrome浏览器

13.3.2文件夹组织结构

本项目使用的主要命令

python manager.py makemigrations  # 生成数据库迁移脚本
python manager.py migrate  # 根据makemigrations命令生成的脚本，创建或修改数据库表结构
python manager.py migrate migrate_name  # 回滚到指定迁移版本
python manager.py collectstaic  # 生成静态资源目录，根据settings.py中的STATIC_ROOT设置
python manager.py shell  # 打开django解释器，引入项目包
python manager.py dbshell  # 打开django数据库连接，执行原生SQL命令
python manager.py startproject  # 创建一个Django项目
python manager.py startapp # 常见一个app
python manager.py createsuperuser  # 创建一个管理器超级用户，使用django.contrib.auth认证
python manager.py runserver  # 创建开发服务器

13.4数据库设计

13.4.1数据库概要说明

本系统使用Mysql数据库来存储数据，数据库名为student_system，共包含14张数据表，其中auth和django为前缀的表哦都是django框架自动创建的表，其余为用户需要创建的数据表。

studen_system数据库中的数据表对应的中文表名及主要作用：

13.4.2数据表模型

django框架自带的ORM可以满足绝大多数数据库开发的需求，在没有达到一定的数量级时，完全不需要担心ORM为项目带来的瓶颈。下面是学生管理系统使用ORM管理一个学生模块的数据模型：关键代码

class Student(CreateUpdateMixin):
    student_num = models.CharField(max_length=10, unique=True, verbose_name='学号')
    name = models.CharField(max_length=20, help_text='name/姓名', verbose_name='姓名')
    gender = models.CharField(max_length=32, choices=(('male', '男'),
                                                      ('female', '女')), default='男', help_text='gender/性别',
                              verbose_name='性别')
    phone = models.CharField(max_length=11, help_text="phone/联系电话", verbose_name='联系电话')
    birthday = models.DateField(verbose_name="出生日期")
    # user表一对一关联
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    # teacher表以对多关联
    teacher = models.ForeignKey(Teacher, on_delete=models.CASCADE)  # 设置外键

    def __str__(self):
        return self.name

    def teacher_name(self):
        """
        获取老师名称
        """
        self.verbose_name = '老师名称'
        return self.teacher.name

    teacher_name.short_description = '老师名称'

    def class_name(self):
        """
        获取班级名称
        """
        return self.teacher.class_name

    class_name.short_description = '班级名称'

    class Meta:
        db_table = "student"
        verbose_name_plural = "学生信息"
        verbose_name = "学生信息"

在上述代码中，使用model.OneToOneField实现student表和auth_user表的一对一管，使用models.ForeignKey实现student和teacher的一对多关联。此外，数据表也存在其他表之间的关系：

13.5公共模块设计

13.5.1修改目录结构

使用django命令创建项目时，会生成一个与项目同名的全局配置文件目录

将manage.py修改如下：

#!/usr/bin/env python
"""Django's command-line utility for administrative tasks."""
import os
import sys


def main():
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)


if __name__ == '__main__':
    main()

创建config包，将asgi，settings，urls，wsgi文件移入该包，并修改settings

ROOT_URLCONF = "config.urls"

......

WSGI_APPLICATION = 'config.wsgi.application'

13.5.2配置settings

config/settings.py文件是项目的配置文件，需要进行以下配置。

（1）创建应用：

diango-admin startapp 应用名称

本项目主要创建四个应用：teacher、student、score、uploadfile。创建完成后，将名称写入settings文件的INSTALLED_APPS中。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'teacher',
    'student',
    'score',
    'uploadfile'
]

（2）配置时区：

# LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'zh-Hans'

# TIME_ZONE = 'UTC'
TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True

USE_TZ = True

（3）配置mysql数据库：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'student_system',
        'USER': 'root',
        'PASSWORD': '********'
    }
}

（4）自定义配置：

# 文件上传路径
MEDIA_ROOT = os.path.join(BASE_DIR, 'uploads')

# 设置初始密码
TEACHRE_INIT_PASSWORD = 't123456' # 老师账号的初始密码
STUDENT_INIT_PASSWORD = '123456'  # 学生账号的初始密码

# 没有登录时跳转的URL
LOGIN_URL = '/login/'

# 兼容Bootstrap Alert 样式
from django.contrib.messages import constants as message_constants
MESSAGE_TAGS = {message_constants.DEBUG: 'debug',
                message_constants.INFO: 'info',
                message_constants.SUCCESS: 'success',
                message_constants.WARNING: 'warning',
                message_constants.ERROR: 'danger',}

13.6学生模块设计

13.6.1学生登录功能实现

学号是一个学生在学校的唯一标识，所以在前台登录页面，需要学生填写学号及密码进行登录。对于学生填写的学号和密码信息要分别进行验证。例如：学好是否为空、长度范围是否满足、学好是否存在、学号密码是否匹配。

实现学生登录功能的步骤如下。

（1）创建登陆表单。

为了更加方便地验证表单，可以继承form.Form类来验证表单，在stuent目录下创建forms.py文件，创建StudentLoginForm类，并对学号和密码设置验证规则。

from django import forms
from django.contrib.auth.models import User


class StudentLoginForm(forms.Form):
    student_num = forms.CharField(
        lable='学号',
        required=True,
        max_length=11,
        widget=forms.TextInput(attrs={
            'class': "form-control mb-0",
            'placeholder': '请输入学号'
        }),
        error_messages={
            'required': "学号不能为空",
            "max_length": '长度不能超过50个字符',
        }
    )
    password = forms.CharField(
        label='密码',
        required=True,
        min_length=6,
        max_length=50,
        widget=forms.TextInput(attrs={
            'class': "form-control mb-0",
            'placeholder': '请输入密码'
        }),
        error_messages={
            'required': "学号不能为空",
            "max_length": '长度不能超过50个字符',
            "min_length": '长度不能少于6个字符',
        }
    )
    # 二次验证函数的名字是固定写法，以clean_开头，后面跟上字段的变量
    def clean_student_num(self):
        # 通过了validators的验证后，在进行二次验证
        student_num = self.cleaned_data['student_num']
        try:
            User.objects.get(username=student_num)  # 使用student_num获取django用户
        except User.DoesNotExist:
            raise forms.ValidationError("学号不存在", 'invalid')
        else:
            return student_num

上述代码中，定义了一个以"clean_" + 属性名的方法clean_student_mum(),它是Django Form中的特殊方法，用于对该属性进行验证。clean_student_mum()方法就是用于都student_num属性进行验证，

如果不存在，就会抛出异常

（2）创建模板文件

在templates文件夹中创建login.html模板文件，关键代码如下:

{% extends "base.html" %}
{% block title %}登录页面{% endblock %}
{% block content %}
<div class="main-content container">
    <div class="inner-content">
        <div class="xxdj-report border zycs_text">
            <div class="course-report">
                <h1>学生登录h1>
                <div class="wid775 div-course">
                {% if messages %}
                  {% for message in messages %}
                    <div class="alert alert-{{ message.tags }} alert-dismissible fade show" role="alert">
                      <strong>{{ message }}strong>
                      <button type="button" class="close" data-dismiss="alert" aria-label="Close">
                        <span aria-hidden="true">×span>
                      button>
                    div>
                  {% endfor %}
                {% endif %}
                <form class="mt-4" action="" method="post">
                    {% csrf_token %}
                    <div class="form-group">
                        <label>{{form.student_num.label}}label>
                        {{form.student_num}}
                        {{form.student_num.errors}}
                    div>
                    <div class="form-group">
                        <label>{{form.password.label}}label>
                        {{form.password}}
                        {{form.password.errors}}
                    div>
                    <div class="d-inline-block w-100">
                        <button type="submit" class="btn btn-primary float-right">登录button>
                    div>
                form>
                div>
            div>
        div>
    div>
div>
{% endblock %}

在上述代码中，使用extends继承父模板，然后替换掉block中内容。在html页面中,{{form.student_num}}是页面的学好元素，{{form.student_num.errors}}是页面中检测学号的错误信息。

（3）创建视图

在student/views.py中创建一个基于类的视图StudentLoginView()，并创建get（）和post（）请求，用于显示登陆页面和提交登陆表单，关键代码如下：

class StudentLoginView(View):
    """
    学生登录页表单
    """

    def get(self, request):
        """
        显示登录页面
        """
        return render(request, 'login.html', {'form': StudentLoginForm()})  # 渲染模板

    def post(self, request):
        """
        提交登录页面表单
        """
        form = StudentLoginForm(request.POST)  # 接收Form表单
        # 验证表单
        if form.is_valid():
            student_num = request.POST['student_num']  # 获取学号
            password = request.POST['password']  # 获取密码
            user = authenticate(request, username=student_num, password=password)  # 授权校验
            if user is not None:  # 校验成功，获得返回用户信息
                login(request, user)  # 登录用户，设置登录session
                request.session['uid'] = user.id  # 设置用户名的session
                request.session['username'] = user.student.name  # 设置用户名的session
                request.session['student_num'] = user.student.student_num  # 设置用户名的session
                return HttpResponseRedirect('/')
            else:
                messages.add_message(request, messages.ERROR, '用户名和密码不匹配')  # 提示错误信息
        return render(request, 'login.html', {'form': form})  # 渲染模板

上述代码，get()方法比较简单，主要用于渲染登陆页面。在post()方法中，首先使用表单类接受表单数据，然后调用is_valid()函数来验证用户提交的表单数据是否满足StudentLoginForm类中设置的验证规则。如果不能满足验证规则，则在登陆页面中输出设置的错误信息。如果满足验证规则，则使用authenticate()函数判断学号和密码是否匹配。如果不匹配没提示错误信息；如果匹配，则将图画信息保存到session中。

在浏览器输入127.0.0.1:8000/login进入登录页面

13.6.2推出登录功能实现

登陆成功后，网站顶部导航栏会显示该学生的姓名。滑动鼠标到姓名位置，将显示注销和修改密码菜单，单击注销即可退出登录。使用django内置的logout()函数可以快速实现退出功能，成功后，页面跳转到accounts/login在settings.py文件中可以通过设置LOGIN_URL参数更改跳转路径：

LOGIN_URL = "/login/"

在student/views.py文件中，定义logout()函数来实现用户退出功能，关键代码如下

from django.contrib.auth import authenticate, login,logout as django_logout
def logout(request):
    """
    退出登录
    :param request:
    :return:
    """
    django_logout(request)  # 清楚response的cookie和django_session中的记录
    return HttpResponseRedirect("/login")

在上述代码中，由于视图函数logout()与模块下的logout重名，所以引入时设置别名，当调用django_logout()函数时，会清楚response对象cookie和django_session中的记录，从而实现退出登陆的功能。

13.6.3查询成绩功能的实现

学生登录成功后，页面将跳转至成绩列表页。该页面需要学生登录后才能访问。此时可以使用django提供的装饰器函数login_required()来判断是否登陆成功。如果学生已经登陆，此函数返回True，否则返回False。通常情况下，需要在settings.py文件中设置LOGIN_URL参数，代码如下:

LOGIN_URL = "/login/"

成绩列表页会展示该学生所有考试成绩列表信息，包括考试名称。成绩上传时间、所在班级以及老师名。由于student表和score表是一对多的管理，所以可以通过学生信息直接获取该学生的所有成绩信息，然后再模板中遍历每一个成绩信息即可。

在student/views.py中创建index()函数，关键代码如下:

@login_required
def index(request):
    """
    首页
    :param request:
    :return:
    """
    student_num = request.session.get("student_num", )  # 获取当前学生学号
    student = Student.objects.get(student_num=student_num)  # 根据学号查询学生信息
    scores = student.score_set.all()  # 获取该学生的所有分数
    return render(request, 'index.html', {'scores': scores})

在templates下创建index.html文件

{% if not scores %}
    <div style="text-align:center">
        暂无成绩信息！
    </div>
{% else %}
    {% for  score in scores %}
    <li style="border: 1px solid #ccc;border-radius: 10px;margin:10px;">
        <a href="{% url 'score' score_id=score.id %}">
            <span class="start_time"><b>{{ score.created_at|date:"Y-m" }}</b><i>{{ score.created_at|date:"d" }}</i></span>
            <h1 title="{{ score.title }}">
                 {{ score.title }}
            </h1>
            <p>班级：{{score.student.teacher.class_name}}</p>
            <p style="padding:5px 0">老师：{{score.student.teacher.name}}</p>
        </a>
    </li>
    {% endfor %}
{% endif %}

单机每一科成绩，即可根据成绩id进入该科成绩的详情页，在详情页需要显示学生名、考试名称和学生成绩等内容，如果成绩id不存在，则进入404错误页面，在student/views.py目录中创建score()函数，关键代码如下：

@login_required
def score(request, score_id):
    """
    成绩详情
    :param request:
    :param score_id:
    :return:
    """
    try:
        score= Score.object.get(id=score_id)
    except:
        return render(request,'404.html', {"errmsg":'数据异常'})
    return render(request,'score.html',{'score':score})

同时创建score表结构：

from django.db import models
from utils.base_models import CreateUpdateMixin
from student.models import Student


class Score(CreateUpdateMixin):
    title = models.CharField(max_length=20,help_text='title/考试名称',verbose_name='考试名称')
    score = models.DecimalField(max_digits=5,decimal_places=2,help_text='score/分数',verbose_name='分数')
    student = models.ForeignKey(Student, on_delete=models.CASCADE,verbose_name='学生姓名')  # 设置外键

    def student_name(self):
        """
        获取学生姓名
        """
        self.verbose_name = '学生姓名'
        return self.student.name
    student_name.short_description = '学生姓名'

    def student_num(self):
        """
        获取学号
        """
        self.verbose_name = '学号'
        return self.student.student_num
    student_num.short_description = '学号'

    class Meta:
        db_table = "score"
        verbose_name_plural = "成绩信息"
        verbose_name = "成绩信息"

13.7后台管理员模块设计

管理员具有网站的最高权限，在本项目中只为其设计管理老师信息和设置权限功能。创建管理员的命令如下：

python manage.py createsuperuser

13.7.1管理老师信息

为了实现管理员具有后台管理老师信息的功能，需要在teacher应用中编写teacher/admin.py文件对后台老师模块进行设置。创建TeacherAdmin类，继承admin.ModelAdmin父类。在TeacherAdmin类中定义相应的类属性，如list_display用于配置展示列表的字段;list_filter用于配置过滤查询字段；search_fields用于配置搜索字段等。配置完成后，需要使用admin.site.register(Teacher, TeacherAdmin)将Teacher模型类绑定到TeacherAdmin管理后台。关键代码如下：

from django.contrib import admin
from teacher.models import Teacher
from django.contrib.auth.models import User
from django.conf import settings
from django.contrib.auth.hashers import make_password


# Register your models here.


class TeacherAdmin(admin.ModelAdmin):
    # 配置展示列表，在Teacher板块下方列表展示
    list_display = ('name', 'email', 'class_name', 'gender', 'phone')
    # 配置过滤查询字段，在Teacher板块右侧显示过滤框
    list_filter = ('class_name', 'name')
    # 配置可以搜索的字段，在Teacher板块下方显示搜索框
    search_fields = (['class_name', 'name'])
    # 定义后台列表显示时每页显示的数量
    list_per_page = 30
    # 定义列表显示的顺序
    ordering = ('-create_at',)
    # 显示字段
    fieldsets = (
        (None, {
            'fields': ('name', 'email', 'class_name', 'gender', 'phone')
        }),
    )

    def save_model(self, request, obj, form, change):
        user = User.objects.create(
            email=request.POST.get("email"),  # 获取邮箱
            username=request.POST.get("email"),  # 防止重名，用Email作为用户登陆名
            password=make_password(settings.TEACHER_INIT_PASSWORD),  # 密码加密
            is_staff=1  # 郧西作为管理员登陆后台
        )
        obj.tid_obj.user_id = user.id  # 获取新增用户的id，作为tid和user_id
        super().save_model(request, obj, form, change)
        return

    def delete_queryset(self, request, queryset):
        """
        删除多条数据
        同时删除user表中数据
        由于使用的是批量删除，所以需要遍历delete_queryset 中的 queryset
        :param request: 
        :param queryset: 
        :return: 
        """
        for obj in queryset:
            obj.user.delete()
        super().delete_model(request, obj)
        return

    def delete_model(self, request, obj):
        """
        删除单条记录
        同时删除user表中数据
        :param request: 
        :param obj: 
        :return: 
        """
        super().delete_model(request, obj)
        if obj.user:
            obj.user.delete()
        return
    
    
    
# 设置后台页面头部显示内容和页面标题
admin.site.site_header = "学生管理系统"
admin.site.site_site = "学生管理系统"
# 绑定Teacher模型到TeacherAdmin管理后台
admin.site.register(Teacher, TeacherAdmin)

上述代码中，定义save_model()方法用来覆盖父类的save_model()方法，是先保存老师信息的同时添加到auth_user表。定义delete_queryset()方法用来覆盖父类的delete_queryset()方法，实现批量删除老师信息的同时，删除auth_user表中的用户信息。定义delete_model()方法覆盖父类方法，实现删除单个用户信息的同时，删除auth_user表中的用户信息。

在网站后台首页，单机“老师信息”即可进入老师管理页面，

由于teacher表和auth_user表是一对一的关系，添加老师后，也会在auth_user表中和新增一条用户信息。为防止老师重名，将teacher表的邮箱作为auth_user表的用户名，并且设置初始密码为setting.py文件中settings.TEACHER_INIT_PASSWORD的值。

此外，由于设置了级联删除，当删除teacher表的数据以后，auth_user表中对应的记录也会一并删除，反之亦然。

13.7.2设置权限组

添加完老师信息以后，需要魏老师用户设置权限，该权限包括管理学生信息、管理考试成绩信息、批量导入学生信息和成绩信息等。

（1）单机后台首页中的“组”进入权限组管理，单机“增加组”按钮进入权限组设置，然后添加组名称，并选中该族所具备的权限：

单机“用户”进入用户列表，单击选择老师邮箱，进入用户详情页面，在"可用组"列表中将“老师”添加到右侧的“选中的组”列表中：

13.8老师模块设计

在auth_user表中，老师用户的is_staff字段值为1，所以老师用户可以通过用户名和密码登录后台。

登陆成功以后，该用户就具备老师用户组的的权限，可以管理学生信息、管理成绩信息和批量上传以及修改密码，

13.8.1管理学生信息

为了实现老师在后台管理学生信息的功能，需要在student应用中编写student/admin.py文件对后台学生模块进行设置。创建StudentAdmin类，继承admin.ModelAdmin父类。StudentAdmin类的实现与TeacherAdmin类似：

from django.contrib import admin
from student.models import Student
from django.contrib.auth.models import User
from django.conf import settings
from django.contrib.auth.hashers import make_password


# Register your models here.


class StudentAdmin(admin.ModelAdmin):
    """
    创建StudentAdmin类，继承自admin.ModelAdmin
    """
    # 配置展示列表，在user板块下方列表展示
    list_display = ('student_num', 'name', 'class_name', 'teacher_name', 'gender', 'birthday')
    # 配置过滤查询字段，在User板块右侧显示过滤框
    list_filter = ('name', 'student_name')
    # 配置可以搜索的字段，在User板块下方显示搜索框
    search_fields = (['name', 'student_name'])
    readonly_fields = ("teacher",)  # 设置只读字段，不允许更改
    ordering = ('-created_at',)  # 定义列表现实的顺序，符号表示降序
    # 显示字段
    fieldsets = (
        (None, {
            'fields': ('student_num', 'name', 'gender', 'phone', 'birthday')
        }),
    )

    def save_model(self, request, obj, form, change):
        """
        添加student表时，同时添加到user表
        由于需要和teacher表级联，所以自动获取当前登陆的老师id作为teacher_id
        :param request:
        :param obj:
        :param form:
        :param change:
        :return:
        """
        if not change:
            user = User.objects.create(

                username=request.POST.get("student_num"),  # 学号作为用户登陆名
                password=make_password(settings.STUDENT_INIT_PASSWORD),
            )
            obj.user_id = user.id  # 获取新增用户的id
            obj.teacher_id = request.user.id  # 获取当前老师的id
            super().save_model(request, obj, form, change)  # 调用父类保存方法
            return

    def delete_queryset(self, request, queryset):
        """
        删除多条数据
        同时删除user表中数据
        由于使用的是批量删除，所以需要遍历delete_queryset 中的 queryset
        :param request:
        :param queryset:
        :return:
        """
        for obj in queryset:
            obj.user.delete()
            super().delete_model(request, obj)
            return

    def delete_model(self, request, obj):
        """
        删除单条记录
        同时删除user表中数据
        :param request:
        :param obj:
        :return:
        """
        super().delete_model(request, obj)
        if obj.user:
            obj.user.delete()
        return


# 绑定Student模型到StudentAdmin管理后台
admin.site.register(Student, StudentAdmin)

上述代码中，由于teacher表和student表是一对多关系，所以在auth_user表中设置了teacher_id字段，

该字段的值即为当前登录的老师用户id。

老师账号登陆管理后台后，但学生信息右侧的”增加“按钮，即可添加学生信息

单击”保存“按钮，页面会跳转到学列表页，并显示学生所在的”班级名称“和”老师姓名“。因为student表中没有这两个字段，所以需要在student/model.py中编写如下代码

def teacher_name(self):
    """
    获取老师名称
    """
    self.verbose_name = '老师名称'
    return self.teacher.name

teacher_name.short_description = '老师名称'

def class_name(self):
    """
    获取班级名称
    """
    return self.teacher.class_name

class_name.short_description = '班级名称'

学生信息列表如图所示：

13.8.2管理成绩信息

为了实现老师在后台管理成绩信息的功能，需要在score应用中编写score/admin.py文件对后台成绩模块进行设置。创建ScoreAdmin类，继承自admin.ModelAdmin父类。score/admin.py:

from django.contrib import admin
from score.models import Score


class ScoreAdmin(admin.ModelAdmin):
    """
    创建ScoreAdmin类，继承自admin.ModelAdmin
    """
    # 配置展示列表，在Score板块下方列表显示
    list_display = ('title', "student_num", 'student', 'score')
    # 配置过滤查询字段，在Score板块右侧显示过滤框
    list_filter = ('title', 'student')
    # 配置可以搜索的字段，在Score板块下方显示搜索框
    # student是外键，管理student类，这里使用双下划线+属性名的方式搜索
    search_fields = (['title', 'student__name', 'student__student_num'])
    ordering = ('-created_at',)  # 定义列表显示的顺序，负号为降序
    fieldsets = (
        (None, {
            'fields': ('title', 'student', 'score')
        }),
    )


# 绑定Scope模型到ScoreAdmin管理后台
admin.site.register(Score, ScoreAdmin)

student和score是一对多的关系，所以在添加学生信息时需要选择学生姓名：

添加完成信息后，页面没有跳转到成绩列表页。在该页面中可以根据考试名称、学生姓名以及学号进行查询。由于score表中没有学生姓名和学号字段，所以不能直接在search_fields属性中设置，但是可以通过score表中的student外键关联到student表，使用双下划线+属性名的方式设置，代码如下：

search_field = (["title","student__name","student__student_num"])

成绩列表如图：

13.8.3批量上传学生信息和成绩信息

当学生信息和成绩信息较多时，使用手动上传的方式会非常繁琐，并且难以保证上传的准确率。此时老师用户可以使用批量上传的方式来结局这个问题。那么数据从哪里获得呢？通常情况下，可以将学生信息和成绩信息先保存到Excel文件中，然后在后台导入Excel文件，将Excel数据存储到Mysql数据库中，从而实现批量上传的目的。

学生信息：

成绩信息：

uploadfile用于实现批量上传功能，具体步骤如下

（1）编写uploadfile/models.py文件

设置允许上传的文件后缀为xls或xlsx，并且定义上传的文件内容是学生信息或成绩信息，关键代码如下

from django.db import models
from utils.base_models import CreateUpdateMixin
from django.core import validators
from teacher.models import Teacher

TYPE_CHOICES = (
    (1, '学生信息'),
    (2, '成绩信息'),
)


class FileUpload(CreateUpdateMixin):
    file_name = models.FileField(
        validators=[validators.FileExtensionValidator(['xls', 'xlsx'], message='必须为xls或xlsx文件')],
        help_text='file_type/上传文件名', verbose_name='上传文件名')
    file_type = models.IntegerField(choices=TYPE_CHOICES, default=1, help_text='file_type/文件类型', verbose_name='文件类型')
    teacher = models.ForeignKey(Teacher, on_delete=models.CASCADE)  # 设置外键

    class Meta:
        db_table = "file"
        verbose_name_plural = "上传文件"
        verbose_name = "上传文件"

在上传文件页面，如果上传其他格式文件（jpg等），单击提交，将提示”必须为xls或xlsx文件“错误信息，如图所示：

（2）编写uploadfile/admin.py文件

接受上传的Excel文件，然后使用openpyxl库读取Excel数据，并写入数据库，关键代码如下

class FileUploadAdmin(admin.ModelAdmin):
    #  配置展示列表，在User版块下的列表展示
    list_display = ('file_name',)
    # 设置只读字段，不允许更改
    readonly_fields = ('teacher',)

    def save_model(self, request, obj, form, change):
        obj.teacher_id = request.user.id  # 获取当前老师的ID
        # 调用父类方法保存
        super().save_model(request, obj, form, change)
        # 拼接目录
        file_path = os.path.join(settings.MEDIA_ROOT, obj.file_name.name)
        if request.POST['file_type'] == '1':  # 上传学生信息
            repetition = self.upload_student(file_path, request.user.id)
        elif request.POST['file_type'] == '2':  # 上传成绩信息
            repetition = self.upload_score(file_path)
        # 提示重复数据条数
        if repetition:
            messages.add_message(request, messages.INFO, f'过滤{repetition}条重复数据')
        return

上述代码中，如果上传的是学生信息内容，则调用upload_student()方法。upload_student()方法中使用openpyxl模块读取Excel中的每一行学生信息。首先判断该学号的用户是否存在，如果已经存在，则不添加学生信息；如果不存在，则把该学生信息写入auth_user表，并且使用bulk_create()方法批量添加到student表中，upload_student()方法代码如下：

def upload_student(self, file_path, teacher_id):
    wb = openpyxl.load_workbook(file_path)  # 打开excel
    ws = wb.active  # 选中第一个sheet
    rows = ws.max_row  # 获取行数
    columns = ws.max_column  # 获取列数
    student_list = []
    repetition = 0
    # 从第2行开始遍历每行
    for row in ws.iter_rows(min_row=2, min_col=1, max_row=rows, max_col=columns):
        data = [i.value for i in row]  # 获取每一行数据
        # 去除重复数据
        if Student.objects.filter(student_num=data[0]).exists():
            repetition += 1
            continue
        # 写入User表
        user = User(
            username=data[0],  # 以学号作为用户名，防止重复
            password=make_password(settings.STUDENT_INIT_PASSWORD),
        )
        user.save()  # 存入数据库
        # 写入student表
        student = Student(
            student_num=data[0],
            name=data[1].strip(),  # 去除空格
            gender='male' if data[2] == "男" else "femal",
            phone=data[4],
            birthday=data[3],
            user_id=user.id,
            teacher_id=teacher_id
        )
        student_list.append(student)
    Student.objects.bulk_create(student_list)  # 批量加入Student表
    return repetition

批量添加学生信息运行效果图如图所示：

如果上传的是成绩信息内容，则调用upload_score()方法。upload_score()方法中使用，openpyxl模块读取Excel中的每一行成绩信息。首先判断学号是否存在，如果不存在，咋不天界学生成绩信息；如果存在，则获取该用户id，然后查找score表中是否还有该学生的成绩信息，并且使用bulk_create()方法批量添加到score表中。upload_score()方法的关键代码如下：

def upload_score(self, file_path):
    wb = openpyxl.load_workbook(file_path)  # 打开excel
    ws = wb.active  # 选中第一个sheet
    rows = ws.max_row  # 获取行数
    columns = ws.max_column  # 获取列数
    score_list = []
    repetition = 0
    # 从第2行开始遍历每行
    for row in ws.iter_rows(min_row=2, min_col=1, max_row=rows, max_col=columns):
        data = [i.value for i in row]  # 获取每一行数据
        # 查找student表，获取student_id
        try:
            student = Student.objects.get(student_num=data[1])
        except:
            continue
        # 去除重复数据
        if Score.objects.filter(title=data[0], student_id=student.id).exists():
            repetition += 1
            continue
        # 写入student表
        score = Score(
            title=data[0],  # 标题
            student_id=student.id,  # 学生id
            score=data[-1]  # 学生分数
        )
        score_list.append(score)

    Score.objects.bulk_create(score_list)  # 批量加入Score表
    return repetition

最后绑定：

admin.site.register(FileUpload, FileUploadAdmin)

效果图：

源码：https://gitee.com/laoliNb666/ss_manager_by_django