（项目）在线教育平台（一）

一、项目介绍

　　该项目使用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编写数据库设计的代码：

from django.db import models
from django.contrib.auth.models import AbstractUser

# Create your models here.

class UserProfile(AbstractUser):
    GENDER_CHOICES = (
        ('male', '男'),
        ('female', '女')
    )

    nick_name = models.CharField('昵称', max_length=50, default='')
    birthday = models.DateField('生日', null=True, blank=True)
    gender = models.CharField('性别', max_length=10, choices=GENDER_CHOICES, default='male')
    address = models.CharField('地址', max_length=100, default='')
    mobile = models.CharField('手机号', max_length=11, null=True, blank=True)
    image = models.ImageField('头像', upload_to='image/%Y%m', default='image/default.png', max_length=100)

    class Meta:
        verbose_name = '用户信息'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.username

　　因为image字段需要用到pillow库，所以需要先安装pillow库：pip install pillow

　　然后将这个app注册到setting.py文件中的INSTALLED_APPS中，然后重载AUTH_USER_MODEL：

INSTALLED_APPS = [
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users'
]
AUTH_USER_MODEL = 'users.UserProfile'

　　然后在setting.py文件中配置数据库：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mxonline',
        'USER': 'root',
        'PASSWORD': 'python',
        'HOST': '127.0.0.1',
        'PORT': '3306'
    }
}

　　现在就可以迁移数据库了，首先在pycharm的工具栏中找到Tools，点击Run manage.py Task这个选项，启动manage.py文件，用这个文件来执行迁移数据库的命令：

　　　　makemigrations

　　　　migrate

　　数据库生成完成。

　　然后开始设计EmailVerifyRecord表，这个表的字段有验证码、邮箱、发送的类型、发送的时间：

class EmailVerifyRecord(models.Model):
    """邮箱验证码"""
    SEND_CHOICES = (
        ('register', '注册'),
        ('forget', '找回密码')
    )

    code = models.CharField('验证码', max_length=20)
    email = models.EmailField('邮箱', max_length=50)
    send_type = models.CharField('发送类型', max_length=10, choices=SEND_CHOICES)
    send_time = models.DateTimeField('发送时间', default=datetime.now)

    class Meta:
        verbose_name = '邮箱验证码'
        verbose_name_plural = verbose_name

　　然后开始设计Banner表，这个表的字段有标题、轮播图片、访问地址、播放顺序、添加时间：

class Banner(models.Model):
    """轮播图"""
    title = models.CharField('标题', max_length=100)
    image = models.ImageField('轮播图', upload_to='banner/%Y%m', max_length=100)
    url = models.URLField('访问地址', max_length=200)
    index = models.IntegerField('轮播顺序', default=100)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '轮播图'
        verbose_name_plural = verbose_name

　　至此，users这个模块的数据库设计完毕，执行迁移数据库的命令生成数据库中的表。

 2.2 course课程设计

　　课程app中需要四张表：

　　　　Course　　课程信息

　　　　Lesson　　章节信息

　　　　Video　　视频信息

　　　　CourseResource　　课程资源

　　在course/models.py文件中编写Course课程相关代码：

from datetime import datetime

from django.db import models

# Create your models here.

class Course(models.Model):
    """课程"""
    DEGREE_CHOICES = (
        ('cj', '初级'),
        ('zj', '中级'),
        ('gj', '高级')
    )

    name = models.CharField('课程名', max_length=50)
    desc = models.CharField('课程描述', max_length=300)
    detail = models.TextField('课程详情')
    degree = models.CharField('课程难度', choices=DEGREE_CHOICES, max_length=2)
    learn_times = models.IntegerField('学习时长（分钟数）', default=0)
    students = models.IntegerField('学习人数', default=0)
    fav_nums = models.IntegerField('收藏人数', default=0)
    click_nums = models.IntegerField('点击数', default=0)
    image = models.ImageField('封面图', upload_to='courses/%Y/%m', max_length=100)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '课程'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name


class Lesson(models.Model):
    """章节"""
    course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)
    name = models.CharField('章节名', max_length=100)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '章节'
        verbose_name_plural = verbose_name

    def __str__(self):
        return '《{}》课程的章节：{}'.format(self.course.name, self.name)


