一、项目介绍
该项目使用Django+xadmin打造在线教育平台整站,通过该项目的学习可以对Django框架有一个整体的了解,学会使用Django的MVC设计模式,学会使用Django的模板技术来实现前端页面的显示。学习如何就一个项目去合理的进行数据库的设计,以及就前端页面去设计后端接口。学会通过xadmin快速搭建网站的后台管理系统。
项目整体分为四个模块:用户信息相关模块、机构相关模块、课程相关模块、用户操作相关模块。
项目功能概括:
1、首先具有完整的用户登录,邮箱注册以及找回密码功能。
2、拥有完整的个人中心,个人中心可以修改头像、密码、邮箱,可以看到我的课程、我的收藏及我的消息。
3、首页导航栏有公开课、授课讲师、授课机构,顶部还有全局搜索。
4、导航栏点击公开课显示课程的列表、可以对课程进行排序、搜索,还有热门课程的推荐,课程较多可以进行分页。
5、点击具体的课程可以显示课程的详情页面,该页中可以对课程进行收藏、学习,通过富文本展示课程的详细描述信息。
6、点击开始学习,进入课程的学习页面,该页有课程的章节信息、评论信息,可以对课程进行评论,可以将课程资源进行下载。
7、导航栏点击授课讲师,显示所有讲师列表,可以对讲师进行人气排序,讲师过多会进行分页显示,右边有讲师排行榜。
8、点击某一个讲师,进入讲师详情页面,显示讲师的全部课程,可以对该讲师进行收藏和分享。
9、导航栏点击授课机构,进入机构的列表页,可以对机构进行排序和筛选。
10、点击某一个机构,进入机构首页,左侧有导航栏,有机构首页、机构课程、机构介绍、机构讲师。
项目的开发流程:
开发环境的搭建--->model数据库的设计--->xadmin搭建后台管理系统并录入数据--->url设计--->form以及modelform表单设计--->template模板设计--->view实现各功能模块--->常见的网络攻击与防护--->项目上线
开发环境:python3.6.4+django2.0.2
二、项目环境搭建
pycharm新建一个项目,创建django项目,指定项目的虚拟环境,点击确定即可创建好一个django框架项目。
创建好之后,项目的目录结构如下:
现在django项目已经搭建好了,下面就可以开始开发了。
三、model数据库设计
1、创建模块
项目的开发都是从数据库model设计开始的,model设计的好坏对整个项目的开发起着非常重要的因素。
在设计model之前需要先创建好项目的四个app(模块),首先在pycharm的工具栏中找到Tools,点击Run manage.py Task这个选项,启动manage.py文件,用这个文件来创建项目的模块,还可以通过这个文件来迁移数据库,还可以创建后台的管理人员账号。
依次创建四个app:
startapp users(用户相关模块)
startapp course(课程相关模块)
startapp organization(机构相关模块)
startapp operation(用户操作相关模块)
创建完成之后,就可以设计每个app的数据库model了
2、数据库设计
2.1 users用户设计
用户app中需要设计三张表:
UserProfile 用户信息
EmailVerifyRecord 邮箱验证码
Banner 轮播图
通过个人中心页面,可以设计出用户信息相关的model:
我们可以继承Django已经有的一个类AbstractUser,这个类中有用户相关的一些字段信息,继承这个类后可以自定义我们需要的一些字段,如个人中心中的昵称,生日,性别,地址,手机号,头像,确定好之后就可以编写用户信息的model了,在users/models.py编写数据库设计的代码:
1 from django.db import models 2 from django.contrib.auth.models import AbstractUser 3 4 # Create your models here. 5 6 class UserProfile(AbstractUser): 7 GENDER_CHOICES = ( 8 ('male', '男'), 9 ('female', '女')10 )11 12 nick_name = models.CharField('昵称', max_length=50, default='')13 birthday = models.DateField('生日', null=True, blank=True)14 gender = models.CharField('性别', max_length=10, choices=GENDER_CHOICES, default='male')15 address = models.CharField('地址', max_length=100, default='')16 mobile = models.CharField('手机号', max_length=11, null=True, blank=True)17 image = models.ImageField('头像', upload_to='image/%Y%m', default='image/default.png', max_length=100)18 19 class Meta:20 verbose_name = '用户信息'21 verbose_name_plural = verbose_name22 23 def __str__(self):24 return self.username
因为image字段需要用到pillow库,所以需要先安装pillow库:pip install pillow
然后将这个app注册到setting.py文件中的INSTALLED_APPS中,然后重载AUTH_USER_MODEL:
1 INSTALLED_APPS = [2 'django.contrib.auth',3 'django.contrib.contenttypes',4 'django.contrib.sessions',5 'django.contrib.messages',6 'django.contrib.staticfiles',7 'users'8 ]9 AUTH_USER_MODEL = 'users.UserProfile'
然后在setting.py文件中配置数据库:
1 DATABASES = { 2 'default': { 3 'ENGINE': 'django.db.backends.mysql', 4 'NAME': 'mxonline', 5 'USER': 'root', 6 'PASSWORD': 'python', 7 'HOST': '127.0.0.1', 8 'PORT': '3306' 9 }10 }
现在就可以迁移数据库了,首先在pycharm的工具栏中找到Tools,点击Run manage.py Task这个选项,启动manage.py文件,用这个文件来执行迁移数据库的命令:
makemigrations
migrate
数据库生成完成。
然后开始设计EmailVerifyRecord表,这个表的字段有验证码、邮箱、发送的类型、发送的时间:
1 class EmailVerifyRecord(models.Model): 2 """邮箱验证码""" 3 SEND_CHOICES = ( 4 ('register', '注册'), 5 ('forget', '找回密码') 6 ) 7 8 code = models.CharField('验证码', max_length=20) 9 email = models.EmailField('邮箱', max_length=50)10 send_type = models.CharField('发送类型', max_length=10, choices=SEND_CHOICES)11 send_time = models.DateTimeField('发送时间', default=datetime.now)12 13 class Meta:14 verbose_name = '邮箱验证码'15 verbose_name_plural = verbose_name
然后开始设计Banner表,这个表的字段有标题、轮播图片、访问地址、播放顺序、添加时间:
1 class Banner(models.Model): 2 """轮播图""" 3 title = models.CharField('标题', max_length=100) 4 image = models.ImageField('轮播图', upload_to='banner/%Y%m', max_length=100) 5 url = models.URLField('访问地址', max_length=200) 6 index = models.IntegerField('轮播顺序', default=100) 7 add_time = models.DateTimeField('添加时间', default=datetime.now) 8 9 class Meta:10 verbose_name = '轮播图'11 verbose_name_plural = verbose_name
至此,users这个模块的数据库设计完毕,执行迁移数据库的命令生成数据库中的表。
2.2 course课程设计
课程app中需要四张表:
Course 课程信息
Lesson 章节信息
Video 视频信息
CourseResource 课程资源
在course/models.py文件中编写Course课程相关代码:
1 from datetime import datetime 2 3 from django.db import models 4 5 # Create your models here. 6 7 class Course(models.Model): 8 """课程""" 9 DEGREE_CHOICES = (10 ('cj', '初级'),11 ('zj', '中级'),12 ('gj', '高级')13 )14 15 name = models.CharField('课程名', max_length=50)16 desc = models.CharField('课程描述', max_length=300)17 detail = models.TextField('课程详情')18 degree = models.CharField('课程难度', choices=DEGREE_CHOICES, max_length=2)19 learn_times = models.IntegerField('学习时长(分钟数)', default=0)20 students = models.IntegerField('学习人数', default=0)21 fav_nums = models.IntegerField('收藏人数', default=0)22 click_nums = models.IntegerField('点击数', default=0)23 image = models.ImageField('封面图', upload_to='courses/%Y/%m', max_length=100)24 add_time = models.DateTimeField('添加时间', default=datetime.now)25 26 class Meta:27 verbose_name = '课程'28 verbose_name_plural = verbose_name29 30 def __str__(self):31 return self.name32 33 34 class Lesson(models.Model):35 """章节"""36 course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)37 name = models.CharField('章节名', max_length=100)38 add_time = models.DateTimeField('添加时间', default=datetime.now)39 40 class Meta:41 verbose_name = '章节'42 verbose_name_plural = verbose_name43 44 def __str__(self):45 return '《{}》课程的章节:{}'.format(self.course.name, self.name)46 47 48 class Video(models.Model):49 """视频"""50 lesson = models.ForeignKey(Lesson, verbose_name='章节', on_delete=models.CASCADE)51 name = models.CharField('视频名', max_length=100)52 add_time = models.DateTimeField('添加时间', default=datetime.now)53 54 class Meta:55 verbose_name = '视频'56 verbose_name_plural = verbose_name57 58 59 class CourseResourse(models.Model):60 """课程资源"""61 course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)62 name = models.CharField('资源名称', max_length=100)63 download = models.FileField('资源文件', upload_to='course/resource/%Y/%m', max_length=100)64 add_time = models.DateTimeField('添加时间', default=datetime.now)65 66 class Meta:67 verbose_name = '课程资源'68 verbose_name_plural = verbose_name
完成之后需要将course这个app注册进settings.py文件中的INSTALLED_APPS,注册进入之后,就可以迁移数据库生成数据库中的表了。
2.3 organization机构设计
机构app中需要三张表:
CourseOrg 课程机构基本信息
Teacher 教师基本信息
CityDict 城市信息
在organization/models.py文件中编写organization机构相关代码:
1 from datetime import datetime 2 3 from django.db import models 4 5 # Create your models here. 6 7 class CityDict(models.Model): 8 """城市""" 9 name = models.CharField('名称', max_length=20)10 desc = models.CharField('描述', max_length=200)11 add_time = models.DateTimeField('添加时间', default=datetime.now)12 13 class Meta:14 verbose_name = '城市'15 verbose_name_plural = verbose_name16 17 18 class CourseOrg(models.Model):19 """课程机构"""20 name = models.CharField('机构名称', max_length=50)21 desc = models.TextField('机构描述')22 click_nums = models.IntegerField('点击数', default=0)23 fav_nums = models.IntegerField('收藏数', default=0)24 image = models.ImageField('封面图', upload_to='org/%Y/%m', max_length=100)25 address = models.CharField('地址', max_length=150)26 city = models.ForeignKey(CityDict, verbose_name='所在城市', on_delete=models.CASCADE)27 add_time = models.DateTimeField('添加时间', default=datetime.now)28 29 class Meta:30 verbose_name = '课程机构'31 verbose_name_plural = verbose_name32 33 34 class Teacher(models.Model):35 """机构老师"""36 org = models.ForeignKey(CourseOrg, verbose_name='所属机构', on_delete=models.CASCADE)37 name = models.CharField('老师名', max_length=50)38 work_years =models.IntegerField('工作年限', default=0)39 work_company = models.CharField('就职公司', max_length=50)40 work_position = models.CharField('工作职位', max_length=50)41 points = models.CharField('教学特点', max_length=50)42 click_nums = models.IntegerField('点击数', default=0)43 fav_nums = models.IntegerField('收藏数', default=0)44 add_time = models.DateTimeField('添加时间', default=datetime.now)45 46 class Meta:47 verbose_name = '教师'48 verbose_name_plural = verbose_name49 50 def __str__(self):51 return '[{}]机构的教师:{}'.format(self.org.name, self.name)
完成之后需要将organization这个app注册进settings.py文件中的INSTALLED_APPS,注册进入之后,就可以迁移数据库生成数据库中的表了。
2.4 operation用户操作设计
用户操作app中需要五张表:
UseAsk 用户咨询相关
UserMessage 用户消息相关
CourseComments 用户评论相关
UserCourse 用户学习的课程相关
UserFavorite 用户收藏相关
在operation/models.py文件中编写operation用户操作相关代码:
1 from datetime import datetime 2 3 from django.db import models 4 5 from users.models import UserProfile 6 from course.models import Course 7 8 # Create your models here. 9 10 class UserAsk(models.Model):11 """用户咨询"""12 name = models.CharField('姓名', max_length=20)13 mobile = models.CharField('手机', max_length=11)14 course_name = models.CharField('课程名', max_length=50)15 add_time = models.DateTimeField('添加时间', default=datetime.now)16 17 class Meta:18 verbose_name = '用户咨询'19 verbose_name_plural = verbose_name20 21 def __str__(self):22 return self.name23 24 25 class UserMessage(models.Model):26 """用户消息"""27 user = models.IntegerField('接收用户', default=0) # 默认0代表发送给所有用户,可以通过user.id发送给指定用户28 message = models.CharField('消息内容', max_length=500)29 has_read = models.BooleanField('是否已读', default=False)30 add_time = models.DateTimeField('添加时间', default=datetime.now)31 32 class Meta:33 verbose_name = '用户消息'34 verbose_name_plural = verbose_name35 36 37 class CourseComments(models.Model):38 """课程评论"""39 user = models.ForeignKey(UserProfile, verbose_name='用户', on_delete=models.CASCADE)40 course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)41 comments = models.CharField('评论内容', max_length=200)42 add_time = models.DateTimeField('添加时间', default=datetime.now)43 44 class Meta:45 verbose_name = '课程评论'46 verbose_name_plural = verbose_name47 48 49 class UserCourse(models.Model):50 """用户课程"""51 user = models.ForeignKey(UserProfile, verbose_name='用户', on_delete=models.CASCADE)52 course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)53 add_time = models.DateTimeField('添加时间', default=datetime.now)54 55 class Meta:56 verbose_name = '用户课程'57 verbose_name_plural = verbose_name58 59 60 class UserFavorite(models.Model):61 """用户收藏"""62 FAV_CHOICES = (63 (1, '课程'),64 (2, '课程机构'),65 (3, '讲师'),66 )67 user = models.ForeignKey(UserProfile, verbose_name='用户', on_delete=models.CASCADE)68 fav_id = models.IntegerField('数据id', default=0)69 fav_type = models.IntegerField(verbose_name='收藏类型', choices=FAV_CHOICES, default=1)70 add_time = models.DateTimeField('添加时间', default=datetime.now)71 72 class Meta:73 verbose_name = '用户收藏'74 verbose_name_plural = verbose_name
完成之后需要将operation这个app注册进settings.py文件中的INSTALLED_APPS,注册进入之后,就可以迁移数据库生成数据库中的表了。
2.5 模块规范化
为了方便管理,将四个模块放到同一个文件夹中,在项目根目录下新建包apps,把这四个模块全部放进这个包中,注意在拖动的时候不要选择Search for references。
然后将apps这个包右键Mark Directory as,选择Sources Root,让pycharm可以找到这些模块。
但是如果在其他环境部署的时候会报错,需要在settings.py中进行设置。
1 import os2 import sys3 4 # Build paths inside the project like this: os.path.join(BASE_DIR, ...)5 BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))6 sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))
此刻项目的目录结构如下: