支付宝碰一下对接 2 期_N6D_优化需求

铺设目标柜机清单 · 子菜单功能

V2.1 2026-04-21 产品经理:张常常 P0

需求概览

4
核心功能点
P0
优先级
1
新增页面

背景与目标

🔍 现存问题

⚙️

技术实现依赖手工操作

白名单数据存储在 Redis 缓存中,目前增删改查都需要研发手工处理

📈

高频修改需求

实际业务中对白名单有频繁的修改需求,研发手工处理效率低、响应慢

🎯 核心目标

实现用户自主修改、导出白名单,减少对研发的依赖,提升运营效率。

功能详情

新增柜机编码

支持单个或批量新增柜机编码至白名单,支持粘贴导入

P0
🗑️

删除柜机编码

支持单个删除或批量勾选删除,删除前二次确认

P0
🔍

查询柜机编码

输入单个编码,快速查询是否在白名单中

P0
📥

导出柜机清单

一键导出所有柜机编码至 CSV 文件

P1

菜单位置

📁 支付宝碰一下
├── 用户碰一下访问日志
├── 碰一下设备绑定管理
├── 业务控制开关
└── 铺设目标柜机清单 ← 新增

异常处理

编码已存在

提示"XX已存在,无需重复添加",跳过该编码

格式错误

提示"编码格式错误",标红错误行

空输入

禁止提交,提示"请输入柜机编码"

批量导入-部分柜机已存在

能新增的先新增,重复的跳过。提示"新增成功 X 条,跳过 Y 条已存在的柜机编码"

页面原型

铺设目标柜机清单
柜机编码 录入时间 操作
FC7550001 2026-04-20 14:30:22
FC7550002 2026-04-20 13:15:08
FC7550003 2026-04-19 16:45:33

交互流程

新增柜机编码

点击「新增柜机」
选择录入模式
输入编码
系统校验
保存成功

删除柜机编码

勾选条目
点击「删除选中」
二次确认
执行删除
刷新列表

数据设计

📊 数据表设计

字段名 类型 描述 约束
id bigint 主键 自增
cabinet_code varchar(32) 柜机编码 唯一索引,非空
created_at datetime 录入时间 非空,默认当前时间
created_by varchar(64) 录入人 非空

🔌 接口设计

接口 方法 描述
/api/cabinet-whitelist/list GET 分页查询白名单
/api/cabinet-whitelist/add POST 新增柜机编码
/api/cabinet-whitelist/delete POST 删除柜机编码
/api/cabinet-whitelist/check GET 查询单个编码状态
/api/cabinet-whitelist/export GET 导出白名单

📋 编码格式规范

格式:英文字母 + 数字组合
长度:8-16 位
示例:FC7550001

风险与依赖

⚠️ 风险评估

数据误删风险

影响程度:高 | 措施:二次确认 + 操作日志追溯

批量导入性能

影响程度:中 | 措施:分批处理,异步执行

🔗 依赖项

  • 📦 依赖现有「支付宝碰一下」菜单结构
  • 📦 依赖通用组件(弹窗、分页、表格)
  • 📦 白名单采用数据表存储

📄 PRD V2.1 | 支付宝碰一下对接 2 期_N6D_优化需求 | 2026-04-21