PRDv1.6 · 33 · 23 → 33

充值限额配置快捷金额 · PRD

作者 Luke　版本 v1.6　日期 2026-09-17　状态 进行中　平台 BRAND_A & BRAND_B　类 M
需求关系 需求 23 的迭代　前置需求 需求 23 PRD HTML · 需求 23 BO 原型 HTML　迭代路径 23 → 33

版本记录
版本 日期 变更摘要
v1.6 2026-09-17 收口 PRD 内部一致性：将 G1 与 AC2 限定为「完整覆盖记录」，与 G4、AC7 的旧记录相容例外保持一致。
v1.5 2026-09-17 更新 L0、§3 与 AC 追踪：明确完整覆盖记录不走基本配置，旧记录无快捷金额依 §4.3 作为唯一相容例外；同步修正原型章节与 AC 对照。
v1.4 2026-09-17 更新 L0 交付：修正 PRD HTML 的目录，将未转换的 [TOC] 替换为可点击章节导航；Client 原型新增统一的 中文｜EN 双语切换，手机产品画面维持英文。
v1.3 2026-09-17 更新 §3 与 AC：Client 原型可输入并 Apply 快捷金额；线上通道 Confirm 显示 Method／Total、Go 以 Amount accepted 表示跳转前终点；Venue 显示 24 小时场馆付款提示。
v1.2 2026-09-17 更新 L0 与全档翻译交付：English PRD 补齐与中文相同的版本记录、目录、§1–§5、L2 与两份附录；Client 回归 UI 低保真、UX 高保真模板。
v1.1 2026-09-17 更新 L0、§1 与 §3：拆分中英文资讯图、以 6 个按钮示意每行 4 个自动换行、补齐需求 23 HTML 溯源，并明确命中限额配置后首充／非首充均不读取基本配置。
v1.0 2026-09-17 初版。§1–§5 以需求 23 的「充值方式 × 总代」限额记录为前置，为每笔记录新增快捷金额；玩家命中覆盖记录时，限额与快捷金额取自同一笔记录。
目录

L0 · 快速掌握

充值限额配置快捷金额资讯图表

① 一句话需求

在需求 23 的总代限额新增／修改表单中增加 快捷金额，让每笔「充值方式 × 总代」记录同时决定客户端的充值上下限与快捷金额按钮。

只要该充值方式命中已有快捷金额的完整总代限额配置，不论玩家是首充或非首充，充值限额与快捷金额都读取这笔配置，不走基本配置。唯一例外是本需求上线前尚无快捷金额值的旧记录，依 §4.3 暂时回退基本配置快捷金额。

本需求是需求 23 的后续迭代。需求 23 保持原版归档；新增规则、原型与验收全部由需求 33 承接。

② 术语写死表

词 唯一含义
覆盖记录 需求 23 建立的一笔「充值方式 × 总代」限额记录。
快捷金额 客户端充值金额栏上方的金额按钮清单。
基本配置 覆盖记录不存在时，客户端现行读取的充值限额与首充快捷金额来源。
旧记录 本需求上线前已存在、只有最小／最大限额而没有快捷金额的覆盖记录。

③ 全局红线表

不变量 违反后果 验证锚点
G1 命中完整覆盖记录（已有快捷金额）时，最小限额、最大限额与快捷金额取自同一笔记录 按钮与可充值区间来自两套配置 AC1 AC2
G2 快捷金额只用英文逗号分隔；各项是 1–50000 正整数并落在同笔限额区间内 保存无效或永远不会显示的按钮 AC3 AC4
G3 快捷金额数量不设业务上限；去重保序，不自动排序或截断 运营配置被改写 AC5 AC6
G4 无覆盖记录、旧记录无值或覆盖读取失败时，快捷金额维持既有基本配置行为 上线后旧用户按钮消失 AC7 AC8
G5 客户端保留既有上下限校验与提示语 新功能绕过充值限额 AC9 AC10

④ 适用范围与「不做」边界

本期只扩充需求 23 的限额新增、单条修改、批量修改、读取、删除回落与管理员日志，并调整客户端快捷金额按钮来源。不修改需求 23 已完成的账号解析、权限点、限额优先级、删除模型、分页与提示语；不修改基本配置；不新增客户端金额错误文案；不限制快捷金额数量。

1. 前置与页面

1.1 前置依赖