class Video(models.Model):
    """视频"""
    lesson = models.ForeignKey(Lesson, verbose_name='章节', on_delete=models.CASCADE)
    name = models.CharField('视频名', max_length=100)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '视频'
        verbose_name_plural = verbose_name


class CourseResourse(models.Model):
    """课程资源"""
    course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)
    name = models.CharField('资源名称', max_length=100)
    download = models.FileField('资源文件', upload_to='course/resource/%Y/%m', max_length=100)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '课程资源'
        verbose_name_plural = verbose_name

　　完成之后需要将course这个app注册进settings.py文件中的INSTALLED_APPS，注册进入之后，就可以迁移数据库生成数据库中的表了。

2.3 organization机构设计

　　机构app中需要三张表：

　　　　CourseOrg　　课程机构基本信息

　　　　Teacher　　教师基本信息

　　　　CityDict　　城市信息

　　在organization/models.py文件中编写organization机构相关代码：

from datetime import datetime

from django.db import models

# Create your models here.

class CityDict(models.Model):
    """城市"""
    name = models.CharField('名称', max_length=20)
    desc = models.CharField('描述', max_length=200)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '城市'
        verbose_name_plural = verbose_name


class CourseOrg(models.Model):
    """课程机构"""
    name = models.CharField('机构名称', max_length=50)
    desc = models.TextField('机构描述')
    click_nums = models.IntegerField('点击数', default=0)
    fav_nums = models.IntegerField('收藏数', default=0)
    image = models.ImageField('封面图', upload_to='org/%Y/%m', max_length=100)
    address = models.CharField('地址', max_length=150)
    city = models.ForeignKey(CityDict, verbose_name='所在城市', on_delete=models.CASCADE)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '课程机构'
        verbose_name_plural = verbose_name


class Teacher(models.Model):
    """机构老师"""
    org = models.ForeignKey(CourseOrg, verbose_name='所属机构', on_delete=models.CASCADE)
    name = models.CharField('老师名', max_length=50)
    work_years =models.IntegerField('工作年限', default=0)
    work_company = models.CharField('就职公司', max_length=50)
    work_position = models.CharField('工作职位', max_length=50)
    points = models.CharField('教学特点', max_length=50)
    click_nums = models.IntegerField('点击数', default=0)
    fav_nums = models.IntegerField('收藏数', default=0)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '教师'
        verbose_name_plural = verbose_name

    def __str__(self):
        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用户操作相关代码：

from datetime import datetime

from django.db import models

from users.models import UserProfile
from course.models import Course

# Create your models here.

class UserAsk(models.Model):
    """用户咨询"""
    name = models.CharField('姓名', max_length=20)
    mobile = models.CharField('手机', max_length=11)
    course_name = models.CharField('课程名', max_length=50)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '用户咨询'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name


class UserMessage(models.Model):
    """用户消息"""
    user = models.IntegerField('接收用户', default=0)  # 默认0代表发送给所有用户，可以通过user.id发送给指定用户
    message = models.CharField('消息内容', max_length=500)
    has_read = models.BooleanField('是否已读', default=False)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '用户消息'
        verbose_name_plural = verbose_name


class CourseComments(models.Model):
    """课程评论"""
    user = models.ForeignKey(UserProfile, verbose_name='用户', on_delete=models.CASCADE)
    course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)
    comments = models.CharField('评论内容', max_length=200)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '课程评论'
        verbose_name_plural = verbose_name


class UserCourse(models.Model):
    """用户课程"""
    user = models.ForeignKey(UserProfile, verbose_name='用户', on_delete=models.CASCADE)
    course = models.ForeignKey(Course, verbose_name='课程', on_delete=models.CASCADE)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '用户课程'
        verbose_name_plural = verbose_name


class UserFavorite(models.Model):
    """用户收藏"""
    FAV_CHOICES = (
        (1, '课程'),
        (2, '课程机构'),
        (3, '讲师'),
    )
    user = models.ForeignKey(UserProfile, verbose_name='用户', on_delete=models.CASCADE)
    fav_id = models.IntegerField('数据id', default=0)
    fav_type = models.IntegerField(verbose_name='收藏类型', choices=FAV_CHOICES, default=1)
    add_time = models.DateTimeField('添加时间', default=datetime.now)

    class Meta:
        verbose_name = '用户收藏'
        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中进行设置。

import os
import sys

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))

　　此刻项目的目录结构如下：