Browse Source

update[doc]

Junling Bu 7 years ago
parent
commit
474e64c5be
1 changed files with 184 additions and 22 deletions
  1. 184 22
      doc/3.md

+ 184 - 22
doc/3.md

@@ -14,17 +14,106 @@
 
 * 支付功能
 * 优惠券功能
-* 商品搜索
+* 商品搜索中采用更好的搜索机制
+* 商品搜索中,支持热门搜索"换一批"
 * 进一步区分商品和货品的关系
 * 地址优化,目前每一次点击都会请求后台,应该缓存已有的数据
 * 商品数量和规格中,如果货品数量不足,则显示不能点击的效果
 * 商品好评计算与显示
+* 账号登录和注册中验证码
 
 ## 3.1 litemall-wx-api
 
-### 3.1.1 
+### 3.1.1 授权服
 
-#### 3.1.1.1 运费计算
+#### 3.1.1.1 账号登录
+
+#### 3.1.1.4 微信登录
+
+#### 3.1.1.5 账号注册
+
+目前账号注册只是简单的根据用户名和密码新建一个账号。
+
+这里缺失一个重要的属性,即用户邮箱或者手机号,来限制用户随意注册。
+
+#### 3.1.1.6 密码找回
+
+### 3.1.2 首页服务
+
+### 3.1.3 类目服务
+
+### 3.1.4 商品服务
+
+#### 3.1.4.1 商品新品
+
+#### 3.1.4.2 商品热品
+
+#### 3.1.4.3 商品列表
+
+* 关键字搜索
+
+用户的搜索采用和商品的关键字属性匹配来查找商品。
+因此需要用户添加商品时设置关键字值。
+
+这里只是简单的搜索,更好地做法可能是进一步搜索商品的名字、简介。
+或者采用更为专业的搜索算法。
+
+
+#### 3.1.4.4 商品详情
+
+#### 3.1.4.5 同类商品
+
+#### 3.1.4.6 商品总数
+
+#### 3.1.4.7 相关商品
+
+### 3.1.5 品牌服务
+
+#### 3.1.5.1 品牌列表
+
+#### 3.1.5.2 品牌详情
+
+### 3.1.6 专题服务
+
+#### 3.1.6.1 专题列表
+
+#### 3.1.6.2 专题详情
+
+#### 3.1.6.3 相关专题
+
+### 3.1.7 搜索服务
+
+#### 3.1.7.1 搜索关键字
+
+#### 3.1.7.2 搜索帮助
+
+#### 3.1.7.3 搜索历史清除
+
+#### 3.1.7.4 搜索结果
+
+### 3.1.8 购物车服务
+
+#### 3.1.8.1 购物车商品详情
+
+#### 3.1.8.2 添加商品到购物车
+
+#### 3.1.8.3 立即购物
+
+#### 3.1.8.4 更新购物车商品
+
+#### 3.1.8.5 删除购物车商品
+
+#### 3.1.8.6 设置购物车商品选中状态
+
+#### 3.1.8.7 购物车商品数量
+
+#### 3.1.8.8 购物车下单前确认
+
+### 3.1.9 订单服务
+
+#### 3.1.9.1 提交订单
+
+* 运费计算
 
 订单费用小于88时,则需要运费8元;
 否则运费0元。
@@ -32,26 +121,71 @@
 目前运费8元是写在后台代码中,未来可能允许设置管理员设置其他值;
 或者采用更加符合实际情况的运费计算方式。
 
-### 3.1.2 安全
+#### 3.1.9.2 取消订单
+#### 3.1.9.3 取消订单并退款
+#### 3.1.9.4 删除订单
+#### 3.1.9.5 订单确认发货
+#### 3.1.9.6 可评价订单商品信息
+#### 3.1.9.7 订单列表
+#### 3.1.9.8 订单详情
+
+### 3.1.10 评价服务
+
+#### 3.1.10.1 评论列表
+
+#### 3.1.10.2 评论总数
+
+#### 3.1.10.3 提交评论
+
+### 3.1.11 支付服务
+
+准备采用weixin-java-tools工具简化微信支付代码的开发。
+由于需要商户相关信息,目前没有开发。
+
+### 3.1.12 收藏服务
+
+#### 3.1.12.1 收藏列表
+
+#### 3.1.12.2 收藏设置
+
+### 3.1.13 足迹服务
+
+#### 3.1.13.1 足迹列表
+
+#### 3.1.13.2 删除足迹
+
+### 3.1.14 收货地址服务
+
+#### 3.1.14.1 收货地址列表
+
+#### 3.1.14.2 收货地址详情
+
+#### 3.1.14.3 收货地址添加
+
+#### 3.1.14.4 收货地址删除
+
+### 3.1.15 区域服务
 
