From f9c348b321f59bae8609d14793060a28935d720a Mon Sep 17 00:00:00 2001
From: Areo-Joe <1047726015@qq.com>
Date: Wed, 25 Sep 2024 14:18:03 +0800
Subject: [PATCH] fix(tcb-shop): fix readme
---
miniprogram/tcb-shop/README.md | 298 +++------------------------------
1 file changed, 21 insertions(+), 277 deletions(-)
diff --git a/miniprogram/tcb-shop/README.md b/miniprogram/tcb-shop/README.md
index bcfae25..7c024d4 100644
--- a/miniprogram/tcb-shop/README.md
+++ b/miniprogram/tcb-shop/README.md
@@ -1,7 +1,6 @@
-
-
+
云开发电商模板
@@ -13,290 +12,35 @@
## 说明
-云开发电商模板提供了一键创建零售商城小程序的能力。
+本项目为云开发电商模板的小程序,提供首页、购物车、订单、个人中心、商品详情等页面。
-## 快速上手
+本项目的后端可前往
安装。
-1. 安装本模版
-2. 导入云开发电商模板小程序
+## 社区
-![](https://qcloudimg.tencent-cloud.cn/raw/5f1962e709c28af3252c0acb583e989b.png)
+欢迎添加企微群沟通交流:
-3. 填入开通了云开发环境的小程序的 appId
-
-![](https://qcloudimg.tencent-cloud.cn/raw/800f05945779cb940ef6851d96419f6e.png)
-
-4. 在 `app.js` 中,填入云开发环境 id
-
-![](https://qcloudimg.tencent-cloud.cn/raw/1da510c60d9d552119ed7aa79c7a6826.png)
-
-5. 前往[小程序微信支付模版](https://tcb.cloud.tencent.com/cloud-admin#/cloud-template/detail?appName=wx-pay-v2&solutionId=solution-1sbaF7cyIqcgRj&appType=basic),填入该模版所需参数
-
-![]( https://qcloudimg.tencent-cloud.cn/raw/9a11a564b8985883194f19cdd11c3f2b.png)
-
-6. 安装依赖
- 6.1 在命令行执行 `npm install`
- 6.2 点击菜单栏中的「工具 -> 构建 npm」
- 6.3. 详情可参考[npm 支持 | 微信开放文档](https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html#%E4%BD%BF%E7%94%A8-npm-%E5%8C%85)
-7. 编译启动小程序,开始体验
-8. 正式发布前,移除云开发引导弹窗
- 8.1 删除 `components/cloud-template-dialog/` 文件夹
-
- ![]( https://qcloudimg.tencent-cloud.cn/raw/fcc15824e38fbfacc1afee040c648099.png)
-
- 8.2 删除 `pages/home/home.wxml` 中对云开发引导弹窗的引用
-
- ![]( https://qcloudimg.tencent-cloud.cn/raw/cb2a20e0f840eaee236a964fac734f28.png)
-
- 8.3 删除 `pages/home/home.json` 中对云开发引导弹窗的引用
-
- ![](https://qcloudimg.tencent-cloud.cn/raw/7c0c32bbb494bc3b0877891d302c096c.png)
-
-## 页面介绍
-
-### 首页
-
-![](https://qcloudimg.tencent-cloud.cn/raw/89cf8dedbd3edfdbda31920447bddd51.png)
-
-首页由三部分组成:
-
-● 搜索栏
-
-● 轮播图
-
-● 商品列表
-
-#### 搜索栏
-
-点击搜索栏,可以输入搜索商品,并展示搜索到的商品列表:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/94e2ee9666aed0f8147affa180c879c7.png)
-
-#### 轮播图
-
-轮播图可循环展示配置好的图片。
-
-![](https://qcloudimg.tencent-cloud.cn/raw/b42bc12d0fa4fe350b83154ace0a613c.png)
-
-#### 商品列表
-
-首页商品列表会列出所有的商品,点击单个商品后,会跳转至对应的商品详情页。
-
-首页商品列表:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/98fca5271899639e1393753e52523fce.png)
-
-点击商品后跳转商品详情页:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/54c50176b1af344b23fb61e22e611265.png)
-
-### 分类页
-
-分类页会以侧边栏展示商品的一级分类,主内容展示商品的二级分类。
-
-![](https://qcloudimg.tencent-cloud.cn/raw/1ff658bb467a4e8febf34be13ecf80da.png)
-
-点击二级分类后,会展示当前分类下的商品列表。同样,在此商品列表点击商品后,会跳转至对应商品详情页。
-
-水果分类下的商品列表:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/927b12f16467f1def96e877c50b1a7e8.png)
-
-
-### 商品详情页
-
-![](https://qcloudimg.tencent-cloud.cn/raw/ef651d54d5e57d2aacaa50bc283ccfb5.png)
-
-商品详情页由多个部分组成:
-
-● 商品轮播图
-
-● 商品信息
-
-● 规格选择栏
-
-● 评价预览
-
-● 商品详情
-
-● 底部动作栏
-
-#### 商品轮播图
-
-商品轮播图可循环展示该商品的多个图片:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/5b59639efcc112ce592b72f6cd77fcb8.png)
-
-#### 商品信息
-
-商品信息会展示商品的名称与最低价格:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/5d23000c19ccb652ce9eab0afd1fd2e7.png)
-
-#### 规格选择栏
-
-点击规格选择栏后,可在跳出的弹窗中选择商品对应的规格,并选择购买数量。确定商品规格和购买数量后,可加入购物车或选择立即购买:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/f7aecbc84c8d691a8e6c97070b4af71b.png)
-
-#### 评价预览
-
-当商品存在评价时,会展示评价预览,包括评论数、好评率,以及一条评价:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/dd5e089f0be8b10dd900d65566bb2778.png)
-
-#### 商品详情
-
-商品详情用于展示商品的详细信息,这部分的内容以富文本的形式呈现:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/81271f5c219fb5c475493af8e8751d99.png)
-
-#### 底部动作栏
-
-底部动作栏提供了四个按钮,包括首页和购物车页的跳转按钮,点击后会跳转至相应页面;还有加入购物车与立即购买按钮,点击后能唤出规格选择弹窗,选择完商品后就能够执行对应的操作:
-
-底部动作栏:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/862684258b666755e5ea1dae45bdecfe.png)
-
-点击后唤出规格选择弹窗:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/de44ca5df5e297415d1863eb6cac7c1e.png)
-
-### 购物车页
-
-![](https://qcloudimg.tencent-cloud.cn/raw/eec6aa7cbdf1aefae293a68e867f8501.png)
-
-购物车页可以查看购物车项。对于每个购物车项,可以进行删除、修改数量的操作。选中购物车项后,可以点击「去结算」按钮前往订单确认页进行订单创建并购买。
-
-左滑购物车项进行删除:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/21311abac70b47bc352734e4e6da0485.png)
-
-选中购物车项后可进行结算:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/a2af456542cd7afae411cffaaac9d501.png)
-
-点击「去结算」按钮后跳转至订单确认页:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/c5e01f1c2cb4ef6eae6bd0fce0574a95.png)
-
-### 订单确认页
-
-![](https://qcloudimg.tencent-cloud.cn/raw/8789c377b15e0a222475b5253cd45c0a.png)
-
-订单确认页提供以下功能:
-
-● 地址选择栏
-
-● 订单信息展示
-
-● 提交订单并支付
-
-#### 地址选择栏
-
-地址选择栏展示当前订单的配送地址。如果未选择地址,将无法提交订单。点击地址选择栏后可跳转至地址列表,对地址进行增加、删除、修改和选择的操作。选择完地址后,会返回至此页,届时可继续进行订单提交。
-
-地址选择栏:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/febf20b5ae98eacd2b69a93ecbba684e.png)
-
-地址列表:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/c4d74f2749a9029c7a731071165fdd9f.png)
-
-选择完地址后,跳回订单确认页:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/4faedcef881787e25926e69f50ec18cd.png)
-
-#### 订单信息展示
-
-在订单确认页会展示当前创建的订单的详细内容,包括订单项、总价等信息。
-
-![](https://qcloudimg.tencent-cloud.cn/raw/268fe7c66225fe45d8ace3fd933e6b31.png)
-
-#### 提交订单并支付
-
-在选择完地址后,点击提交订单,即可创建订单,并弹出支付弹窗。若支付流程失败,可在订单列表中查询到待支付的订单,重新支付。
-
-![](https://qcloudimg.tencent-cloud.cn/raw/e81466d3fe35a15a1add1467e3b9114a.png)
-
-### 用户中心页
-
-用户中心页展示用户信息、订单列表和地址列表。
-
-![](https://qcloudimg.tencent-cloud.cn/raw/f7e8527c81b88c69bb800f3afbaa9e62.png)
-
-## 数据模型
-
-云开发电商模板附带了一系列的数据模型。对于数据模型的能力说明,请查看[云开发数据模型](https://docs.cloudbase.net/model/introduce)。
-
-本模版附带的数据模型有:
-
-|名称|标识|描述|
-|---|---|---|
-|电商SPU|shop_spu|一件商品,对应电商概念中的 SPU,即 Standard Product Unit。|
-|电商SPU分类|shop_spu_cate|商品分类,每个商品分类都可以有自己的子分类、父分类和对应的商品。|
-|电商SPU属性名|shop_attr_name|商品的属性名,如数量。|
-|电商SPU属性值|shop_attr_value|商品的属性值,如数量对应的值可能为「1 件」、「10 件」。|
-|电商SPU评价|shop_comment|用户对商品做出的评价。|
-|电商SKU|shop_sku|一件有具体属性的商品销售单位。每个 SPU 都可以对应多个 SKU。举例来说,A 品牌的平板电脑为 SPU,其对应的 SKU 为 A 品牌的 16GB 内存、白色的平板电脑。|
-|电商购物车项|shop_cart_item||
-|电商订单|shop_order||
-|电商订单项|shop_order_item||
-|电商收货信息|shop_delivery_info||
-|电商首页轮播图|shop_home_swiper_image||
-
-## 应用配置说明
-
-### 配置商品
-
-#### 配置SPU
-
-在「电商SPU」数据模型中,填入 SPU 数据。这里我们添加一行「荔枝」的 SPU 数据:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/adda72dbcf9f96d41236c128cb11522e.png)
-
-#### 配置SKU
-
-添加完 SPU 后,我们还需要为其添加 SKU 数据。SKU 可以理解为具有具体规格/属性的 SPU,比如荔枝的属性可以有数量、大小等等。不同数量、不同大小的荔枝会有不同的价格、不同的库存。
-
-首先,我们为荔枝配置属性选项。
-
-在「电商SPU属性名」数据模型中,我们添加一行「大小」属性:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/dd45aedca3c2235dce20c749faf6a890.png)
-
-添加完属性名后,我们还需要为此属性名配置属性值。
-
-我们在「电商SPU属性值」配置两个属性值,分别是大、小:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/e42f566f0622d4825da0d56acc085e25.png)
-
-![](https://qcloudimg.tencent-cloud.cn/raw/5a7b0b51e9062366f5412ef851b2d606.png)
-
-至此,我们配置好了「大小」这个属性名,这个属性名下有两个可选的属性值,分别为「大」和「小」。
-
-现在,我们可以为「荔枝」SPU 添加 SKU 了,分别是「大荔枝」和「小荔枝」,他们的价格户不相同:
-
-![](https://qcloudimg.tencent-cloud.cn/raw/a829aae86242a37c5130a0d1e0568d8d.png)
-
-![](https://qcloudimg.tencent-cloud.cn/raw/a5a6975a715e92f3abf9296cc53a279b.png)
-
-#### 配置商品分类
+
+
+
-每个 SPU 可以有多个分类,分类下也可以有子分类。现在我们来为荔枝添加二级分类,分别是「美食」->「水果」。
+## 安装依赖
-我们在「电商SPU分类」数据模型中添加「美食」分类:
+1. 安装 npm 依赖
-![](https://qcloudimg.tencent-cloud.cn/raw/b511ddf9b3069097f5c95f19779392f4.png)
+```shell
+npm install
+```
-然后再添加「水果」分类,添加时把父分类选为「美食」,并在 SPU 中添加「荔枝」:
+ 如果安装失败,请检查是否有足够权限执行命令,或尝试用更高权限安装依赖:
-![](https://qcloudimg.tencent-cloud.cn/raw/2a3c6522f9af616740e57a7db80ef94f.png)
+ ```shell
+ sudo npm install
+ ```
-### 配置首页轮播图
+2. 构建 npm
+点击微信开发者工具菜单栏中的「工具」->「构建 npm」
-首页轮播图会展示「电商首页轮播图」数据模型的第一行数据中的图片:
+## 运行小程序
-![](https://qcloudimg.tencent-cloud.cn/raw/73b6b4c119ea526506f683a4cf1f8c13.png)
+在微信开发者工具中导入本项目即可运行,若想配合后端运行完整应用,请前往安装。