# dsshop

**Repository Path**: skycccu/dsshop

## Basic Information

- **Project Name**: dsshop
- **Description**: vue2.0+Laravel7商城电商解决方案，完全前后端分离，免费开源可商用，H5商城电商平台，微信小程序商城电商平台；支持网站、PWA、H5、微信小程序，支付宝小程序、百度小程序、字节跳动小程序、安卓、IOS等等
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://dsshoping.dswjcms.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 89
- **Created**: 2022-01-03
- **Last Updated**: 2022-01-03

## 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(DSSHOPING)电商商城</h3>
<p align="center">前后端分离架构，VUE2.0+Laravel7，免费开源可商用。</p>
<p align="center">官网: <a href="https://dsshoping.dswjcms.com" target="_blank">https://dsshoping.dswjcms.com</a></p>

更新说明
------------

说明
------------
<p>master分支为稳定版本，推荐大多数用户下载，new分支为新版本，随时会有更新，未进行测试验收，不推荐用户使用</p>
<p>如果因网络原因无法下载，可通过<a href="https://gitee.com/dswjcms/dsshop">https://gitee.com/dswjcms/dsshop</a>下载</p>
<p>项目更新已趋于稳定，不会做大的修改，一般更新节奏为1-2个月更新一次，以修复BUG和优化功能，开发插件为主</p>
<p>已验证版本(经测试后可以正常安装的版本):2.3.1</p>
<p>当前版本2.3.1</p>

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

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

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

##### DSSHOP是什么

- DSSHOP是一套多终端的商城底层系统，需要通过插件来扩充自己，从而满足商用需求。
- DSSHOP的开源之初就提及不适合任何人群，我们只面向开发者，所以需要你或你的团队掌握一定的编程基础。

##### DSSHOP名字由来

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

演示
------------
- 后台演示地址：<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>



docker命令行安装(其它安装方式见文档)
------------

```shell
git clone https://gitee.com/dswjcms/dsshop.git
cd dsshop
# 安装环境
docker-compose up -d
# 安装后端
docker-compose exec php bash
composer install
cp .env.docker .env
# 如有修改过docker-compose.yml，如数据库密码，请自行修改.env文件
php artisan migrate
# 加载demo数据(demo和pure二选一)
php artisan generate:sql
# 加载纯净数据
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 创建密码授权管理端
php artisan passport:client --password
# 选择`admins`
# 修改.env，添加OAuth认证信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 创建密码授权客户端
php artisan passport:client --password
# 选择`users`
# 修改.env，添加OAuth认证信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"

# 搭建后台
#进入admin/vue2/element-admin-v3目录
#不要在linux下执行，会报错，推荐windows
npm install 
#admin/config/dev.env.js or prod.env.js修改自己的api地址
BASE_API: '"http://172.27.16.1/api/v1/admin/"',  //172.27.16.1是window主机的局域网IP

npm run dev
# 默认后台账号、密码
admin
admin

# 搭建H5
cd ../client/uni-app/mix-mall
npm install 
# HBuilder X导入client/uni-app/mix-mall目录
# client/uni-app/mix-mall/utils/config.js修改服务器地址
# 修改`BaseURL`为API访问地址
# `secret`有个默认密钥，如需自定义，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通过浏览器、微信小程序运行项目，也可以直接发布项目，但需要配置账号，具体请参考HBuilder X

```
常见错误
------------
<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>优惠券</p>
<p>评价</p>
<p>栏目文章</p>
<p>分销功能</p>



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

图标
------------
> 图标部分是svg，部分使用iconfont，iconfont并未明确可以免费用于商业用途，版权归图标作者所有，如对版权有要求的，请自行更换图标
- 后端使用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>