标签： python django
本项目是教学资源管理系统的2.0版本，采用Python和Django进行编写，1.0版本在https://github.com/CLaraRR/Resource-Management-System 可以找到，采用Java实现。本项目使用的前端模板是从网上搜集而来，可以从另一个repo下载https://github.com/CLaraRR/BackgroundManagementSystem-template 。
2.0版本相对于1.0版本的实现除了使用语言不同之外，还增加了几个模块，下面是这个项目的介绍。
clone或下载项目到本地，建议在虚拟环境下运行该项目。
Ctrl + R打开cmd,输入
pip install virtualenv
创建一个文件夹专门用来存放虚拟环境，比如F:\PythonEnvs，进入该文件夹下，打开命令行，输入
virtualenv rms_env
然后rms_env文件夹就会被创建了，进入到Scripts文件夹，命令行输入
./activate
看到命令行前面多出了（rms_env）意思就是进入了我们刚才创建的虚拟环境
往后运行项目都在这个虚拟环境下，如果没看到前面的（rms_env）则按上面的方法重新进入。
在这个虚拟环境下进入到这个项目的根目录，命令行输入
pip install -r requirements.txt
然后就会自动安装所需的库了
mysqlclient在windows可能会安装失败，可以通过whl安装，在mysqlclient文件夹可以找到（因为我的平台是win10，所以我只下载了windows版本的whl，版本有27、37、38），根据自己的python的版本选择，然后命令行输入
pip install whl所在路径
在mysql数据库新建名为rms的数据库，在项目rms_django文件夹下的setting.py中修改数据库账号密码为你自己的数据库账号密码。
迁移数据库至mysql:命令行输入
python manage.py makemigrations
python manage.py migrate
django就会自动在数据库里面建立model.py的类所对应的表。
在这个虚拟环境下进入到这个项目的根目录，命令行输入
python manage.py runserver
启动服务器成功后打开浏览器，输入http://127.0.0.1:8000/login/ 就能看到项目的登录页面了。
因为此时数据库里面还没有任何用户，而一般系统都会有一个超级用户，也就是管理员，所以先创建一个超级用户,，命令行输入
python manage.py create superuser
根据提示填写管理员信息。
创建好管理员之后，在浏览器输入http://127.0.0.1:8000/admin/ ，用刚才创建的账号密码登录，这就进入了django自带的管理后台。在这个后台可以直接对各个用户进行设置，也可以对各个model进行增删查改。
我们可以在管理后台创建一些教师、学生用户，也可以创建学院、专业、课程的数据。
如果不想自己一个个创建，可以参考我的数据库，里面已经创建好了一些数据段，在mydatabase文件夹可以找到，用mysql管理工具就可以导入数据。
ps:我只提供了某些表的数据，像resource表或者与resource表关联的表的数据我没有提供，因为resource需要用户在系统内上传资源才会在表中创建字段，这个大家就自行添加啦。
这个教学资源管理系统（以下简称为rms）主要面向学校的三类用户：管理员、教师、学生，主要功能有用户管理、课程管理、课程成绩管理、资源管理、举报管理、通知管理、任务管理、任务成绩管理等。
各类用户在不同模块中的操作不同。
| 模块 | 管理员 | 教师 | 学生 |
|---|---|---|---|
| 用户管理 | 对各类用户增删查改 | - | - |
| 课程管理 | 对课程增删查改 | 查 | 查 |
| 课程成绩管理 | 对课程成绩增删查改 | 增删查改 | 查 |
| 资源管理 | 对资源增删查改 | 增查 | 增查 |
| 举报管理 | 对举报删查 | 增查 | 增查 |
| 通知管理 | 对通知增删查改 | 查 | 查 |
| 任务管理 | 对任务增删查改 | 增删查改 | 查 |
| 任务成绩管理 | 对任务成绩增删查改 | 增删查改 | 查 |
以下模型在migrate时都在数据库自动创建了id字段，并自动设置为主键，因此下面在表格中省略书写id字段。
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 学院名称 | CharField |
| found_time | 成立时间 | DateField |
| location | 所在地址 | TextField |
| teacher_num | 教师人数 | PositiveIntegerField |
模型操作：increase_teacher_num 每增加一个教师用户则教师人数加1
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 专业名称 | CharField |
| found_time | 成立日期 | DateField |
| institute | 所在学院 | ForeignKey：Institute |
以 某入学年份+某入学学期+某学院机构+某专业 作为一个部门单位
| 字段名称 | 含义 | 类型 |
|---|---|---|
| year | 入学年份 | CharField |
| semester | 入学学期 | CharField |
| institute | 学院 | ForeignKey:Institute |
| major | 专业 | ForeignKey:Major |
| student_num | 部门学生人数 | PositiveIntegerField |
模型操作：increase_student_num 每增加一个学生用户，该学生用户所在部门的学生总人数加1
该用户模型可包含管理员、教师、学生三类用户
| 字段名称 | 含义 | 类型 |
|---|---|---|
| sno | 学工号 | CharField |
| section_info | 所在部门 | ForeignKey：SectionInfo |
| sex | 性别 | CharField |
| birthday | 出生日期 | DateField |
| type | 用户类型 | CharField |
说明：sno根据用户所在部门信息自动生成，无需手动设置。type有3种类型分别对应admin, teacher, student
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 课程名称 | CharField |
| create_time | 创建时间 | DateField |
| total_hours | 总学时 | PositiveIntegerField |
| credit | 学分 | PositiveIntegerField |
| teacher | 任课教师 | ForeignKey:User,limit_choices_to={'type':'teacher'} |
| institute | 开办学院 | ForeignKey:Institute |
| regular_proportion1 | 平时成绩1占比 | FloatField |
| regular_proportion2 | 平时成绩2占比 | FloatField |
| final_proportion | 期末成绩占比 | FloatField |
说明：teacher字段是一个外键，指向的是User表，且限制用户类型为teacher
修读某一门课程的学生将自动为其增加一条score记录
| 字段名称 | 含义 | 类型 |
|---|---|---|
| course | 课程名称 | ForeignKey：Course |
| student | 学生 | ForeignKey:User |
| regular_grade1 | 平时成绩1 | FloatField |
| regular_grade2 | 平时成绩2 | FloatField |
| final_grade | 期末成绩 | FloatField |
| total_grade | 总成绩 | FloatField |
| credit | 获得学分绩点 | PositiveIntegerField |
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 任务标题 | CharField |
| course | 课程名称 | ForeignKey:Course |
| description | 描述 | TextField |
| content | 内容 | TextField |
| is_allow_upload | 是否要求上传附件 | BooleanField |
| create_time | 创建时间 | DateTimeField |
| modify_time | 修改时间 | DateTimeField |
| deadline_time | 提交截止日期 | DateTimeField |
| author | 作者 | ForeignKey:User |
| appendix | 附件 | FileField |
| complete_num | 完成人数 | PositiveIntegerField |
| views | 浏览数 | PositiveIntegerField |
模型操作：
1.increase_views 任务页面每一打开一次浏览数加1
2.increase_complete_num 任务可以要求学生上传作业或者不上传，若要求学生上传作业，则当学生上传了作业则完成人数自动加1；若不要求学生上传作业，则由老师自行确认学生是否完成作业，老师在给学生打分时将默认为该学生完成作业，并且完成人数加1
修读了某一门课程的学生，当该门课的任课老师布置一个任务时，将自动为这个学生增加一条关于这个任务的score记录
| 字段名称 | 含义 | 类型 |
|---|---|---|
| task | 所在任务 | ForeignKey:Task |
| student | 学生 | ForeignKey:User |
| file | 作业文件 | FileField |
| is_complete | 是否完成任务 | BooleanField |
| score | 任务成绩 | PositiveIntegerField |
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 通知标题 | CharField |
| content | 通知内容 | TextField |
| create_time | 创建时间 | DateTimeField |
| modify_time | 修改时间 | DateTimeField |
| file | 附件 | FileField |
| author | 作者 | CharField |
| views | 浏览数 | PositiveIntegerField |
| downloads | 附件下载次数 | PositiveIntegerField |
模型操作：
1.increase_views 通知页面每被浏览一次则浏览数加1
2.increase_downloads 通知附件每被下载一次则下载数加1
用户可以对资源进行举报
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 举报标题 | CharField |
| resource | 举报资源 | ForeignKey:Resource |
| description | 描述 | TextField |
| content | 详细举报内容 | TextField |
| create_time | 创建时间 | DateTimeField |
| author | 举报人 | ForeignKey:User |
| is_view | 管理员是否已查看该举报 | BooleanField |
| is_manage | 管理员是否已处理该举报 | BooleanField |
模型操作：
1.view_status 如果管理员查看了该举报信息，则is_view字段变为true
2.manage_status 如果管理员处理了该举报信息，则is_manage字段变为true
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 资源类别 | CharField |
用户可以上传资源至rms
| 字段名称 | 含义 | 类型 |
|---|---|---|
| name | 资源名称 | CharField |
| description | 描述 | TextField |
| category | 类别 | ForeignKey:Category |
| version | 版本 | CharField |
| author | 作者 | CharField |
| file | 资源文件 | FileField |
| image | 资源图标 | ImageField |
| create_time | 创建时间 | DateTimeField |
| views | 资源浏览数 | PositiveIntegerField |
| downloads | 资源下载数 | PositiveIntegerField |
模型操作：
1.increase_views 资源页面每被浏览一次则浏览数加1
2.increase_downloads 资源每被下载一次则下载数加1
用户可以对资源进行评论
| 字段名称 | 含义 | 类型 |
|---|---|---|
| resource | 评论的资源 | ForeignKey:Resource |
| content | 评论的内容 | TextField |
| author | 作者 | CharField |
| create_time | 创建时间 | DateTimeField |
这些View是用class体现的。具体含义我就不一一解释了，应该从字面上就能看出来是干嘛的，主要就是从数据库取出数据到模板页面显示，不参与数据的post和get。
| IndexView | ResourceView | CategoryView | NoticeListView |
|---|---|---|---|
| ProfileView | ReportListView | ReportDetialView | CourseListView |
| ScoreListView | TaskListView | TaskDetailView |
这些action是用函数体现的。
| 函数名 | 所属模块 | 作用 |
|---|---|---|
| download_resource | 资源管理 | 下载资源 |
| resource_action | 资源管理 | GET:获取资源信息表单渲染至模板;POST:获取表单数据并上传资源 |
| report_action | 举报管理 | GET:获取举报信息表单渲染至模板；POST:获取表单字段数据保存至数据库 |
| report_manage | 举报管理 | 修改举报信息“是否已处理”状态 |
| report_delete | 举报管理 | 删除举报数据 |
| notice_action | 通知管理 | GET:获取通知表单渲染至模板；POST：获取表单数据保存至数据库 |
| download_notice | 通知管理 | 下载通知附件 |
| course_action | 课程管理 | GET:获取课程信息表单；POST：提交课程信息表单 |
| course_delete | 课程管理 | 删除课程数据 |
| course_student | 课程成绩管理 | GET:获取修读该门课的学生列表；POST：添加/更新修读该门课的学生，在Score表添加/更新该学生对应课程的成绩数据段 |
| course_equation | 课程管理 | GET:获得该门课的成绩计算公式；POST:更新该门课的成绩计算公式 |
| score_action | 课程成绩管理 | GET:获得某门课所有学生的成绩列表；POST:添加/更新该门课某个学生的成绩 |
| excel_export | 课程成绩管理 | 导出成绩单为excel格式并下载到本地 |
| task_action | 任务管理 | GET:获取任务信息表单；POST：添加/更新任务信息 |
| download_task_file | 任务管理 | 下载任务附件 |
| task_delete | 任务管理 | 删除某任务数据 |
| task_score_action | 任务成绩管理 | GET:获取某任务所有学生的成绩列表；POST:添加/更新某学生的任务成绩 |
| task_submit | 任务成绩管理 | GET:获取某任务的提交表单；POST：学生提交任务，添加/更新任务成绩数据 |
| download_tasks_submit | 任务管理 | 教师可以下载某个任务下所有学生提交的文件 |
django会根据定义好的form的字段自动在模板渲染该字段域，在后台通过form可获得对应model的对象。
| 表单 | fileds |
|---|---|
| ReportForm | name, description, content |
| ResourceForm | name, description, category, version, author, file, image |
| CommentForm | content, author |
| NoticeForm | name, content, file, author |
| CourseForm | name, create_time, total_hours, credit, teacher, institute |
| TaskForm | name, description, content, appendix |
| TaskSubmitForm | file |
因为我在实现form的时候是继承forms.ModelForm的，所以一个form对应一个model，form的fields其实是对应model的字段，在后台可以通过form = XXForm(request.POST)获取到表单数据，然后通过form.save()可以直接创建model对象并持久化到数据库。但是有些字段我没有放在在form里面，他就不会在模板自动渲染，因此在后台也不会获取到这些字段的数据，所以如果我要获得这些字段的数据的话可以用一般的html标签在模板定义一个输入域，如<input/>，然后在后台通过value = request.POST.get('name')得到该字段对应的数据。