聚猫APP线下核销平台开发源码搭建

聚猫APP线下核销平台开发源码搭建，聚猫APP线下核销平台开发源码搭建，聚猫APP线下核销平台开发源码搭建

聚猫 APP 线下核销平台开发方案

整体架构分为用户端 APP、商户端（核销端）、运营管理后台，以广告做任务领积分、积分兑换饮水权益、线下门店扫码核销为核心流程，聚焦线下核销全链路落地。

一、整体业务流程

用户登录 APP → 观看广告 / 完成任务获取积分 → 积分兑换饮水券 / 商品 → 生成动态核销码 → 到线下合作门店出示二维码 → 商户端扫码核验并完成核销 → 平台同步扣减积分、记录核销流水、商户生成对账数据。

二、用户端 APP（核销相关核心功能）

1. 基础账号与个人中心

支持手机号、微信登录；游客无法兑换、核销、获取积分。个人中心展示：积分余额、积分明细、待核销券、已核销记录、过期券、附近门店、订单、客服。

2. 积分获取模块

全点位对接广告联盟 SDK，有效观看 / 完成任务发放积分，包含开屏、激励视频、插屏、信息流、每日签到、试玩 / 问卷任务；支持积分不足时弹窗补分。后台可配置单任务积分、单日获取上限、积分有效期。

3. 积分兑换商城

1. 商品品类：瓶装水、桶装水、直饮水券等，标注所需积分、规格、单人单日兑换限额、平台总库存。

2. 兑换流程：选品→确认兑换→扣减积分→生成动态电子核销券（含唯一核销码、有效期、使用门店范围）。

3. 券状态管理：区分待核销、已核销、已过期、已作废，每张券记录兑换时间、有效期。

4. 线下门店与核销导航

1. LBS 定位：自动定位，展示周边合作门店列表，显示门店名称、距离、营业状态、当日可核销余量。

2. 门店详情：地址、联系电话、营业时间、可核销商品类型。

3. 核销入口：在券详情页直接调出二维码，支持放大、刷新二维码。

5. 核销记录

按时间倒序展示全部核销记录，包含门店名称、核销时间、商品、券编号、状态，支持筛选查询。

三、商户端（线下核销终端）

分为商户独立 APP和H5 轻版两种形态，适配手机、扫码枪设备。

1. 账号登录

商户专属账号密码登录，账号由平台统一开通、禁用、权限配置；单门店可开设多个子账号（店员）。

2. 核心扫码核销

1. 两种核验方式：相机扫码、外接扫码枪扫码。

2. 扫码校验逻辑：自动识别核销码，实时请求服务端校验：

3. 码有效 + 在有效期内 + 门店匹配 + 商品库存充足 → 核销成功，提示确认，同步扣券、扣积分、记录流水；

4. 无效码、已核销、已过期、跨门店、库存不足 → 弹出对应错误提示，禁止核销。

5. 单次核销完成后，自动生成核销小票（可选纸质打印）。

3. 门店库存管理

1. 自主设置当日各类饮水商品可核销数量上限，库存耗尽自动停止对应品类核销。

2. 实时查看当前剩余库存、今日已核销数量。

3. 支持临时下架某类商品、暂停营业。

4. 核销流水查询

1. 按日期、时间段查询本店全部核销订单，展示券编号、用户信息、商品、核销时间、操作人。

2. 支持单条记录查看、批量导出流水。

5. 对账与结算

1. 查看周期内核销总量、待结算数据、已结算记录。

2. 查看平台结算规则、结算周期、账单明细。

6. 消息通知

接收平台公告、活动通知、库存预警、结算提醒、规则变更通知。

四、运营管理后台（全平台管控）

1. 商户管理

1. 商户入驻申请审核、新增 / 编辑 / 禁用商户账号。

2. 门店信息维护：名称、地址、联系方式、经纬度、营业范围、可核销品类。

3. 门店分组、区域划分，按区域管理商户。

4. 配置门店核销权限、每日核销额度、结算比例与结算周期。

2. 核销券 & 订单管理

1. 查看全平台所有兑换券、核销券，支持按状态、时间、门店筛选。

2. 异常券处理：手动作废、延期、补发。

3. 全局监控核销流水，追溯问题订单。

3. 商品与积分配置

1. 饮水商品上下架、积分定价、全局库存、单人 / 单日兑换限额配置。

2. 统一配置广告积分规则、积分有效期、抵扣逻辑。

4. 广告 SDK 管理

多广告联盟密钥、广告位配置、频次控制、轮播策略、广告数据统计。

5. 用户管理

用户账号查询、积分调整、异常账号冻结 / 封禁、行为日志查看。

6. 风控配置

1. 核销限制：同账号单日大核销次数、同设备 / 同 IP 核销频次限制。

2. 黑名单：违规门店、违规用户加入黑名单，禁止核销与使用。

7. 数据报表

统计维度：用户兑换量、全平台核销量、单门店核销量、商品核销占比、时段核销峰值、券过期率等，支持报表导出。

五、核销核心技术逻辑与 SDK 对接

1. 核销码规则

1. 采用动态一次性核销码，设置固定有效期（小时 / 天），核销后立即失效，不可重复使用。

2. 码内加密包含：券 ID、用户 ID、商品 ID、可用门店范围、有效期，服务端多重校验防伪造。

2. 广告 SDK 对接

1. 接入主流聚合广告 SDK 及直连广告源，配置预加载、多源轮播。

2. 仅广告有效完成回调后发放积分，广告中途关闭、秒关不计奖励。

3. 统一以广告联盟后台有效数据作为对账依据。

3. 接口交互逻辑

1. 用户端请求生成核销券 → 服务端校验积分 → 扣积分、生成加密券码并返回。

2. 商户端扫码上传码数据 → 服务端做多维度校验（有效性、有效期、门店、库存）→ 返回结果并更新状态。

3. 所有核销、兑换、积分变动实时落库，保证数据一致性。

六、风控体系

1. 设备风控：拦截模拟器、多开、ROOT 设备，限制异常设备生成核销码、参与兑换。

2. 核销风控：禁止一码多刷、跨门店核销、过期券核销；限制单账号单日核销次数。

3. IP 风控：同一 IP / 网段限制批量兑换、批量核销。

4. 门店风控：监控门店异常高频核销、虚假核销，发现后冻结门店权限。

5. 积分风控：监控积分异常增减、批量刷积分行为，及时冻结账号。

七、技术选型

1. 用户端 APP：uni-app/Flutter 跨端，集成 LBS 定位、二维码生成 / 扫码组件。

2. 商户端：轻量 H5（快速部署）或原生简易 APP（适配扫码枪、打印）。

3. 服务端：Java/Go + MySQL + Redis，支撑高并发扫码核销、积分流水、订单查询。

4. 第三方组件：聚合广告 SDK、定位 SDK、二维码编解码组件、打印组件（商户端）。

八、合规要求

1. 平台完成 ICP 备案，APP 及商户端公示用户协议、隐私政策、兑换规则、核销规则。

2. 明确核销券有效期、使用范围、不退不换等规则。

3. 保护用户信息与核销数据，不违规泄露用户及门店信息。

4. 线下商户留存入驻资质，规范线下服务流程。

5. 广告内容合规，杜绝违规广告及跳转链接。