增加 README 说明

pull/36/MERGE
YunaiV 2024-01-05 00:10:23 +08:00
parent c4ccb770fc
commit bcd5cd04bc
13 changed files with 31 additions and 165 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 238 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 201 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 165 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 168 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 152 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 294 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 177 KiB

196
README.md
View File

@ -1,190 +1,56 @@
## 简介
**严肃声明:现在、未来都不会有商业版本,所有代码全部开源!**
![title](https://file.sheepjs.com/www/preview/dcloud/01.png)
**「我喜欢写代码,乐此不疲」**
**「我喜欢做开源,以此为乐」**
<div align="center">
我 🐶 在上海艰苦奋斗,早中晚在 top3 大厂认真搬砖,夜里为开源做贡献。
[![star](https://gitee.com/sheepjs/shopro-uniapp/badge/star.svg)](https://gitee.com/sheepjs/shopro-uniapp.git)
[![fork](https://gitee.com/sheepjs/shopro-uniapp/badge/fork.svg?theme=gvp)](https://gitee.com/sheepjs/shopro-uniapp.git)
[![version](https://img.shields.io/badge/Shopro-V1.5-brightgreen)](https://gitee.com/sheepjs/shopro-uniapp.git)
[![license](http://img.shields.io/badge/license-MIT-orange)](https://gitee.com/sheepjs/shopro-uniapp.git)
如果这个项目让你有所收获,记得 Star 关注哦,这对我是非常不错的鼓励与支持。
[官方网站](https://www.shopro.top/) | [H5 演示](http://shopro.sheepjs.com/) | [管理系统](https://shopro.sheepjs.com/admin/) | [问题反馈](https://gitee.com/sheepjs/shopro-uniapp/issues)
## 🐶 新手必读
</div>
* 演示地址:<https://doc.iocoder.cn/mall-preview/>
* 启动文档:<https://doc.iocoder.cn/quick-start/>
* 视频教程:<https://doc.iocoder.cn/video/>
## 特性
## 🐯 商城简介
![features](https://file.sheepjs.com/www/preview/dcloud/02.png)
**芋道商城**,基于 [芋道开发平台](https://github.com/YunaiV/ruoyi-vue-pro) 构建,以开发者为中心,打造中国第一流的 Java 开源商城系统,全部开源,个人与企业可 100% 免费使用。
- **支持主题色+自定义头部导航+自定义底部导航**
- **内含沉浸式头部、通用头部导航示例,支持后端自定义配置底部导航背景和样式**
- **店铺装修组件(轮播、标题栏、优惠券、商品组、宫格导航、列表导航+广告魔方+富文本、搜索栏等众多组件)**
- **内置微信公众号分享 jssdk+微信小程序分享卡片+微信 App 分享+海报分享统一封装**
- **内置微信公众号登录+微信小程序手机号登录+微信 App 开放平台登录+账号密码登录+iOS 登录统一封装**
- **内置余额支付+微信公众号 jssdk 支付+微信小程序支付+微信 App 支付+支付宝网页支付+支付宝 App 支付统一封装**
- **支持第三方 cdn 图片资源地址,并支持阿里云、腾讯云、七牛云图片缩放参数**
- **严格适配多终端场景并支持 App 审核上架**
> 有任何问题,或者想要的功能,可以在 Issues 中提给艿艿。
>
> 😜 给项目点点 Star 吧,这对我们真的很重要!
![功能图](/.image/common/mall-feature.png)
## 技术栈
* 基于 uni-app + Vue3 开发支持微信小程序、微信公众号、H5 移动端,未来会支持支付宝小程序、抖音小程序等
* 支持 SaaS 多租户,可满足商品、订单、支付、会员、优惠券、秒杀、拼团、砍价、分销、积分等多种经营需求
- **前端技术栈uni-app、ES6、Vue3、Vite、Pinia;**
## 安装
## 🔥 后端架构
```bash
# 1.克隆项目
$ git clone https://gitee.com/sheepjs/shopro-uniapp.git
```
支持 Spring Boot、Spring Cloud 两种架构:
```bash
# 2.拷贝env示例配置文件 重命名为.env
$ cd shopro-uniapp
$ cp env .env
```
① Spring Boot 单体架构:<https://github.com/YunaiV/ruoyi-vue-pro>
```bash
# 3.安装依赖 (需安装nodejs环境, 使用npm国内镜像)
$ npm install --registry=https://registry.npmmirror.com
```
![架构图](/.image/common/ruoyi-vue-pro-architecture.png)
```bash
# 4.使用HbuilderX 运行...
```
② Spring Cloud 微服务架构:<https://github.com/YunaiV/yudao-cloud>
## 体验
![架构图](/.image/common/yudao-cloud-architecture.png)
![系统架构](https://file.sheepjs.com/www/preview/dcloud/04.png)
## 🐱 移动端预览
客户端演示地址:[https://shopro.sheepjs.com](https://shopro.sheepjs.com)
![移动端预览](/.image/common/mall-preview.png)
演示账号: shopro
## 🐶 管理端预览
演示密码: a123456
![店铺装修](/.image/mall/店铺装修.png)
管理端演示地址:[https://shopro.sheepjs.com/admin/](https://shopro.sheepjs.com/admin/)
![会员详情](/.image/mall/会员详情.png)
演示账号: shopro
![商品详情](/.image/mall/商品详情.png)
演示密码: 123456
![订单详情](/.image/mall/订单详情.png)
_注意演示环境已屏蔽管理权限和相关操作_
![营销中心](/.image/mall/营销中心.png)
## 项目结构
```
├── pages // 页面
│ ├── index // 入口页面
│ ├── user // 用户相关
│ ├── public // 公共页面
│ ├── activity // 活动页面
│ ├── app // 积分、签到页面
│ ├── chat // 客服页面
│ ├── commission // 分销页面
│ ├── coupon // 优惠券页面
│ ├── goods // 商品页面
│ ├── order // 订单页面
│ ├── pay // 支付页面
├── sheep // 底层依赖/工具库
│ ├── api // 服务端接口
│ ├── components // 自定义功能组件
│ ├── config // 配置文件
│ ├── helper // 助手函数
│ ├── hooks // vue-hooks
│ ├── libs // 自定义依赖
│ ├── platform // 第三方平台登录、分享、支付
│ ├── request // 请求类库
│ ├── router // 自定义路由跳转
│ ├── scss // 主样式库
│ ├── store // pinia状态管理模块
│ ├── ui // 自定义UI组件
│ ├── url // cdn图片地址格式化
│ ├── validate // 通用验证器
│ ├── index.js // Shopro入口文件
├── uni_modules // dcloud第三方插件
```
## 更新
### 近期计划
- [ ] Typescript 重构;
### V1.8.3 更新简介 2023/10/25
1. 对接微信小程序发货管理
2. 修复路由模式为history时微信公众号使用微信登录时跳转白屏bug
### V1.8.2 更新简介 2023/09/4
1. 添加 图片热区组件
2. 添加 商品评论商家回复功能
3. 优化 购物车性能
4. 优化 搜索组件
5. 优化 动态添加直播组件
6. 优化 轮播图组件
7. 优化 微信小程序订阅消息提醒时机
8. 优化 移动小程序端客服bug
9. 优化 h5支付拉起微信或者支付宝客户端时,支付单查询过早的问题
10. 优化 标题栏组件
11. 优化 二级分类组件
12. 优化 规格弹框,手动输入数量无法改变数量问题
13. 优化 绑定手机号
14. 重构 瀑布流商品
15. 重构 小程序快捷登录
16. 海报图片协议转换,自动识别https协议
17. 升级依赖版本
### V1.8.1 更新简介 2023/03/18
1. 优化搜索组件
2. 添加多端直播组件,动态加载直播插件
3. 添加多种配送方式(货到付款、手动发货)
4. 添加发货内容详情展示
5. 优化`radio`点击效果bug
6. 商品轮播图添加视频播放
6. 修复部分页面样式显示问题
### V1.8.0 更新简介 2023/02/07
1. 引入`luch-request`,替换`libs`中的`request`
2. 兼容`HbulderX`版本更新小程序端`v-bind`无法使用多层对象的问题
3. 优化分页数据相关页面代码
4. 富文本渲染组件使用`mp-html`替换原`su-parse`
5. 修复阶梯拼团弹框点击规格自动关闭问题
6. 自定义页面头部添加返回按钮及快捷菜单
7. 优化筛选时间可以任意选择时间问题(改为只能筛选当天及以前)
8. 修复部分页面样式显示问题
### V1.7.1 更新简介 2022/12/09
1. 更新插件市场忽略文件问题
2. 更改客服聊天图片样式问题
### V1.5 更新简介 2022/12/07
- [x] 服务保障icon 变形问题;
- [x] 确认订单 可用优惠券逻辑修改;
- [x] `su-image`组件中`customStyle`添加`width`属性;
---
**<p align="center">如果您觉得我们的开源项目很有帮助,请点击 :star: Star(https://gitee.com/sheepjs/shopro-uniapp.git) 支持 SheepJS 开源团队:heart:</p>**
---