02-model设计

时间 2019-11-19

标签 model 设计繁體版

原文原文链接

1、项目依赖包安装

一、安装Django(2.2.7)html

pip3 install django

二、安装DjangoRestFramework前端

由于DjangoRestFramework是基于Django开发的，所以安装以前必须安装Djangopython

pip3 install djangorestframework

三、安装markdown和django-filtermysql

pip3 install markdown django-filter

四、Pycharm建立项目git

　　更换虚拟环境，这样便于开发所安装特定的包，然而包环境都有特定的，便于管理。github

五、测试项目是否正常redis

　　必定要将MxShop下的urls.py中的文件中的admin注释掉，由于咱们没有注册admin因此必定会报错，说是没有定义admin，所以须要注释在运行。sql

测试成功，说明项目没出现问题，接下来开始整个项目最重要的一环啦，项目中的设置。数据库

六、settings.py中的数据库设置（第一个是默认的，第二个是配置的）django

# Database
# https://docs.djangoproject.com/en/2.2/ref/settings/#databases

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

# Database
# https://docs.djangoproject.com/en/2.2/ref/settings/#databases

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',#声明链接什么数据库
        'NAME': "mxshop",#数据库的名字
        'USER': 'root',#数据库用户名
        'PASSWORD': '',#数据库的密码，
        'HOST': '127.0.0.1',#数据库地址
        'PORT':'3306',#数据库端口
    }
}

而后来到虚拟环境配置相关包

七、安装pymysql进行相关配置

pip3 install pymysql

八、数据库建立

而后运行，发现有以下错误：

说的是mysqlclient版本不一致，直接往报错的一行点进去，找到报错的点，而后进去注释相关语句：（不要惧怕源码，源码都是咱们的工具，改动工具只是为了更好地造坦克）

改动完，运行试试，就能够发现完成啦，固然还有其余办法好比直接安装驱动mysqlclient(支持全部版本)，设置里面数据库配置，就能够愉快比这个更快完成

windows安装这些包都容易出错，所以能够找到前面一篇那个包错误网址，进去直接搜索找到对应版本的包手动下载安装。

九、安装图片处理包pillow

pip3 install -i https://pypi.douban.com/simple pillow

十、项目中创建须要的文件包或者文件夹

　　apps是将全部的应用拖到这下面，方便管理，extra_apps是将一些不想安装到虚拟环境的包，下载源码放到这里面，这样便于咱们修改源码，打造咱们想要的状况。media文件夹是保存上传的一些文件。

十一、项目设置里面设置识别路径

添加这两行代码：#将apps，extra_apps加入到路径中来，以便撰写代码方便

import sys

sys.path.insert(0,BASE_DIR)
sys.path.insert(0,os.path.join(BASE_DIR,"apps"))
sys.path.insert(0,os.path.join(BASE_DIR,"extra_apps"))

2、app应用模型设计

一、建立应用

　　根据前端显示的页面，分析出须要设计的app应用，而后建立应用

二、在项目settings.py注册应用

# Application definition

INSTALLED_APPS = [
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users.apps.UsersConfig',
    'users', #将咱们建立的app注册到这里面来 'goods',
    'trade',
    'user_operation',
]

3、模型类设计

一、应用users模型类设计(编写代码须要遵循PEP8规范)

　　咱们须要从新设计用户的模型类，Django自带的模型类不能知足咱们的要求，所以从新继承django.contrib.auth.models.AbstractUser这个类，新增长咱们须要的新字段。

users.models.py:

from django.contrib.auth.models import AbstractUser

# Create your models here.


class UserProfile(AbstractUser):
    """
    用户信息相关
    """
    name = models.CharField(max_length=30,null=True,blank=True,verbose_name="姓名")
    birthday = models.DateField(null=True,blank=True,verbose_name="出生年月")
    gender = models.CharField(max_length=6,choices=(("male","男"),("female","女")),default="female",verbose_name="性别")
    mobile = models.CharField(max_length=11,verbose_name="电话")
    email = models.EmailField(max_length=100,null=True,blank=True,verbose_name="邮箱")

    class Meta:
        verbose_name = "用户"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name

　　通过分析，会发现与用户相关的验证码，也须要保存到用户这里，固然能够保存到redis里更佳，为了积累项目的流程，增长本身对项目的理解，须要将验证码保存到数据库，以便于对整个项目开发有更深的理解。

