# dsshop

**Repository Path**: chew/dsshop

## Basic Information

- **Project Name**: dsshop
- **Description**: vue2.0+Laravel7商城电商平台，完全前后端分离，免费开源可商用，暂时支持H5、微信小程序，后期将支持APP、其它小程序。H5商城电商平台，微信小程序商城电商平台
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://dspurl.github.io/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 36
- **Created**: 2021-04-30
- **Last Updated**: 2021-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="https://dspurl.github.io/image/dsshop_logo.jpg" width="150">
</p>
<p align="center">
  <a href="https://github.com/laravel/framework">
    <img src="https://img.shields.io/badge/laravel-7.30.4-brightgreen.svg" alt="laravel">
  </a>
  <a href="https://github.com/vuejs/vue">
    <img src="https://img.shields.io/badge/vue-2.5.17-brightgreen.svg" alt="vue">
  </a>
  <a href="https://github.com/ElemeFE/element">
    <img src="https://img.shields.io/badge/element--ui-2.13.2-brightgreen.svg" alt="element-ui">
  </a>
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg">
</p>
<h3 align="center">DSSHOP电商商城</h3>
<p align="center">前后端分离架构，VUE2.0+Laravel7，免费开源可商用。</p>

说明
------------
<p>如果因网络原因无法下载，可通过<a href="https://gitee.com/dswjcms/dsshop">https://gitee.com/dswjcms/dsshop</a>下载</p>
<p>因版本更新迭代比较快，文档可能存在没有涉及的面，请自行阅读源码</p>
<p>已验证版本(经测试后可以正常安装的版本):2.1.0.1</p>
<p>当前版本2.1.0.1</p>

介绍
------------
DSSHOP是一套多终端商城解决方案，它采用前后端分离，后端基于laravel,前端基于Vue。

我们不生成代码，我们只是代码的搬运工，60%的复制粘贴，30%的思考，10%的代码量。

> 本项目定位：入门简单，无需一行代码；深入需要多人协同完成，亦可全栈实现。
>
> 本项目涉及前后端代码，深入会需要掌握VUE、JS、HTML、H5、Laravel、小程序、uni-app
>
> 本项目适合各阶段人群：学生、培训机构、创业公司、外包公司，项目正在不断迭代更新，并会针对各个阶段推出不同的分支，以满足不同需求。
>
> 本项目完全免费开源，无需授权，可直接用于商业用途和二开后对外出售
>
> 欢迎社区贡献代码，帮助自己也可以帮助他人

##### DSSHOP是什么

- DSSHOP并非一套商城系统，它仅是一种多终端、前后端分离的解决方案；既然是方案，就不会有授权这一概念，我们只是将一些基于MIT、GUN等开源协议发布的开源项目拼接成一个直观的项目而已，也就是说你可以基于DSSHOP快速搭建自己个性化系统。
- 我们一定要区分方案和系统的区别，方案是不限于语言、工具的，也就是说DSSHOP可以利用go、java、c++等等语言重写API，或是用Android、Ios重写APP，从而达到项目的可持续发展。
- DSSHOP的开源之初就提及不适合任何人群，我们只面向开发者，所以需要你或你的团队掌握一定的编程基础。

##### DSSHOP名字由来

DSSHOP中文名：点石商城系统，因本人2012年开始做开源项目：点石为金资源管理系统（DSWJCMS），然后购买了dswjcms.com的域名,基于TP3.2做了好几个开源项目，后来对DSSHOP进行了重构，所以才有了现在的项目

演示
------------
- 后台演示地址：<a href="https://dsshop.dswjcms.com/admin">https://dsshop.dswjcms.com/admin</a> 用户名：admin 密码: admin
- 网站演示地址：<a href="https://dsshop.dswjcms.com">https://dsshop.dswjcms.com</a>
- h5、小程序、安卓演示
<table>
    <tr>
    	<td><img src="https://dspurl.github.io/image/gh_e79e7cd855e7_258.jpg"></td>
        <td><img src="https://dspurl.github.io/image/13.png"></td>
        <td><img src="https://dspurl.github.io/image/1618405140569.png"></td>
    </tr>
</table>


要求
------------
 - php >= 7.4
 - laravel = 7.22.4
 - mysql >= 5.7
 - vue = 2.5.17

## 傻瓜式安装**（从2.1.0开始不再支持）**
> 5步快速搭建属于自己的DSSHOP商城
>
> 安装包在环境满足的前提下，可不用写一行代码，即可搭建完整个项目(包括微信小程序、H5和后台)
>
> 优点：搭建方便，无需懂代码，全程引导安装；缺点：项目压缩编译，二开不友好
>
> 如需要二开，或深入学习的话，推荐使用命令行安装

<p><a href="https://dspurl.github.io/dsshop/guide/getting-started.html#%E5%82%BB%E7%93%9C%E5%BC%8F%E5%AE%89%E8%A3%85%E5%8C%85">点击查阅详细步骤</a></p>

<p><a href="https://dswjcms_purl.gitee.io/dsshop/guide/getting-started.html#%E5%82%BB%E7%93%9C%E5%BC%8F%E5%AE%89%E8%A3%85%E5%8C%85">点击查阅详细步骤（上面访问慢的话，点击这里）</a></p>



命令行安装
------------

