# 贩卖机需求文档需求大纲

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，支付中心接口（不论支付结果如何，都要调用本接口）

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