users.models.py

from datetime import datetime


class VerifyCode(models.Model):
    """
    短信验证码
    """
    code = models.CharField(max_length=10,verbose_name="验证码")
    mobile = models.CharField(max_length=11, verbose_name="电话")
    #不用括号是模型类调用的时间，然而加括号是模型类迁移的时间
    add_time = models.DateTimeField(default=datetime.now,verbose_name="添加时间")

    class Meta:
        verbose_name = "短信验证码"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.code

UserProfile设计完成以后，没有替换系统的用户，所以咱们须要到项目settings.py中去添加下面这一行：

AUTH_USER_MODEL = "users.UserProfile"

二、应用goods的模型类设计（PEP8规范）

经过一个模型类完成商品的级别分类，

goods.models.py：

from datetime import datetime


from django.db import models
from DjangoUeditor.models import UEditorField

# Create your models here.


class GoodsCategory(models.Model):
    """
    商品类别（好比生鲜食品<----海鲜水产<---鱼）
    这样就能够将全部商品放到一个表中
    """
    CATEGORY_TYPE = (
        (1,"一级类目"),
        (2,"二级类目"),
        (3,"三级类目")
    )
    #help_text之后文档有用，related_name之后查询有用
    name = models.CharField(default="",max_length=30,verbose_name="类别名",help_text="类别名")
    #查找商品可能用英文查找，加此字段为了之后查找方便
    code = models.CharField(default="",max_length=30,verbose_name="类别code",help_text="类别code")
    desc = models.TextField(default="",verbose_name="类别描述",help_text="类别描述")
    category_type = models.CharField(choices=CATEGORY_TYPE,verbose_name="类目级别",help_text="类目级别")
    parent_category = models.ForeignKey("self",null=True,blank=True,verbose_name="父类目级别",related_name="sub_cat",help_text="父目录")
    is_tab = models.BooleanField(default=False,verbose_name="是否导航",help_text="是否导航")
    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = "商品类别"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name


class GoodsCategoryBrand(models.Model):
    """
    品牌名
    """
    name = models.CharField(default="",max_length=30,verbose_name="品牌名",help_text="品牌名")
    desc = models.TextField(default="",max_length=200,verbose_name="品牌描述",help_text="品牌描述")
    image = models.ImageField(max_length=200,upload_to="brand/images/")
    add_time = models.DateTimeField(default=datetime.now,verbose_name="添加时间")

    class Meta:
        verbose_name = "品牌"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name


class Goods(models.Model):
    """
    商品
    """
    category = models.ForeignKey(GoodsCategory, verbose_name="商品类目")
    goods_sn = models.CharField(max_length=50, default="", verbose_name="商品惟一货号")
    name = models.CharField(max_length=100, verbose_name="商品名")
    click_num = models.IntegerField(default=0, verbose_name="点击数")
    sold_num = models.IntegerField(default=0, verbose_name="商品销售量")
    fav_num = models.IntegerField(default=0, verbose_name="收藏数")
    goods_num = models.IntegerField(default=0, verbose_name="库存数")
    market_price = models.FloatField(default=0, verbose_name="市场价格")
    shop_price = models.FloatField(default=0, verbose_name="本店价格")
    goods_brief = models.TextField(max_length=500, verbose_name="商品简短描述")
    goods_desc = UEditorField(verbose_name=u"内容", imagePath="goods/images/", width=1000, height=300,
                              filePath="goods/files/", default='')
    ship_free = models.BooleanField(default=True, verbose_name="是否承担运费")
    goods_front_image = models.ImageField(upload_to="goods/images/", null=True, blank=True, verbose_name="封面图")
    is_new = models.BooleanField(default=False, verbose_name="是否新品")
    is_hot = models.BooleanField(default=False, verbose_name="是否热销")
    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = '商品'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name


class Banner(models.Model):
    """
    轮播的商品
    """
    goods = models.ForeignKey(Goods, verbose_name="商品")
    image = models.ImageField(upload_to='banner', verbose_name="轮播图片")
    index = models.IntegerField(default=0, verbose_name="轮播顺序")
    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = '轮播商品'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.goods.name


