項目簡介

baykeShop（拜客商城系統(tǒng)）是一款全開源Python棧商城系統(tǒng)，管理后臺完全前后端分離重寫以適配項目，前后端100%開源，后臺前端采用開源SCUI開源庫對接開發(fā)，美觀、易用、符合當(dāng)前時下流行的技術(shù)棧，后端依托django強(qiáng)大的框架體系，深度結(jié)合rest_framework第三方包，使得前后端共用一套接口體系分發(fā)擴(kuò)展，商城PC端采用接口數(shù)據(jù)可視化的方式采用html渲染還原頁面，使其更符合web端的需求，更利于SEO優(yōu)化，擺脫了前后端分離所帶來的打包過程，以及上手難度，更易維護(hù)，開發(fā)，學(xué)習(xí)！

本項目融合了django的傳統(tǒng)模版體系，同時結(jié)合了前后端分離的開發(fā)方式，在不同場景選擇了不同的技術(shù)棧，使其更具學(xué)習(xí)和研究價值，是python django初學(xué)者開發(fā)上手學(xué)習(xí)的不二選擇！

項目演示

商城PC端前臺：http://s.bayke.shop商城管理后臺：http://s.bayke.shop/baykeadmin演示賬號：demo 密碼：123456

備注：前后臺用戶通用

快速上手

一、 拉取項目

將本倉庫拉取到本地，也就是當(dāng)前你看到的分支main

git clone https://gitee.com/bayke/bayke-shop.git

二、 創(chuàng)建虛擬環(huán)境

在項目根目錄中，也就是在manage.py的同級創(chuàng)建，命令如下：

python -m venv venv

運行該命令之后會創(chuàng)建一個venv的文件夾，此時虛擬環(huán)境則創(chuàng)建成功！

三、 激活虛擬環(huán)境，安裝依賴

3.1 激活虛擬環(huán)境：

# windows系統(tǒng)venvScriptsactivate# Liunx系統(tǒng)source venv/bin/activate

激活成功后在終端命令行最開始會出現(xiàn)（venv）則代表激活成功，注意，后邊所有的操作都是在激活虛擬環(huán)境的狀態(tài)下進(jìn)行的！

3.2 安裝項目依賴：

在安裝依賴之前有必要先對項目的配置有個簡單的了解。

項目目錄為bayke目錄，其中將配置文件拆分成了三部分：

1. settings.py為共用配置，也就是在開發(fā)環(huán)境和生產(chǎn)環(huán)境共同的配置項
2. development.py為開發(fā)環(huán)境配置，當(dāng)前的默認(rèn)配置
3. production.py為生產(chǎn)環(huán)境配置，部署上線時盡量啟用該配置（非必須）

備注：為了使用簡便，降低開發(fā)者理解難度，我們僅是通過引入包的方式 from .development import *將開發(fā)環(huán)境或生產(chǎn)環(huán)境配置引入到了settings.py中，也就是說你可以在開發(fā)時隨意引入他們兩個的任何一個，沒有局限，不同之處是production.py中啟用了mysql數(shù)據(jù)庫和redis，需要安裝對應(yīng)的依賴，已包含在依賴列表requirements.txt中!

由于mysql數(shù)據(jù)庫的依賴包mysqlclient在不同的環(huán)境下安裝時會常出現(xiàn)安裝失敗的現(xiàn)象，目前測試在windows和Ubuntu中都沒有問題，但在Centos系統(tǒng)中會出現(xiàn)莫名其妙的錯誤，導(dǎo)致安裝失敗，由于每個人出現(xiàn)的錯誤可能不一樣，沒有一個通用的行之有效的解決方案，目前暫時建議開發(fā)環(huán)境選擇windows或ubuntu其中一個，部署系統(tǒng)選擇Ubuntu即可！

如果不啟用mysql，則可以在requirements.txt中注釋掉mysqlclient依賴項之后再運行安裝命令！

安裝依賴：pip install -r requirements.txt

注意：當(dāng)啟用了mysql之后，需在根目錄的mysql.cnf配置中配置自己的數(shù)據(jù)庫信息！

[client]database = baykedbuser = rootpassword = 123456host = 127.0.0.1port = 3306default-character-set = utf8

四、初始化項目

