huangye-parking/docs/黄岩停车积分兑换 需求文档.md

黄岩停车积分兑换 需求文档需求简介

1. 项目名称：黄岩停车积分兑换
2. 开发版本：微信小程序
3. 外部API对接 ——
   1. 特来电：用于账户信息、积分。
   2. 驿公里：用于自助洗车店优惠券兑换和使用。
4. 商户可登录小程序，进行扫码核销、券码核销。
   1. 每个商户有自己的账号。
5. 蓝湖地址：https://modao.cc/proto/cwLDDi0t7clavfINDAiN/sharing?view_mode=read_only&screen=rbpV5WCwMmr5HEUwq #tb0021_黄岩停车积分系统-分享

优惠券说明

1. 优惠券可用于洗车店支付抵扣，分为两类：免费券、抵扣券。
   1. 免费券：使用后本次洗车免费。
   2. 抵扣券：使用后本次洗车可抵扣券值金额，剩余金额用户线下支付。
2. 可用积分兑换优惠券。
3. 每个优惠券都有对应的“适用门店”，需在对应门店才能核销使用。
   1. 门店分为两类：人工洗车店、无人洗车店。
4. 后台可配置优惠券名称、适用门店、有效期、剩余数量、使用方式、兑换积分等。
5. 每个券都有独立的券码，券码为自动分配，为9位随机字母+数字组成，不以0开头。
6. 部分优惠券在小程序内兑换后，需与第三方API（驿公里）进行对接，在小程序内兑换后，在驿公里APP内进行使用，最后回调给我们使用结果。
   1. 此类优惠券，在兑换前、兑换后会提示用户要在对应的APP里使用。
   2. 暂定通过“手机号”为唯一ID进行数据对接。

如何获取积分

1. 通过对接第三方API（特来电），根据“手机号”同步账号信息。
2. 1xx = 1积分。
   1. 公式待定。

首页

首页

1. 顶部banner后台可配置。
   1. 因没有其他重要页面，banner无需跳转。
2. 点击【核销流程】按钮，弹出“核销流程弹窗”。

核销流程弹窗

• 1. 弹窗内容后台可配置。

1. 点击【积分说明】按钮，弹出“积分说明弹窗”。

积分说明弹窗

• 1. 弹窗内容后台可配置。

1. 展示支持的洗车店列表。

洗车店列表

• 1. 展示门店照片、门店名称、位置、联系方式、可用优惠券、门店类型。
     1. 后台可配置。
  2. 可用优惠券：用户已兑换且未使用的该洗车店的优惠券。

1. 点击【查看优惠券】按钮，跳转至“门店可用优惠券页面”。

门店可用优惠券页面

• 1. 显示门店名。
  2. 显示优惠券名称、适用门店、券码、有效期、使用方式、二维码入口。
  3. 点击【二维码】，弹出“优惠券二维码弹窗”。

优惠券二维码弹窗

• 1. 检测到扫码成功，关闭当前弹窗，弹出“扫码成功弹窗”。

扫码成功弹窗

• • 1. 点击【确定】按钮，关闭当前弹窗，刷新当前页面。

    2. 检测到扫码失败，关闭当前弹窗，弹出“扫码失败弹窗”。

核销失败弹窗

1. 点击【导航】按钮，弹出自带的导航选择，可导航至门店位置。

积分页

积分页

1. 展示用户剩余积分。
2. 点击【积分说明】按钮，弹出“积分说明弹窗”。

积分说明弹窗

1. 点击【积分明细】按钮，跳转到“积分明细页”。

积分明细页

• 1. 分为“全部”“收入”“支出”。
  2. 展示积分变化原因、时间、兑换的优惠券名称、兑换门店。

1. 可根据门店筛选，默认为“全部”，点击下拉列表，展示所有门店名。

筛选门店

1. 展示可兑换的优惠券列表。

可兑换优惠券列表

• 1. 展示优惠券名称、适用门店、有效期、剩余数量、使用方式、所需积分。