class GoodsImage(models.Model):
    """
    商品轮播图
    """
    goods = models.ForeignKey(Goods, verbose_name="商品", related_name="images")
    image = models.ImageField(upload_to="", verbose_name="图片", null=True, blank=True)
    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = '商品图片'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.goods.name

goods.models.py

代码里面的DjangoUeditor是富文本编辑器，是基于Django编写的，所以去github上找到py3支持的版本，下载源码，复制到extra_apps

而后去到项目设置settings.py中注册extra_apps中的DjangoUeditor

三、应用trade的模型类设计（PEP8规范）

from datetime import datetime

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

from goods.models import Goods
#这里调用UserProfile直接调用django的配置方法，返回值就是UserProfile模型，
#这样的好处就是，不用知道用户模型类也能够调用
User = get_user_model()
# Create your models here.


class ShoppingCart(models.Model):
    """
    购物车
    """
    user = models.ForeignKey(User, verbose_name=u"用户")
    goods = models.ForeignKey(Goods, verbose_name=u"商品")
    nums = models.IntegerField(default=0, verbose_name="购买数量")

    add_time = models.DateTimeField(default=datetime.now, verbose_name=u"添加时间")

    class Meta:
        verbose_name = '购物车'
        verbose_name_plural = verbose_name
        unique_together = ("user", "goods")

    def __str__(self):
        return "%s(%d)".format(self.goods.name, self.nums)


class OrderInfo(models.Model):
    """
    订单
    """
    ORDER_STATUS = (
        ("TRADE_SUCCESS", "成功"),
        ("TRADE_CLOSED", "超时关闭"),
        ("WAIT_BUYER_PAY", "交易建立"),
        ("TRADE_FINISHED", "交易结束"),
        ("paying", "待支付"),
    )

    user = models.ForeignKey(User, verbose_name="用户")
    order_sn = models.CharField(max_length=30, null=True, blank=True, unique=True, verbose_name="订单号")
    trade_no = models.CharField(max_length=100, unique=True, null=True, blank=True, verbose_name=u"交易号")
    pay_status = models.CharField(choices=ORDER_STATUS, default="paying", max_length=30, verbose_name="订单状态")
    post_script = models.CharField(max_length=200, verbose_name="订单留言")
    order_mount = models.FloatField(default=0.0, verbose_name="订单金额")
    pay_time = models.DateTimeField(null=True, blank=True, verbose_name="支付时间")

    # 用户信息
    address = models.CharField(max_length=100, default="", verbose_name="收货地址")
    signer_name = models.CharField(max_length=20, default="", verbose_name="签收人")
    singer_mobile = models.CharField(max_length=11, verbose_name="联系电话")

    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = u"订单"
        verbose_name_plural = verbose_name

    def __str__(self):
        return str(self.order_sn)


class OrderGoods(models.Model):
    """
    订单的商品详情
    """
    order = models.ForeignKey(OrderInfo, verbose_name="订单信息", related_name="goods")
    goods = models.ForeignKey(Goods, verbose_name="商品")
    goods_num = models.IntegerField(default=0, verbose_name="商品数量")

    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = "订单商品"
        verbose_name_plural = verbose_name

    def __str__(self):
        return str(self.order.order_sn)

trade.models.py

四、用户操做models.py设计

from datetime import datetime

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

from goods.models import Goods
# Create your models here.
User = get_user_model()


class UserFav(models.Model):
    """
    用户收藏
    """
    user = models.ForeignKey(User, verbose_name="用户")
    goods = models.ForeignKey(Goods, verbose_name="商品", help_text="商品id")
    add_time = models.DateTimeField(default=datetime.now, verbose_name=u"添加时间")

    class Meta:
        verbose_name = '用户收藏'
        verbose_name_plural = verbose_name
        unique_together = ("user", "goods")

    def __str__(self):
        return self.user.username


class UserLeavingMessage(models.Model):
    """
    用户留言
    """
    MESSAGE_CHOICES = (
        (1, "留言"),
        (2, "投诉"),
        (3, "询问"),
        (4, "售后"),
        (5, "求购")
    )
    user = models.ForeignKey(User, verbose_name="用户")
    message_type = models.IntegerField(default=1, choices=MESSAGE_CHOICES, verbose_name="留言类型",
                                      help_text=u"留言类型: 1(留言),2(投诉),3(询问),4(售后),5(求购)")
    subject = models.CharField(max_length=100, default="", verbose_name="主题")
    message = models.TextField(default="", verbose_name="留言内容", help_text="留言内容")
    file = models.FileField(upload_to="message/images/", verbose_name="上传的文件", help_text="上传的文件")
    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = "用户留言"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.subject


