# meiduo_project

**Repository Path**: buffaloboy/meiduo_project

## Basic Information

- **Project Name**: meiduo_project
- **Description**: python-项目实战-黑马
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-06-18
- **Last Updated**: 2024-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[toc]



# 课程资料

## 美多商城xmind

![image-20210815095021273](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155702994-893583327.png)





# 1 项目准备



## 1.1 开发流程介绍



![image-20210815102721345](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155704224-1072999554.png)

![image-20210815101137981](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155704490-260829530.png)

## 1.2 项目介绍



### 1.2.1 项目需求分析

> 需求分析原因：
>
> - 可以整体的了解项目的业务流程和主要的业务需求。
> - 项目中，**需求驱动开发**。即开发人员需要以需求为目标来实现业务逻辑。
>
> 需求分析方式：
>
> - 企业中，借助 **产品原型图** 分析需求。
> - 需求分析完后，前端按照产品原型图开发前端页面，**后端开发对应的业务及响应处理**。
>
> 需求分析内容：
>
> - 页面及其**业务流程和业务逻辑**。
>
> 提示：
>
> - 我们现在借助 **示例网站** 作为原型图来分析需求。

#### 1. 项目主要页面介绍

**1.首页广告**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155705163-895037394.png)

**2.注册**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155705644-1851514863.png)

**3.登录**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155706346-388104481.png)

**4.QQ登录**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155706796-34400884.png)

**5.个人信息**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155707488-951803854.png)

**6.收货地址**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155707892-1100003528.png)

**7.我的订单**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155708750-846467179.png)

**8.修改密码**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155709164-643484997.png)

**9.商品列表**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155709807-1358072931.png)

**10.商品搜索**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155710336-386746233.png)

**11.商品详情**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155711121-1407548953.png)

**12.购物车**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155711561-1787662265.png)

**13.结算订单**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155712112-270526286.png)

**14.提交订单**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155712494-1501446808.png)

**15.支付宝支付**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155712951-88103058.png)

**16.支付结果处理**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155713314-1556981795.png)

**17.订单商品评价**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155713720-1576279201.png)

#### 2. 归纳项目主要模块

> 为了方便项目管理及多人协同开发，我们根据需求将功能划分为不同的模块。
>
> 将来在项目中，每个**`模块`**都会对应一个**`子应用`**进行**`管理和解耦`**。

| 模块           | 功能                                             |
| -------------- | ------------------------------------------------ |
| **验证**       | 图形验证、短信验证                               |
| **用户**       | 注册、登录、用户中心                             |
| **第三方登录** | QQ登录                                           |
| **首页广告**   | 首页广告                                         |
| **商品**       | 商品列表、商品搜索、商品详情                     |
| **购物车**     | 购物车管理、购物车合并                           |
| **订单**       | 确认订单、提交订单                               |
| **支付**       | 支付宝支付、订单商品评价                         |
| **MIS系统**    | 数据统计、用户管理、权限管理、商品管理、订单管理 |

#### 3. 知识要点

1. 需求分析原因：需求驱动开发。
2. 需求分析方式：企业中，使用产品原型图。
3. 需求分析内容：页面及业务逻辑。
4. 需求分析结果：划分业务模块，明确每个模块下的主要功能，并以子应用的形式进行管理。



### 1.1.2 项目架构设计

#### 1. 项目开发模式

| 选项         | 技术选型                |
| ------------ | ----------------------- |
| **开发模式** | 前后端不分离            |
| **后端框架** | Django + Jinja2模板引擎 |
| **前端框架** | Vue.js                  |

> 说明：
>
> - 前后端不分离的开发模式，是为了提高搜索引擎排名，即**SEO**。特别是首页，详情页和列表页。
> - 页面需要整体刷新：我们会选择使用Jinja2模板引擎来实现。
> - 页面需要局部刷新：我们会选择使用Vue.js来实现。

#### 2. 项目运行机制

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155714058-747817624.png)

#### 3. 知识要点

1. 项目开发模式
   - 前后端不分离，方便**SEO**。
   - 采用Django + Jinja2模板引擎 + Vue.js实现前后端逻辑。
2. 项目运行机制
   - 代理服务：Nginx服务器（反向代理）
   - 静态服务：Nginx服务器（静态首页、商品详情页、...）
   - 动态服务：uwsgi服务器（美多商场业务场景）
   - 后端服务：MySQL、Redis、Celery、RabbitMQ、Docker、FastDFS、Elasticsearch、Crontab
   - 外部接口：容联云、QQ互联、支付宝



## 1.3 工程创建和配置

### 1.3.1 创建工程

> 美多商城项目源代码采用**`远程仓库托管`**。

#### 1. 准备项目代码仓库

> **1.源码托管网站**

- 码云（https://gitee.com/）

> **2.创建源码远程仓库：meiduo_project**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155714526-1588691207.png)

#### 2. 克隆项目代码仓库

> **1.进入本地项目目录**

```bash
$ mkdir ~/projects
$ cd projects/
```

> **2.克隆仓库**