1. 点击【兑换】 ——
   1. 积分不足，弹出系统提示“积分不足”。
   2. 积分充足，弹出“兑换优惠券二次确认弹窗”。

兑换优惠券二次确认弹窗

• • 1. 点击【确定】按钮，兑换该优惠券，剩余数量改变，弹出系统提示“兑换成功”。 2. 点击【取消】按钮，关闭弹窗。

我的页

我的页

1. 未登录时点击任意按钮，跳转至登录页。

登录页

• 1. 通过获取手机号登录。

1. 登录后展示用户头像、昵称、UID。
   1. 点击此区域，跳转至“个人资料页”。
2. 展示剩余积分、剩余优惠券数量。
   1. 点击【积分】区域，跳转至“积分页”。
   2. 点击【优惠券】区域，跳转至“我的优惠券页”。
3. 点击【核销记录】按钮，跳转至“核销记录页”。
4. 点击【联系我们】按钮，跳转至小程序自带客服页。
5. 点击【用户协议】【隐私政策】按钮，跳转至“用户协议页”“隐私政策页”。

用户协议或隐私政策页

1. 点击【退出登录】按钮，弹出“退出登录二次确认弹窗”。

退出登录二次确认弹窗

• 1. 点击【确定】按钮，退出登录。
  2. 点击【取消】按钮，关闭弹窗。

个人资料页

个人资料页

1. 可更换头像、昵称。
   1. 可获取微信头像、昵称。
2. UID不可更改，为随机6位数字，不以0开头。

我的优惠券页

我的优惠券页

1. 分为“未使用”“已使用”“已过期”。
2. 可筛选“适用门店”，默认为全部。
3. 可筛选“类型”，默认为全部。
   1. 类型分类：免费券、抵扣券。
4. 当该优惠券为平台自己的优惠券时优惠券显示【二维码】按钮。
5. 当该优惠券为“驿公里”的优惠券时，不显示【二维码】，显示“使用方式”、【点击跳转】按钮。
   1. 点击【点击跳转】按钮，跳转至驿公里的小程序。
      1. 驿公里的小程序“驿公里洗车”。
   2. 该类型的优惠券，兑换后直接进入“已使用”状态，因为不是我们自己的优惠券，状态检测等比较麻烦。
6. 点击【二维码】按钮，弹出“优惠券二维码弹窗”。
7. 当优惠券被使用，本页面强制刷新。

核销记录页

核销记录页

1. 显示优惠券名称、使用时间、使用门店。

门店登录

商户登录页

1. 平台管理后台可绑定每个门店的员工的手机号。
2. 当检测到员工手机号登录小程序后，跳转至本页面“门店登录页”。
   1. 员工可选择登录的身份。
   2. 点击【我是用户】按钮，正常登录小程序。
   3. 点击【我是商户】按钮，跳转到“门店页”。

门店页

门店页

1. 顶部展示门店名。
2. 点击【扫码核销】按钮，向用户申请相机权限，同意后打开相机。
   1. 只能使用拍照功能，不能打开相册。
   2. 识别到二维码后，自动识别，二维码可核销时，弹出“核销确认弹窗”。

核销确认弹窗

• • 1. 点击【确定】按钮，核销该优惠券，弹出“核销成功弹窗”。用户端页面自动更新。

核销成功弹窗

• • 1. 点击【取消】按钮，关闭弹窗。

    2. 识别到错误的二维码或核销失败时，弹出“核销失败弹窗”，并展示失败原因。

核销失败弹窗

1. 点击【券码核销】按钮，弹出“券码核销弹窗”。

券码核销弹窗

• 1. 输入券码，点击【确定】开始验证 ——
     1. 验证通过，弹出“核销确认弹窗”。
     2. 验证失败，弹出“核销失败弹窗”。

1. 点击【核销记录】按钮，跳转至核销记录页。

券码记录页

• 1. 展示优惠券名称、核销时间、核销类型、券码、优惠券类型、手机号。