class UserAddress(models.Model):
    """
    用户收货地址
    """
    user = models.ForeignKey(User, verbose_name="用户" )
    province = models.CharField(max_length=100, default="", verbose_name="省份")
    city = models.CharField(max_length=100, default="", verbose_name="城市")
    district = models.CharField(max_length=100, default="", verbose_name="区域")
    address = models.CharField(max_length=100, default="", verbose_name="详细地址")
    signer_name = models.CharField(max_length=100, default="", verbose_name="签收人")
    signer_mobile = models.CharField(max_length=11, default="", verbose_name="电话")
    add_time = models.DateTimeField(default=datetime.now, verbose_name="添加时间")

    class Meta:
        verbose_name = "收货地址"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.address

user_operation.models.py

4、数据表迁移

一、数据表迁移makemigrations与migrate

　　将Django模型类中的数据库迁移生成数据表，是大大简化咱们对数据库的操做，节约大量时间，这样开发效率大大提高，当使用makemigrations的时候，所有应用app下面会出现一个文件001-初始化文件，同时，在数据库中的django-migration表中会有相应app的记录，所以若是迁移表数据库会出现对应app的两条记录，所以了解原理，之后迁移数据的时候，能够删除初始化文件001，或者删除数据库，第二次必须使用migrate才会讲对应的模型类转化为数据表，

下面这个错误是在Django2.0之后，在外键关系和一对一关系的时候，必须加上参数on_delete的值。

5、Xadmin后台管理系统的配置

　　由于作项目就是为了磨炼不一样的技术，重复性的工做就不用再作，前面项目都作过先后端不分离项目，慕学在线网项目，所以利用Xadmin打造后台管理系统直接能够将配置好的复制进来，若是想要直接这个项目就作的话，那么能够本身去github上学习Xadmin的相关配置以及操做。

　　将配置好的Xadmin插件复制到extra_apps，而后将每一个应用下面的adminx.py文件复制到特定的应用下面，adminx的做用也是将模型类注册到后台管理系统中操做。

完成以上操做那么继续下面的操做

一、项目设置中配置xadmin

# Application definition   注册xadmin

INSTALLED_APPS = [
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users.apps.UsersConfig',
    'goods',
    'trade',
    'user_operation',
    'DjangoUeditor',
    'xadmin',
    'crispy_forms',#这个是xadmin须要使用的
]

二、安装xadmin的依赖包

　　去github上搜索xadmin,而后找到依赖包。

　　在虚拟环境中，安装全部的依赖包。

pip3 install django-crispy-forms django-import-export django-reversion django-formtools future httplib2 six

在安装两个包，是帮助咱们作excel文件的：

pip3 install xlwt xlsxwriter

安装完成后，须要迁移Xadmin的数据表

而后会发现，因为Xadmin跟不上Django的版本节奏，所以将Xadmin中的源码改动，下面这个博客错误记录很全：

https://www.cnblogs.com/xingfuggz/p/10142388.html

完成以后，运行去数据库库查看一下，添加完成。接下来须要给xadmin注册访问路径。

三、注册Xadmin路由（Mxshop/ulrs.py）

from django.urls import path
import xadmin
urlpatterns = [
    path('xadmin/', xadmin.site.urls),
]

注册完xadmin以后，咱们应该建立咱们的超级管理员，去检验咱们的xadmin是否生效。

四、建立超级管理员

python manage.py createsuperuser

建立以后来到项目设置里面（settings.py）将时区换为亚洲上海的。

设置好后启动，能够运行，记住xadmin必须和Django匹配，不然会出现版本不相容的问题，github上有不少人对Xadmin进行修改，适合用于Django2.0之后的版本，

而后再将这个注册到设置里面启动访问，而后发现成功

进去所有都点一下，试试会不会出错，而后发现报错

直接点进去，根据报错信息，说render函数获得一个错误的参数，将93行注释掉，这样就能够启动啦