1.1.1 需求 23 的现行交付物保持不变，本需求只引用其规则：需求 23 PRD HTML／需求 23 BO 原型 HTML。点击后另开分页；若本档未改写某项行为，继续以需求 23 为准。

1.2 新增表单

1.2.1 在 单笔最小限额、单笔最大限额 下方新增一行：

栏位 控件 必填 栏内提示
快捷金额 单行文字栏 是 请用英文逗号分隔多个金额

1.2.2 一次新增多个总代时，所有成功写入的覆盖记录共用本次限额与快捷金额；批量中的对象剔除与部分成功继续沿用需求 23。

1.3 修改弹窗

1.3.1 单条与批量修改弹窗在两个限额栏下方增加同一个 快捷金额 文字栏。它与既有金额栏一样打开时留空、提交必填。批量修改后，全部成功对象改为本次输入的同一组限额与快捷金额。

2. 快捷金额输入规则

2.1 解析

2.1.1 前后端使用同一条管线：

  1. 只以英文逗号 , 分隔。
  2. 去除每项前后空白；跳过开头、结尾或连续逗号产生的空项。
  3. 各项转成整数后按数值去重，保留第一次出现的位置。
  4. 保存顺序就是客户端显示顺序，不自动由小到大排序。
  5. 清洗后至少一项；金额数量不设业务上限。

2.2 校验

2.2.1 每个非空项目都必须同时符合：

  • 只含数字，且为 1–50000 正整数；
  • 不使用负号、小数点、千分位或中文逗号；
  • 大于等于同次提交的 单笔最小限额；
  • 小于等于同次提交的 单笔最大限额。

2.2.2 任一非空项目不合法就阻断整次新增／修改，不跳过非法金额；不影响页面上其他既有对象类部分成功规则。

2.2.3 合法示例：100,200,300,500,1000,2000,3000,5000,10000,20000,30000,50000。

3. 客户端取值与显示

3.1 取值顺序

覆盖记录 快捷金额资料 限额来源 快捷金额来源
有 有（状态：命中覆盖且有快捷金额） 该覆盖记录 同一笔覆盖记录
有 旧记录无值（状态：旧记录无快捷金额） 该覆盖记录 基本配置既有首充快捷金额
无（状态：未命中覆盖） — 需求 23 既有基本配置规则 基本配置既有首充快捷金额
覆盖读取失败 — 需求 23 既有降级规则 基本配置既有首充快捷金额，并写运行日志

3.1.1 只要该充值方式命中玩家所属总代、且该记录已有快捷金额，不论首充或非首充，充值限额与快捷金额都读取同一笔覆盖记录，不走基本配置；不得因玩家类型不同而重新读取基本配置按钮。旧记录尚无快捷金额值时，才依 §4.3 暂时回退基本配置快捷金额。

3.2 客户端呈现

3.2.1 玩家进入充值页或切换充值方式时读取本次有效的最小限额、最大限额与快捷金额。快捷金额依保存顺序排列，每行四个并自动换行；数量再多也不截断或分页。

3.2.2 点击快捷金额按钮，只把该值写入既有金额输入栏；玩家仍可手动输入金额。

3.2.3 客户端防御性过滤不在本次有效最小／最大限额内的异常快捷金额。该过滤不能取代后台保存校验。

3.3 金额校验

3.3.1 玩家提交金额时继续执行现行数字与区间校验：小于有效最小限额显示既有最小值提示，大于有效最大限额显示既有最大值提示。提示文字、Toast／Inline 呈现及阻断行为都不因本需求改变。

3.3.2 金额校验通过后，依充值方式分流：

  • 选中 Maya、GCash、QRPh 等线上通道时，点击 Confirm 显示既有充值确认弹窗，弹窗列出本次 Method 与 Total；点击 Go 才进入三方付款流程。Client 原型不模拟外部页面跳转，只以 Amount accepted Toast 表示流程已走到跳转前的验收终点；该 Toast 是原型辅助状态，不新增正式产品文案。
  • 选中 Venue 时，点击 Confirm 显示既有场馆付款提示弹窗，不显示 Method／Total 或 Go；弹窗内的 Confirm 只关闭提示。
场景 现行逐字文案
小于最小限额 The deposit amount cannot be less than the minimum amount
大于最大限额 The deposit amount cannot be greater than the maximum amount
金额栏 Inline Please enter the correct amount
Venue 充值请求已送出 We have got your deposit request, kindly pay at the gaming venue within 24 hours. Or your deposit request could be automatically invalid.