```bash
$ git clone https://gitee.com/zjsharp/meiduo_project.git
```

> 3.忽略.idea

![image-20210815112233578](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155714759-561128510.png)

#### 3. 创建美多商城工程

> **1.进入本地项目仓库**

```bash
$ cd ~/projects/meiduo_project/
```

> **2.创建美多商城虚拟环境，安装Django框架**

```bash
$ mkvirtualenv -p python3.6 meiduo_mall
$ pip install django==1.11.11
```

> **3.创建美多商城Django工程**

```bash
$ django-admin startproject meiduo_mall
```

> 创建工程完成后：运行程序，测试结果。

```bash
django-admin manage.py runserver
```

![image-20210815120415611](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155715057-1620471864.png)

#### 4.美多商城第三方包

> 视频截图

![image-20210815115644653](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155715688-748887619.png)

> Ubuntu项目环境

```bash
(meiduo_project) gaotianhao@gaotianhao-virtual-machine:~/Desktop/temp/42/projects/meiduo_project/meiduo_mall$ pip list 
Package            Version
------------------ ----------
amqp               2.6.1
appnope            0.1.0
backcall           0.1.0
billiard           3.5.0.5
celery             4.2.1
certifi            2018.11.29
chardet            3.0.4
decorator          4.3.2
Django             1.11.11
django-crontab     0.7.1
django-redis       4.10.0
importlib-metadata 4.6.4
Jinja2             2.10
kombu              4.6.11
MarkupSafe         2.0.1
pip                21.1.2
PyMySQL            0.9.3
pytz               2021.1
redis              3.0.1
setuptools         57.0.0
typing-extensions  3.10.0.0
vine               1.3.0
wheel              0.36.2
zipp               3.5.0

```





### 1.3.2 配置开发环境

> 美多商城项目的环境分为**`开发环境`**和**`生产环境`**。
>
> - 开发环境：用于编写和调试项目代码。
> - 生产环境：用于项目线上部署运行。

#### 1. 新建配置文件

1. 准备配置文件目录
   - 新建包，命名为settings，作为配置文件目录
2. 准备开发和生产环境配置文件
   - 在配置包settings中，新建开发和生产环境配置文件
3. 准备开发环境配置内容
   - 将默认的配置文件settings.py中内容拷贝至dev.py

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155716133-489493561.png)

#### 2. 指定开发环境配置文件

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155716498-1229816474.png)

> 配置完成后：运行程序，测试结果。



### 1.3.3 配置Jinja2模板引擎

> 美多商城的模板采用**`Jinja2模板引擎`**。

#### 1. 安装Jinja2扩展包

```bash
pip install Jinja2
```

#### 2. 配置Jinja2模板引擎

```python
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # jinja2模板引擎
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]
```

#### 3. 补充Jinja2模板引擎环境

> **1.创建Jinja2模板引擎环境配置文件**

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155716906-926264626.png)

> **2.编写Jinja2模板引擎环境配置代码**

```python
from jinja2 import Environment
from django.urls import reverse
from django.contrib.staticfiles.storage import staticfiles_storage


def jinja2_environment(**options):
    """jinja2环境"""

    # 创建环境对象
    env = Environment(**options)

    # 自定义语法：{{ static('静态文件相对路径') }} {{ url('路由的命名空间') }}
    env.globals.update({
        'static': staticfiles_storage.url, # 获取静态文件的前缀
        'url': reverse, # 反向解析
    })

    # 返回环境对象
    return env
"""
确保可以使用模板引擎中的{{ static('') }}、{{  url('')  }} 这类语句
"""
```

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155717198-79776549.png)

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155717445-1254479080.png)

> **3.加载Jinja2模板引擎环境**

```python
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.jinja2.Jinja2',  # jinja2模板引擎
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
            # 补充Jinja2模板引擎环境
            'environment': 'meiduo_mall.utils.jinja2_env.jinja2_environment', 
        },
    },
]
```

> 配置完成后：运行程序，测试结果。



### 1.3.4 配置MySQL数据库

> 美多商城数据存储服务采用**`MySQL数据库`**。

#### 1. 新建MySQL数据库

> **1.新建MySQL数据库：meiduo_mall**

```bash
create database meiduo charset=utf8;
```

> **2.新建MySQL用户**

```bash
create user itheima identified by '123456';
```

> **3.授权`itcast`用户访问`meiduo_mall`数据库**

```bash
grant all on meiduo.* to 'itheima'@'%';
```

> **4.授权结束后刷新特权**

```bash
flush privileges;
```

#### 2. 配置MySQL数据库

```python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', # 数据库引擎
        'HOST': '127.0.0.1', # 数据库主机
        'PORT': 3306, # 数据库端口
        'USER': 'itheima', # 数据库用户名
        'PASSWORD': '123456', # 数据库用户密码
        'NAME': 'meiduo' # 数据库名字
    },
}
```