```shell
# 下载dsshop
git clone https://github.com/dspurl/dsshop.git
# 搭建json API
cd ./api
composer install
# 修改.env.dev为.env
# 添加数据库信息
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=表名
DB_USERNAME=用户名
DB_PASSWORD=密码

#配置redis(需要事先装redis服务端)
REDIS_HOST=127.0.0.1
REDIS_PASSWORD='密码'
REDIS_PORT='端口'
REDIS_DB=1
REDIS_CACHE_DB=1

php artisan migrate
# 加载demo数据(demo和pure二选一)
php artisan generate:demo
# 加载纯净数据
# php artisan generate:pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 创建密码授权客户端
php artisan passport:client --password
# 选择`admins`
#修改.env.dev为.env，添加OAuth认证信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 需要安装PhpRedis
# 参考：https://github.com/dspurl/dsshop/pull/84

# 搭建后台
cd ../admin
#不要在linux下执行，会报错，推荐windows
npm install 
#admin/config/dev.env.js修改自己的api地址
BASE_API: '"http://dsshop.com/api/v1/admin/"',

npm run dev

# 搭建H5
cd ../trade/Dsshop
npm install 
# HBuilder X导入trade/Dsshop目录
#trade/Dsshop/utils/config.js修改服务器地址
#修改`BaseURL`为API访问地址
#修改`secret`为API密钥'API的.env中的APP_KEY'

```
常见错误
------------
<p><a href="https://dspurl.github.io/dsshop/guide/faq.html">https://dspurl.github.io/dsshop/guide/faq.html</a></p>
<p><a href="https://dswjcms_purl.gitee.io/dsshop/guide/faq.html">https://dswjcms_purl.gitee.io/dsshop/guide/faq.html</a></p>

文档
------------
<p><a href="https://dspurl.github.io/dsshop/">https://dspurl.github.io/dsshop/</a></p>
<p><a href="https://dswjcms_purl.gitee.io/dsshop/">https://dswjcms_purl.gitee.io/dsshop/</a></p>

插件
------------
<p>下载请切换至<a href="https://github.com/dspurl/plugin">插件列表</a></p>
<p>优惠券</p>
<p>评价</p>
<p>栏目文章</p>
<p>分销功能</p>



功能介绍
------------
- **RBAC权限** 支持为不同管理员分配不同的权限
- **商品SKU** 支持为同一商品添加不同的SKU属性（设计为无限层，建议三级以内，层级越多，性能越差）
- **运费模板** 可以根据不同地区设置不同的运费和免邮的区域
- **购物车** 用户可以直接购买商品，也可以将商品添加到购物车，一起支付
- **订单** 项目支持用户下单、取消订单、平台发货、平台退款
- **授权登录** 支持小程序端手机号一键授权登录，默认支持微信小程序（其它小程序可参考文档快速接入）
- **支付** 支持余额支付（暂时只支持退款入账，不支持后台添加用户余额）和在线支付（默认支持微信小程序支付，其它支付可参考文档快速接入）
- **轮播** 可以为项目添加轮播和首页广告，并添加相应的URL
- **模板通知** 集成微信小程序模板通知，平台发货时，用户将收到发货的模板通知
- **短信验证码** 集成阿里云短信，用户注册、找回密码时需要用户获取短信完成验证(未配置短信时，用户点击获取验证码后，将自动填写验证码)
- **统计** 接入微信小程序部分统计，结合项目本身数据统计，让你全方位了解项目的真实数据
- **事务支持** 项目支持事务处理，并为必要的业务流程增加了事务的处理机制
- **Redis支持** 项目部分数据采用Redis缓存和Redisis锁机制
- **消息通知** 集成多种通知途径：站内信、小程序、微信公众号、邮件等
- **注册协议** 自带隐私协议、注册协议（需添加栏目文章模块）
- **关联微信公众号** 系统已集成引导用户关注公众号代码，用户可轻松绑定微信公众号
- **邮件系统** 邮箱认证、绑定、消息通知发送
- **备份系统** 可对项目和数据库进行备份，并支持保留指定天数，超出后自动清除旧备份

图标
------------
- 后端使用svg图标，路径在`admin/src/icons/svg`，根据文件名可以看出图标用途
- 前端使用了用了1个ttf图标文件(https://at.alicdn.com/t/font_1078604_w4kpxh0rafi.ttf)
- 在App.vue中引用，用[百度字体编辑器](http://fontstore.baidu.com/static/editor/index.html)可以查看和编辑字体
- 预览使用: https://vkceyugu.cdn.bspapp.com/VKCEYUGU-market/872f2160-d6e1-11ea-81ea-f115fe74321c.html

基于以下扩展或组件(不分排名，这里只罗列部分名称，具体请查看package和composer)
------------
- [laravel](https://learnku.com/docs/laravel/7.x "laravel")
- [easywechat](https://www.easywechat.com/docs/4.1/mini-program/app_code "easywechat微信公众号")
- [guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/index.html "guzzle")
- [Passport OAuth 认证](https://learnku.com/docs/laravel/7.x/passport/7515 "Passport OAuth 认证")
- [vue2.0](https://cn.vuejs.org/v2/guide/ "vue")
- [ColorUI](https://github.com/weilanwl/ColorUI "ColorUI")
- [uni-app](https://uniapp.dcloud.io/README "uni-app")
- [vue-element-admin V3.*](https://github.com/PanJiaChen/vue-element-admin/blob/tag/3.11.0/README.zh-CN.md "vue-element-admin")
- [element](https://element.eleme.cn/ "element")


加入我们
------------
- 有问题可以直接discussions，请详细说明问题，如果你不习惯用discussions，也可以通过issue。
- dsshop交流群，微信扫码进群
<p align="center">
  <img src="https://dspurl.github.io/image/12.png" width="150">
</p>