-#### 3.1.2.1 Token
+### 3.1.16 安全
+
+#### 3.1.161 Token
 
 用户登录成功以后,后端会返回`token`,之后用户的请求都会携带token。
 
 目前token的失效和跟新机制没有涉及。
 
-#### 3.1.2.2 CROS
+#### 3.1.16.2 CROS
 
 如果litemall-admin-api不配置CROS,则Spring Boot会失败。
 但是,这里litemall-wx-api没有配置CROS,Spring Boot却不会报错,需要进一步研究。
 
-#### 3.1.2.3 账号密码加盐
+#### 3.1.16.3 账号密码加盐
 
 如果是微信登录,那么无需账号和密码。
 
 而如果用户采用了账号和密码的形式登录,那么后端需要把用户密码加盐。
 
-#### 3.1.2.4 限制登录
+#### 3.1.16.4 限制登录
 
 如果采用账号密码登录,那么登录失败一定次数,应该限制登录。
 
@@ -59,11 +193,6 @@
 
 目前这里没有实现,仅列出。
 
-### 3.1.3 支付
-
-准备采用weixin-java-tools工具简化微信支付代码的开发。
-由于需要商户相关信息,目前没有开发。
-
 ## 3.2 litemall-wx
 
 这里的代码基于[nideshop-mini-program](https://gitee.com/tumobi/nideshop-mini-program),但是做了一定的修改:
@@ -78,7 +207,7 @@
 注意
 > 目前litemall-wx项目代码基于nideshop-mini-program的commit版本[acbf6276eb27abc6a48887cddd223d7261f0088e](https://github.com/tumobi/nideshop-mini-program/commit/acbf6276eb27abc6a48887cddd223d7261f0088e)。由于改动变化较大,因此之后litemall-wx将独立开发,nideshop-mini-program的跟新不一定会合并到litemall-wx中。
 
-### 3.2.1 业务API切换
+### 3.2.1 业务API设置
 
 业务API存放在`config/api.js`。
 
@@ -103,7 +232,34 @@ var WxApiRoot = 'http://localhost:8082/wx/';
 
 因此,开发阶段用户可以按照具体情况切换1,2或3的选项。
 
-### 3.2.2 登录
+### 3.2.2 页面
+
+#### 3.2.2.1 首页
+
+#### 3.2.2.
+
+#### 3.2.2.
+
+#### 3.2.2.
+
+#### 3.2.2.
+
+#### 3.2.2.
+
+#### 3.2.2.
+
+#### 3.2.2.
+#### 3.2.2.
+
+#### 3.2.2.
+#### 3.2.2.
+#### 3.2.2.
+#### 3.2.2.
+#### 3.2.2.
+#### 3.2.2.
+
+
+### 3.2.3 登录设计
 
 按照官方文档,开发者采用`wx.login`方法即可实现登录操作;
 然而,由于`wx.login`只能返回临时登录凭证`code`,从服务器也只能返回对应的sessionId,
@@ -188,16 +344,22 @@ var WxApiRoot = 'http://localhost:8082/wx/';
 2. 如果用户仍然拒绝,则返回
 3. 如果用户接受授权,则弹出系统权限配置页面,等待用户给与授权。
 
-### 3.2.3 立即购买和放入购物车
+### 3.2.4 立即购买和放入购物车
 
-### 3.2.3 
-
-### 3.2.4 storage使用
+### 3.2.5 storage使用
 
 本模块中采用storage来存储一些数据,以及组件间进行通信。
 
-#### 3.2.4.1 userInfo和token
+#### 3.2.5.1 userInfo和token
+
+#### 3.2.5.2 cartId
+
+#### 3.2.5.3 addressId
+
+## 3.3 开发
+
+### 3.3.1 小商场页面开发
 
-#### 3.2.4.2 cartId
+### 3.3.2 交互服务API设计
 
-#### 3.2.4.3 addressId
+### 3.3.3 后台服务开发