> 可能出现的错误
>
> - Error loading MySQLdb module: No module named 'MySQLdb'.
>
> 出现错误的原因：
>
> - Django中操作MySQL数据库需要驱动程序MySQLdb
> - 目前项目虚拟环境中没有驱动程序MySQLdb
>
> 解决办法：
>
> - 安装PyMySQL扩展包
> - 因为MySQLdb只适用于Python2.x的版本，Python3.x的版本中使用PyMySQL替代MySQLdb

#### 3. 安装PyMySQL扩展包

> **1.安装驱动程序**

```bash
pip install PyMySQL
```

> **2.在工程同名子目录的`__init__.py`文件中，添加如下代码：**

```python
from pymysql import install_as_MySQLdb

install_as_MySQLdb()
```

> 配置完成后：运行程序，测试结果。



### 1.3.5 配置Redis数据库

> 美多商城数据缓存服务采用**`Redis数据库`**。

#### 1. 安装django-redis扩展包

> **1.安装django-redis扩展包**

```bash
pip install django-redis
```

> **2.django-redis使用说明文档**

[点击进入文档](https://django-redis-chs.readthedocs.io/zh_CN/latest/)

#### 2. 配置Redis数据库

```python
CACHES = {
    "default": { # 默认
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
    "session": { # session
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/1",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
}
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
SESSION_CACHE_ALIAS = "session"
```

> default：
>
> - 默认的Redis配置项，采用0号Redis库。
>
> session：
>
> - 状态保持的Redis配置项，采用1号Redis库。
>
> SESSION_ENGINE
>
> - 修改`session存储机制`使用Redis保存。
>
> SESSION_CACHE_ALIAS：
>
> - 使用名为"session"的Redis配置项存储`session数据`。
>
> 配置完成后：运行程序，测试结果。



### 1.3.6 配置工程日志

> 美多商城的日志记录采用`logging模块`。



#### 1. 配置工程日志

```python
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,  # 是否禁用已经存在的日志器
    'formatters': {  # 日志信息显示的格式
        'verbose': {
            'format': '%(levelname)s %(asctime)s %(module)s %(lineno)d %(message)s'
        },
        'simple': {
            'format': '%(levelname)s %(module)s %(lineno)d %(message)s'
        },
    },
    'filters': {  # 对日志进行过滤
        'require_debug_true': {  # django在debug模式下才输出日志
            '()': 'django.utils.log.RequireDebugTrue',
        },
    },
    'handlers': {  # 日志处理方法
        'console': {  # 向终端中输出日志
            'level': 'INFO',
            'filters': ['require_debug_true'],
            'class': 'logging.StreamHandler',
            'formatter': 'simple'
        },
        'file': {  # 向文件中输出日志
            'level': 'INFO',
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': os.path.join(os.path.dirname(BASE_DIR), 'logs/meiduo.log'),  # 日志文件的位置
            'maxBytes': 300 * 1024 * 1024,
            'backupCount': 10,
            'formatter': 'verbose'
        },
    },
    'loggers': {  # 日志器
        'django': {  # 定义了一个名为django的日志器
            'handlers': ['console', 'file'],  # 可以同时向终端与文件中输出日志
            'propagate': True,  # 是否继续传递日志信息
            'level': 'INFO',  # 日志器接收的最低日志级别
        },
    }
}
```

#### 2. 准备日志文件目录

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155717682-285576440.png)

#### 3. 日志记录器的使用

```python
import logging

# 创建日志记录器
logger = logging.getLogger('django')
# 输出日志
logger.debug('测试logging模块debug')
logger.info('测试logging模块info')
logger.error('测试logging模块error')
```

#### 4. Git管理工程日志

> 提示1：
>
> - 开发过程中，产生的日志信息不需要代码仓库进行管理和记录。

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155717953-149712548.png)

> 提示2：
>
> - 建立代码仓库时，生成的忽略文件中已经默认忽略掉了 ***.log** 。

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155718194-786978559.png)

> 问题：
>
> - logs文件目录需求被Git仓库记录和管理。
> - 当把 `*.log` 都忽略掉后，logs文件目录为空。
> - 但是，Git是不允许提交一个空的目录到版本库上的。
>
> 解决：
>
> - 在空文件目录中建立一个 **.gitkeep** 文件，然后即可提交。



![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155718437-1791907463.png)

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155718780-413009808.png)

> 配置完成后：运行程序，测试结果。

#### 5. 知识要点

1. 本项目最低日志等级设置为：**INFO**

2. 创建日志记录器的方式：

   ```python
   logger = logging.getLogger('django')
   ```

3. 日志记录器的使用：

   ```python
   logger.info('测试logging模块info')
   ```

4. 在日志`loggers`选项中可以指定多个日志记录器



### 1.3.7 配置前端静态文件

> 美多商城项目中需要使用静态文件，比如 css、images、js 等等。

#### 1. 准备静态文件

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155719034-231195029.png)

![img](https://img2020.cnblogs.com/blog/1425675/202108/1425675-20210815155719272-1395988494.png)

#### 2. 指定静态文件加载路径

```python
STATIC_URL = '/static/'

# 配置静态文件加载路径
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
```

配置完成后：运行程序，测试结果。

- http://127.0.0.1:8000/static/images/adv01.jpg