# baykeShop

**Repository Path**: yuanjian_code/bayke-shop

## Basic Information

- **Project Name**: baykeShop
- **Description**: Python栈开源商城系统，采用django框架开发，使用简单，支持商品多规格配置，支持余额支付、支付宝支付以及微信支付！
对django-admin进行了简单的二次开发定制， 支持自定义动态菜单，兼容django原生admin以及三方皮肤simpleui！
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: http://www.bayke.shop/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 38
- **Created**: 2024-09-02
- **Last Updated**: 2024-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BaykeShop（拜客商城系统）

For full documentation visit [bayke.shop（拜客商城系统）](http://www.bayke.shop).

## 项目简介
baykeshop（拜客商城系统）是一款全开源Python栈商城系统，采用最新版django4以上版本开发，代码精炼简洁易于学习及二次开发。

### 分支介绍
- 项目主要分为两个分支即【主分支(默认分支)】和【djangocbv】分支。

- 主分支主要是以接口为主，也就是所有的视图逻辑采用Django REST framework框架完成，采用了[TemplateHTMLRenderer, JSONRenderer]的双渲染模式，也就是默认的PC站点直接将接口数据通过TemplateHTMLRenderer渲染器可视化，其json数据可以在url后加参数format=json进行预览，支持JWT登录认证，该分支则适合有二次开发需求的同学，以及前后端分离项目！

- djangocbv分支则纯粹已原生django实现，不支持JWT认证方式，该分支非常符合初学django框架的同学参考学习以及普通的企业站建站使用非常方便！

### 项目特色

更符合国人使用和学习的Python django开源商城项目，没有复杂的语法和过渡的封装，一切符合django的使用方式！

1、后台定制默认admin,支持动态菜单，兼容三方皮肤（如：django-simpleui）

2、完整的多规格商品逻辑，支持商品SPU和SKU及规格关系

3、支持余额支付、微信支付（开发中）、支付宝支付，配置简单收款便捷

4、凭借django强大的加持，可轻松配置多数据库Mysql/Sqlite3等

5、独立配置文件，通过简单的配置修改可控制全局相关功能

6、主分支PC端采用DRF的模板渲染器对接口可视化，开放了标准的RestFull api接口【 **接口文档请在文末查看获取** 】

## 演示
- [演示地址-demo.bayke.shop](http://demo.bayke.shop)
> 如有更深层次使用需求，请按照快速上手拉取到本地测试，快速上手为主分支创建说明！

## 快速上手

### 1、克隆项目源码
```
git clone https://gitee.com/bayke/bayke-shop.git
```
### 2、创建虚拟环境
```
cd bayke-shop
python3 -m venv venv
```
### 3、激活虚拟环境
```
Windows: venv\Scripts\activate
Liunx: source venv/bin/activate
```
### 4、安装依赖
```
pip install -r requirements.txt
```
### 5、配置Mysql数据库

> 项目默认配置了Mysql数据库和redis缓存，需要你自行在运行项目前，配置安装好Mysql数据库及redis！

- 配置Mysql数据库
项目根目录有个mysql.cnf的文件，修改其中的数据库信息为你自己的！
```
[client]
database = baykedb  # 数据库名
user = root         # 用户名
password = 123456   # 用户密码
host = 127.0.0.1
port = 3306
default-character-set = utf8
```
- redis默认无密码，你也不要配置密码，如果非要配置请在`bayke/settings.py`中的redis配置修改
```
CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.redis.RedisCache',
        'LOCATION': 'redis://127.0.0.1:6379',
    }
}
```
------------------------------------------------------------------
#### 小白救命招
>不使用mysql及redis也可以（不建议），高手可略过....

将`bayke/settings.py`中的mysql及redis配置改为sqlit3和内存缓存

- 修改Mysql为sqlite3
```python
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}
```
- 注释掉这段，默认则为内存缓存
```python
CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.redis.RedisCache',
        'LOCATION': 'redis://127.0.0.1:6379',
    }
}
```
------------------------------------------------------------------

### 6、同步数据库
```bash
python manage.py makemigrations
python manage.py migrate
```
### 7、创建超级管理员
```python
python manage.py createsuperuser

# 输出格式如下
# 用户名 (leave blank to use 'qbc'): admin
# 电子邮件地址: admin@qq.com
# Password: 
# Password (again): 
# Superuser created successfully.
```
### 8、初始化项目
```python
# 创建后台自定义菜单
python manage.py create_menu

# 如需要生成演示数据，运行以下命令
python manage.py create_test
```

### 9、运行项目
```
python3 manage.py runserver
```
### 10、查看项目
```
前台：http://127.0.0.1:8000
后台：http://127.0.0.1:8000/baykeadmin/

后台账号及密码是你在第五步创建的！
```

### 11、支付宝配置

虽然你可以通过修改baykeshop/conf/defaults.py中的默认配置来控制全局相关设置，但我不建议你这么做，这个配置文件作为默认选项的回退，尽量不要去修改，而是在项目bayke目录下的settings.py中覆盖默认项配置！
```python
# bayke/settings.py

BAYKE_SHOP = {
    "ALIPAY_PRIVATE_KEY": "应用私钥pem路径",
    "ALIPAY_PUBLIC_KEY": "支付宝公钥pem路径",
    "ALIPAY_APPID": "支付宝APPID",
    "ALIPAY_SIGN_TYPE": "加密方式，默认是RSA2",
}
```
以上就是配置支付宝收款你需要做的全部工作！


### 赞赏支持

>  **说明：** 如果本项目给您带来了一些帮助和收获，并且在您条件允许的情况下，我需要您的支持，您的一份支持才能让项目有一个良性的发展，以下是我给您赞赏一点点回报！

 **1、凡赞赏金额大于25元即可加入本项目交流群，纯净技术交流，无广告！** 

 **2、可以获取到apifox在线版接口文档以及离线版markdown接口文档！** 

 **3、作者群内互动，解答使用者在开发过程中的一些问题及技术交流！** 

 **4、凡赞赏金额大于50元，除拥有以上福利之外，将获得作者私下处理本项目问题一次并且将获得项目后期新增移动端前端源码！**  

![输入图片说明](media/wx.jpg)

赞赏留言请备注微信号，作者将第一时间添加发送相关资料及拉群！

![输入图片说明](media/19145308.png)