4.1 同步數(shù)據(jù)庫并建表

python manage.py redb

該命令會清空新建app中應(yīng)用的遷移文件并重新生成，然后自動向數(shù)據(jù)庫執(zhí)行建表操作，也就是說他會自動執(zhí)行makemigrations和migrate命令！

5.1 導(dǎo)入初始化數(shù)據(jù)及權(quán)限接口數(shù)據(jù)

python manage.py pushdata

注意：與之對應(yīng)的有一個exportdata的導(dǎo)出命令，當(dāng)你改變了后臺的擴(kuò)展配置、后臺菜單、接口管理中的任何一項，則可以使用到處命令進(jìn)行備份，以便在別的地方部署時及時導(dǎo)入，這幾個數(shù)據(jù)是本項目運行的必要數(shù)據(jù)，所以必須要有?。ㄆ渌麛?shù)據(jù)備份的方式自行決定?。?/p>

五、創(chuàng)建超級管理員運行項目

5.1 創(chuàng)建超級管理員

python manage.py createsuperuser

5.2 運行項目后端

python manage.py runserver 3000

到這里項目的后端接口就已經(jīng)運行起來了，PC端商城也可以預(yù)覽了，但管理后臺采用了前后端分離的方式開發(fā)，需要再配置運行一下前端！

六、后臺前端運行

后臺前端源碼目錄在根目錄的fronted/scui中，標(biāo)準(zhǔn)的vue項目，選擇scui這個開源項目就是因為其上手簡單易使用組件眾多，便于開發(fā)，沒有使用TS，徒增心智負(fù)擔(dān)，對很多項目來說都是沒有必要的！

這里啟動和運行可以參考scui本身的文檔：https://lolicode.gitee.io/scui-doc/guide/

在這里再次感謝scui開源作者的辛苦付出！

注意：開發(fā)環(huán)境由于前端和后端不同域，會存在跨域問題，后端需要再配置文件的CORS_ALLOWED_ORIGINS和CSRF_TRUSTED_ORIGINS配置中放行前端地址！如下所示：

# 配置允許跨域訪問的站點列表CORS_ALLOWED_ORIGINS = [ 'http://192.168.31.174', 'http://127.0.0.1:2800']# csrf可信來源CSRF_TRUSTED_ORIGINS = [ 'http://192.168.31.174', 'http://127.0.0.1:2800']

支付寶支付配置

為了簡化支付寶的配置難度，本項目將支付寶的配置項內(nèi)置到了管理后臺系統(tǒng)設(shè)置的擴(kuò)展配置當(dāng)中,僅超級管理員擁有該權(quán)限！

如上圖所示，目前該配置僅允許超級管理員增刪改查，雖然內(nèi)置了刪除功能但最好不要刪除，擴(kuò)展配置均是代碼運行過程中需要調(diào)用的配置，作為開發(fā)者除非你非常清楚你知道某個配置項的作用以及調(diào)用位置，否則不建議刪除和修改配置項的key值！

• alipay_app_id 支付寶支付APPID
• alipay_private_key 支付寶支付私鑰pivate_key
• alipay_public_key 支付寶公鑰alipay_public_key

這里需要注意的是支付寶一般的配置流程是，下載官方的支付寶開放平臺秘鑰工具，首先生成秘鑰，此時就得到了應(yīng)用的公鑰和私鑰，然后用應(yīng)用公鑰去支付寶后臺加簽換取支付寶公鑰，將支付寶公鑰對應(yīng)的配置到后臺，應(yīng)用私鑰還要經(jīng)過一個步驟，就是需要將得到的應(yīng)用私鑰進(jìn)行一次格式轉(zhuǎn)換，在支付寶開放平臺秘鑰工具中操作，將轉(zhuǎn)換后的私鑰，配置到后臺對應(yīng)的私鑰項，配置APPID，支付寶配置即完成！

異步通知及同步通知不需要在支付寶后臺配置，代碼中已經(jīng)配置好了，支付完之后會自動跳轉(zhuǎn)和通知回調(diào)修改訂單狀態(tài)！

1. 生成應(yīng)用公鑰和私鑰

2. 用應(yīng)用公鑰加簽換取支付寶公鑰
3. 轉(zhuǎn)換應(yīng)用私鑰格式