4. 生效、删除与相容

4.1 生效

4.1.1 新增或修改成功后，下一次进入充值页或切换充值方式时读取新快捷金额；已经打开的页面不强制即时刷新。提交时仍由既有后端限额校验兜底。

4.2 删除与联动

4.2.1 删除覆盖记录时，快捷金额与限额一起回落基本配置。停用充值方式仍保留快捷金额；物理删除充值方式时，快捷金额随覆盖记录在同一事务删除。取消渠道分配不删除资料，重新分配后恢复生效。

4.3 旧资料

4.3.1 不批量回填旧覆盖记录。旧记录的限额继续生效，快捷金额维持读取基本配置；运营下次修改时，快捷金额栏必填，保存后升级为完整记录。

5. 权限、提示与留痕

5.1 权限

5.1.1 不新增权限点。新增时沿用 充值方式管理_设置限额新增；单条与批量修改沿用 充值方式管理_设置限额修改；读取与页面入口沿用 充值方式管理_设置限额。前后端都必须复核。

5.2 后台提示语

场景 逐字文案 呈现
快捷金额未填／清洗后无金额 请填写完整 Inline；沿用需求 23
快捷金额格式或值域错误 快捷金额请输入 1-50000 的正整数，并以英文逗号分隔 Inline
快捷金额超出本次限额 快捷金额需介于单笔最小限额与单笔最大限额之间 Inline
成功 操作成功 弹窗；沿用需求 23
列表无资料 No More Data 空状态；沿用需求 23

5.3 留痕

5.3.1 新增、单条修改、批量修改、删除与充值方式连带删除的管理员操作日志，都将快捷金额列入前后值。批量仍记一条汇总与对象 ID 清单，不新增备注栏。

L2 · 验收与附录

附录 A：验收标准
# P 验收点
AC1 P0 （G1）同一充值方式下，总代 A、总代 B 可保存不同快捷金额；各自下线只取得自己的记录。
AC2 P0 （G1）命中已有快捷金额的完整覆盖记录时，限额与快捷金额来自同一记录，不再读取基本配置快捷金额。
AC3 P0 （G2）快捷金额接受 1、50000 及有效区间端点；拒绝 0、负数、小数、50001、千分位与中文逗号。
AC4 P0 （G2）任一快捷金额小于本次最小限额或大于本次最大限额，整次提交阻断。
AC5 P0 （G3）十二个示例金额全部保存并依原顺序显示，不截断。
AC6 P0 （G3）100, 200,,100,50000, 清洗为 100／200／50000，不自动排序。
AC7 P0 （G4）旧记录无快捷金额时，限额仍取覆盖记录、快捷金额继续取基本配置；修改后改取新值。
AC8 P0 （G4）无记录、读取失败或删除记录时，快捷金额回落基本配置；读取失败写运行日志。
AC9 P0 （G5）客户端每行四个按钮并自动换行；点击按钮只填值，手动输入仍可使用。
AC10 P0 （G5）小于最小值与大于最大值分别显示现行提示；异常区间外按钮被防御性过滤。
AC11 P1 批量新增与批量修改将同一快捷金额清单写入全部成功对象。
AC12 P1 缺新增／修改权限时，快捷金额与限额请求一起被前后端拒绝。
AC13 P1 Client 原型可输入英文逗号分隔的快捷金额并 Apply；新按钮立即依每行四个显示，点击后回填金额栏。Maya／GCash／QRPh 的 Confirm 显示 Method／Total，Go 显示 Amount accepted；Venue 的 Confirm 显示 24 小时场馆付款提示。
附录 B：原型视觉清单

原型视觉清单

视觉 ID 载体 用途 证据
VIS-BO-NONE BO 后台原型不使用图片或图片占位 表单、列表与弹窗均为 HTML 控件
VIS-CLIENT-001 Client Maya 充值方式 Logo 的灰阶占位 手机画面充值方式按钮内的线框占位块
VIS-CLIENT-002 Client GCash 充值方式 Logo 的灰阶占位 手机画面充值方式按钮内的线框占位块
VIS-CLIENT-003 Client QRPh 充值方式 Logo 的灰阶占位 手机画面充值方式按钮内的线框占位块
VIS-CLIENT-004 Client Venue 充值方式 Logo 的灰阶占位 手机画面充值方式按钮内的线框占位块

文档版本：v1.6 | 日期: 2026-09-17 | 作者: Luke | 文档状态：进行中