vending-machine/贩卖机需求文档.md

贩卖机需求文档需求大纲

1. 开发平台：Android App、ios app。
2. 需上架，上架渠道：
   1. android：Google
   2. Ios：Ios AppStore
3. 多语言：简体中文、繁体中文、英。
4. 支付渠道：
   1. android：Google Pay
   2. Ios：Ios apple pay
5. 需要与硬件厂商（贩卖机）进行API对接。
6. 原型地址：https://modao.cc/proto/jCjCc4Nutabz5mg2xycHaz/sharing?view_mode=read_only&screen=rbpVAzH1egN1CbzJi #tb0026_贩卖机-分享

多语言

1. 支持简中、繁中、英文。
2. 文字、图片配置时，支持多语言配置。

积分获取

1. 用户在机器上支付的金额，按一定比例转换成积分。
   1. 如1元 = 1积分。
2. 后台可配置金额与积分的转换比。

首页

首页

1. 首页顶部展示banner，后台可配置图片、跳转链接。
   1. 可跳转至内部指定页面、外部链接。
2. 点击【成为会员】图片，跳转至“会员页”。
   1. 后台可配置入口图片。
3. 点击【节日印花】图片，跳转至“节日印花页”。
   1. 后台可配置入口图片。
4. 点击【会员二维码】图片，判断用户是否为会员：
   1. 是，弹出“会员二维码弹窗”。

会员二维码弹窗

• 1. 否，跳转至“会员页”。
  2. 后台可配置入口图片。

1. 点击【使用说明】，弹出“优惠券使用说明弹窗”。

优惠券使用说明弹窗

• 1. 后台可配置文案。

1. 展示可兑换的优惠券列表，后台可配置。
   1. 展示优惠券名称、到期时间、兑换条件、【兑换】按钮。
      1. 后台还需配置优惠券类型，如满减、抵扣。
   2. 点击【兑换】按钮，弹出“确定兑换弹窗”。

确定兑换弹窗

• • 1. 点击【确定兑换】按钮，检测用户积分是否满足兑换条件： 1. 满足，兑换该优惠券，关闭弹窗，弹出系统提示“兑换成功”。 2. 不满足，关闭弹窗，弹出系统提示“积分不足，无法兑换”。 3. 若兑换期间优惠券被下架， 关闭弹窗，弹出系统提示“优惠券已下架”。

会员页

单月会员

会员页

1. 展示会员宣传长图，后台可配置。
2. 后台可配置会员价格、生效时长。
   1. 可能还需要在google和ios的后台去配置商品、商品价格。
3. 页面底部展示【开通会员】按钮，点击拉起google pay或apple apy支付。
   1. 用户支付成功后回到本页面，强制刷新页面。
4. 用户成为会员后，底部按钮文字更改为“会员已开通”，按钮处于灰色不可点击状态。
5. 会员身份结束后，保留剩余积分3个月。超时后积分清空。

订阅会员

1. google和ios可能支持订阅会员，需开发时再具体看一下。
2. 购买订阅会员后，每月自动续费。
3. 若支持订阅会员，页面底部增加【订阅会员】购买按钮，需在按钮或会员介绍上写清订阅相关规则。
   1. 用户购买单月会员后，可继续购买订阅会员，自动叠加。
      1. 购买单月会员后，单月会员的购买按钮隐藏，只显示订阅会员购买按钮。
      2. 购买订阅会员后，无法再购买会员，购买按钮文字变更为“已购买订阅会员”，按钮处于灰色不可点击状态。

节日印花页

节日印花页

1. 印花：在节假日等日期，给会员赠送优惠券。
   1. 兑换时可配置0积分或少量积分。
2. 印花需要手动兑换。
   1. 只有会员能兑换。
   2. 非会员用户点击【兑换】，跳转至“会员页”。
3. 后台可配置banner图，点击无跳转。
4. 该类型的优惠券，每张每人只能兑换1次。兑换后，【兑换】按钮替换为【已兑换】，按钮处于灰色不可点击状态。

我的页

我的页 未登录与登录状态

1. 未登录时，展示默认头像、【登录】按钮。
   1. 点击【登录】按钮，跳转至“登录页”。
   2. 登录后，展示默认用户昵称、UID。
      1. 默认用户昵称：由 “用户” + 随机6位数字组成。
2. 我的积分，显示剩余积分，点击该区域，跳转至“我的积分页”。
3. 点击【赠送积分】按钮，弹出“赠送积分弹窗”。

赠送积分弹窗

• 1. 输入对方的UID、要赠送的积分，点击【赠送】按钮，判断用户剩余积分数量：
     1. 数量充足，当前用户减少积分、对方增加积分，关闭弹窗，弹出系统提示“积分已赠送”。
     2. 数量不足，弹出系统提示“剩余积分不足，无法赠送”。

1. 点击【我的优惠券】按钮，跳转至“我的优惠券页”。
2. 点击【切换语言】按钮，弹出“多语言选择列表”。

多语言选择列表

1. 点击【用户协议】【隐私政策】按钮，跳转至对应页面。
2. 点击【关于】按钮，跳转至“关于页”。
3. 点击【退出登录】按钮，弹出“确定退出登录弹窗”。

登录页

登录页

1. 使用手机号验证码方式登录。
   1. 支持更换手机区号。
   2. 对接第三方平台用于获取短信验证码。
2. 点击【用户协议】【隐私政策】可跳转至对应页面。
3. 点击【登录】时，检测是否勾选同意协议，若未勾选，弹出系统提示“请阅读并同意协议”。

我的积分页

我的积分

1. 状态分为“获取记录”“使用记录”。
2. 获取记录，展示积分来源、获取时间、增加数量。
3. 使用记录，展示积分使用方式、使用时间、减少数量。

我的优惠券页

我的优惠券

1. 状态分为“可使用”“已使用”“已过期”。
2. 已使用、已过期的优惠券，显示对应icon“已使用”“已过期”。

用户协议&隐私政策

用户协议&隐私政策

1. 后台可配置对应内容。

关于

关于

1. 展示LOGO、版本号、【注销账号】按钮。
2. 点击【注销账号】按钮，弹出“注销账号弹窗”。

注销账号弹窗

• 1. 点击【确定】按钮，注销该账号，退出登录状态，返回到首页，弹出系统提示“已注销”。

硬件厂商API对接

流程大纲如下，具体如何实现需在开发过程中确定

要实现的功能：

1，积分获取，用户在支付前，我们APP展示会员二维码（包含了会员ID等信息，有时效限制，几分钟后会失效，防止截图盗刷），机器扫码。

机器向我们接口请求，获取用户id等相关信息，我方锁定用户。锁定期间用户若在其他机器扫码，机器拿到会员id后向我们请求用户数据，我们接口返回用户锁定，机器提示“已在其他机器扫码”等提示。

用户在机器支付后，机器主动调用我们的接口，把用户ID、支付金额等信息发给我们。

2，抵扣，用户在支付前，机器扫用户的会员二维码。拿到会员ID后，机器主动向我们请求该用户的信息。

这信息里包含了优惠券信息，如100-5、无门槛5元、时效等，机器那边根据用户购买的物品、金额等条件去判断是否使用、使用哪张（每次只能使用一张），优先使用快到期、抵扣金额最大的优惠券。

用户支付后，机器通过接口把用户ID、支付金额、使用的优惠券ID等信息发给我们。

要调用的接口：

1，用户信息接口

2，支付中心接口（不论支付结果如何，都要调用本接口）

以上是大致流程，进入开发阶段后，我方会给出具体接口文档