diff --git a/doc/3.md b/doc/3.md index d35f385b..b3ac528c 100644 --- a/doc/3.md +++ b/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.2.1 Token +### 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.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.4.2 cartId +#### 3.2.5.2 cartId -#### 3.2.4.3 addressId \ No newline at end of file +#### 3.2.5.3 addressId + +## 3.3 开发 + +### 3.3.1 小商场页面开发 + +### 3.3.2 交互服务API设计 + +### 3.3.3 后台服务开发