埋点系统产品需求文档 V2.13.9（通知变量精简版）#

本版本以【埋点系统 V2.12.0】为唯一功能基线，V2.12.0 未声明变更的功能、口径、权限和非功能要求继续有效。本文件定义财务管理新增的人工优惠与自动优惠能力。

0. 文档信息与变更记录#

1. 背景与目标#

1.1 业务背景#

客服补偿、VIP 关怀、新客召回和临时运营奖励目前缺少统一的配置、批量处理、领取条件、充值触发和审计记录。运营需要通过会员 ID 或会员分组快速赠送金额，也需要把“注册后限定时间仍未充值”的会员转化为可持续运行的自动奖励人群。

1.2 产品目标#

• 为单个会员、Excel 名单或会员分组创建人工优惠任务。
• 统一配置奖励金额、稽核流水、前后台备注及领取方式。
• 支持自动到账、弹窗领取、充值后领取三条互斥的奖励链路。
• 人工优惠与自动优惠模板的弹窗领取支持固定倍数或按充值金额阶梯计算的奖励加倍。
• 支持在人工优惠页面直接管理充值加倍模版，并配置固定倍数或随机倍数档位。
• 允许为加倍奖励稽核选择参与计算的游戏类型与游戏标签。
• 统一人工优惠页面与埋点系统既有后台样式，减少装饰性容器，以输入效率、字段识别和长表单可读性为优先。
• 移除人工优惠创建页顶部重复的“人工优惠派奖”展示模块，让页签后直接进入任务配置步骤。
• 参考用户提供的打码量样式，将稽核流水类型改为圆形单选；标题与选项同一行，对应输入框在下一行铺满并贴合现有后台视觉。
• 将稽核倍数/数值输入框收窄到与存入金额输入框相同的第一列宽度，使两个字段左右边缘对齐；820px 以下恢复整宽。
• 为批量会员 Excel 导入提供可直接下载的标准模版，并明确仅接收 xls、xlsx 且文件不超过 15MB。
• 将弹窗领取和充值后领取的期限字段统一为【奖励过期时间】，按天输入、支持小数，并从奖励获得时间开始计算自动作废时点。
• 在人工优惠创建链路新增步骤 04【配置系统通知】，提供人工优惠专用通知模版，允许编辑标题、正文并通过开关决定本次任务是否发送。
• 统一人工优惠和自动优惠的通知正文变量白名单，仅允许用户名 {userName} 与奖励金额 {rewardAmount}，并在内容输入框下直接提示可用变量。
• 配置预览覆盖赠送对象、金额、稽核、备注、领取、过期、加倍、游戏参与及系统通知等当前有效配置，并随输入实时更新。
• 移除创建页【草稿】状态提示与【保存草稿】按钮，人工优惠任务只允许确认后正式创建。
• 重构人工优惠活动记录页，提供已领取奖励金额指标、任务编号/领取方式/任务状态/时间筛选和七个快捷时间入口。
• 在任务级列表完整展示加倍、稽核、派发、领取、充值、金额、状态、备注及操作信息，并支持查看会员、详情和作废。
• 通过会员明细弹窗按会员 ID、领取状态和奖励加倍开关查询，展示会员级奖励链路并按当前筛选结果导出。
• 去除已领取奖励金额卡片的强调背景，任务记录移除订单号列，倍数列只显示数值，并将操作固定在最右列。
• 将会员弹窗筛选条件、重置和查询排成同一行并去除外层背景框；会员列表增加固定末列【作废】及会员级二次确认。
• 在任务列表直接展示领取方式，默认使用【全部】时间范围，使自动领取、弹窗领取、充值后领取以及已完结、进行中、已作废记录均可直接查看和筛选。
• 从任务详情移除任务级订单编号，仅保留任务编号作为任务级唯一展示标识；会员奖励订单编号继续在会员明细中展示。
• 统一居中弹窗及右侧抽屉的尺寸、标题区、内容滚动区和底部操作区，消除错位、拉伸和内容叠层。
• 通过自动模板识别“注册限时未充值”会员，自动创建奖励。
• 将自动优惠模板重构为目标人群、奖励与稽核、领取方式、系统通知、生效与风控五步配置，并提供完整配置预览。
• 自动优惠模板第 03 步统一提供自动领取、弹窗领取、充值后领取；充值后领取支持单笔或累计充值、目标充值金额及奖励过期时间。
• 提供模板名称、编号、状态、触发人群和领取方式查询，补充今日已领取金额，并以十七列模板列表展示累计、今日和操作审计数据。
• 统一模板状态为运行中、已暂停、已关闭；运行中可暂停或关闭，暂停后可启用或关闭，关闭后只能查看灰显只读详情。
• 模板列表不提供编辑入口；详情沿用完整五步配置结构但所有控件禁用，并移除【适用会员分组】字段。
• 新增与详情统一不再使用【适用会员分组】；自动模板保存对象不得携带会员分组字段，目标人群只由触发类型、未充值时长和生效范围定义。
• 将自动优惠活动记录调整为“筛选条件—动态看板—会员奖励订单列表”的操作顺序，看板按已提交命中时间和其他筛选条件同步聚合。
• 拆分会员 ID、订单号、模板名称、触发人群、领取方式、领取状态和命中时间七项筛选，列表扩展为二十一列并补齐稽核金额、关联订单与实际领取金额。
• 支持对待领取或等待充值的会员奖励订单进行二次确认作废，并通过详情抽屉查看注册、命中、基础奖励、充值、加倍和稽核完整链路。
• 对任务、会员处理结果、充值判定、领取、加倍和失败原因形成完整记录。

1.3 非目标#

• 本版本不新增现金提款审核规则。
• 本版本不支持优惠模板之间自动叠加、互斥优先级编排或 A/B 实验。
• 本版本不允许修改已经创建或已经命中会员的奖励金额和领取条件。
• 本版本不改变 V2.12.0 原有埋点系统 10 个页面和 104+16 事件基线。

2. 信息架构与权限#

2.1 菜单结构#

2.2 权限矩阵#

金额权限继续继承后台角色的单笔金额、单日累计金额和会员分组范围。超出权限时禁止提交，不允许通过拆分批次规避限制。

3. 公共业务定义#

3.1 会员与批量对象#

黑名单、风控冻结、自我排除、已注销和币种不一致会员默认排除并记录失败原因。批量任务中单个会员失败不得阻塞其他有效会员。

3.2 金额与精度#

• 所有金额使用当前站点币种，原型站点为 PHP。
• 存入金额必须大于 0，最多保留 2 位小数；金额上限由站点和角色权限共同决定。
• 后端使用十进制定点数，不使用浮点数计算奖励。
• 每次钱包入账必须生成唯一账变单号，并使用任务号 + 会员 ID + 奖励阶段作为幂等键。

3.3 稽核流水#

基础奖励与加倍奖励分别建账、分别记录稽核要求。加倍奖励的稽核倍数只作用于加倍奖励金额。

3.4 奖励加倍口径#

• 奖励加倍仅在开关开启时生效。
• 触发起点为基础奖励已到账或已领取；起点前的充值订单不计入。
• 仅取起点后的第一笔充值成功订单进行加倍计算；失败、取消、冲正订单不计入。
• 固定倍数：额外加倍奖励 = 基础奖励金额 × 配置倍数。
• 按充值金额加倍：根据第一笔充值成功金额命中模板档位，额外加倍奖励 = 基础奖励金额 × 档位倍数，并受档位单次上限约束。
• 同一基础奖励最多产生一笔加倍奖励。加倍入账失败时允许后台按原幂等键重试，不得重复入账。

3.5 加倍模版与游戏参与口径#

• 加倍模版分为【按充值金额固定倍数】和【按充值金额随机倍数】。
• 每个档位的充值金额必须大于 0、按升序排列且不可重复；订单金额命中“小于或等于该金额的最高档位”。
• 固定倍数档位配置充值金额和加倍倍数；随机倍数档位配置充值金额、最小倍数、最大倍数和期望倍数。
• 随机倍数必须满足 最小倍数 ≤ 期望倍数 ≤ 最大倍数；实际结果保留 2 位小数，并保存模版版本、随机结果及可审计的随机摘要。
• 加倍奖励稽核只统计【游戏参与】范围内的有效投注。游戏类型之间为 OR；游戏标签之间为 OR；同时配置类型和标签时两组条件为 AND。
• 全选游戏类型且游戏标签为空等同于全部游戏。模版或人工任务提交时固化游戏范围快照，后续游戏分类或标签变化不追溯。

3.6 系统通知口径#

默认标题为“🎁 您已获得人工优惠奖励”。默认正文使用人工优惠活动语义，只引用会员名称和奖励金额，不引用领取方式、奖励过期时间，也不沿用注册成功模版的注册、首充或账号信息文案。

3.7 V2.13.9 视觉与布局规范#

4. 人工优惠活动#

4.1 页面目标#

通过单个会员 ID、Excel 名单或会员分组创建人工优惠任务，配置奖励、稽核、备注及领取链路，并在提交前预览完整规则。

4.2 页面操作链路#

4.3 字段与筛选条件#

4.4 功能明细#

4.5 领取方式#

4.5.1 自动领取#

任务通过校验后直接写入会员钱包。成功状态为【派发完成】；钱包失败状态为【派发失败】，允许有权限人员重试。该方式不需要奖励过期时间，也不支持前台手动领取。

4.5.2 弹窗领取#

会员前台只展示当前有效、未领取奖励。领取接口必须防重复提交；领取成功后基础奖励立即入账。奖励加倍开启时，从基础奖励入账成功时间开始等待第一笔充值成功订单。

4.5.3 充值后领取#

充值后领取不再配置【充值有效期】，改为配置与弹窗领取一致的【奖励过期时间】。该字段为必填天数，必须大于 0、支持小数；从奖励获得时间开始按 天数 × 24 小时 计算。到期前仍未触发奖励派发的会员记录自动作废。

充值失败、取消、超时和支付中订单不参与判定。冲正或退款发生在奖励入账前时，从累计金额中扣除；奖励已入账后的资金追回走现有风控和账变流程，本版本不自动扣回。

5. 人工优惠活动记录#

5.1 顶部汇总指标#

5.2 页面操作链路#

5.3 任务筛选条件#

5.4 任务状态口径#

5.5 任务列表字段#

5.6 会员数据弹窗#

5.6.1 筛选条件与操作#

桌面端三个筛选条件与【重置】【查询】必须在同一行排列；筛选区不使用背景色、边框或卡片容器，仅以标签和控件层级区分。窄屏下允许按响应式规则换行。

5.6.2 列表字段#

5.7 任务详情与作废#

6. 自动优惠活动#

6.1 用户定义：注册限时未充值#

同时满足以下条件的会员进入候选集：

1. 当前站点存在注册成功结果，注册时间以服务器成功时间为准。
2. 从注册成功到模板配置的限定时长结束，仍不存在充值成功订单。
3. 会员处于正常状态，不在黑名单、风控冻结和自我排除范围。
4. 同一会员从未命中过同一模板版本；模板停用期间不补发历史漏扫用户，重新启用只处理重新启用后的扫描候选。

6.2 页面操作链路#

6.3 筛选条件#

6.4 顶部指标#

6.5 模板列表字段#

模板列表按最近操作时间倒序，表格允许容器内横向滚动，操作列固定在最右侧。

6.6 配置字段与功能明细#

6.7 V2.13.7 新增模板字段校对清单#

7. 自动优惠活动记录#

7.1 页面操作链路#

7.2 筛选条件#

7.3 顶部指标#

筛选区位于看板上方。点击【查询】后，五项指标必须按已提交的命中时间范围及全部其他筛选条件重新聚合；点击快捷时间仅回填日期，仍以点击查询作为聚合刷新时点。

7.4 记录列表字段#

记录列表按命中时间倒序，操作固定在最右侧。

7.5 功能明细#

8. 状态机与异常规则#

8.1 人工任务状态#

8.2 关键异常#

9. 数据、接口与审计#

9.1 核心数据对象#

9.2 接口要求#

• 创建接口必须接收客户端幂等键并返回稳定的任务编号。
• 批量导入采用“上传解析—确认有效名单—创建任务”三阶段，不允许上传后直接入账。
• 充值判定消费充值成功结果事件，以订单号幂等；模板扫描读取注册成功与充值成功的业务事实。
• 人工优惠创建与自动模板保存接口在通知开启时必须接收完整 notification_config；服务端变量白名单只允许 userName、rewardAmount，并重新校验字符长度和信件类型，不信任客户端校验结果。
• 通知发送使用任务 ID + 会员 ID + 信件类型作为幂等键；通知失败不得回滚已完成的钱包入账，也不得触发重复派奖。
• 人工优惠记录列表接口必须支持任务编号、领取方式、聚合任务状态和操作时间范围筛选，并返回 22 个任务级展示字段；任务级订单号不在列表和详情返回，领取方式作为独立列表字段，加倍倍数和稽核倍数使用无单位数值；人数和金额汇总必须能与会员明细对账。
• 会员明细接口必须限定 task_id，支持会员 ID、领取状态和加倍开关筛选，返回 15 个展示字段；加倍倍数和稽核倍数使用无单位数值；关联充值订单可为一对多，列表展示主订单并允许详情获取全部订单。
• 会员导出使用已提交筛选快照，不读取未点击查询的输入值；导出文件必须带任务编号、站点、生成时间和操作人水印信息。
• 作废接口仅允许从进行中转为已作废，使用任务 ID + 状态版本号做并发控制；重复请求返回首次作废结果。
• 会员奖励作废接口仅允许待领取、等待充值状态转换为奖励作废，使用任务 ID + 会员 ID + 状态版本号做并发控制；与领取、充值回调并发时只能有一个原子状态转换成功。
• 自动模板列表接口必须分别支持模板名称、模板编号、状态、触发人群和领取方式筛选，并返回十七个展示字段；状态接口使用模板 ID + 版本号做并发校验，已关闭模板不得恢复为运行中。
• 自动模板保存接口接收目标人群、奖励、稽核、领取、加倍、游戏范围、系统通知、生效范围和风控配置；claim_config 支持自动领取、弹窗领取、充值后领取，充值后领取必须携带单笔/累计类型、目标充值金额和过期天数；请求体不得包含 member_group_id、member_group 或其他会员分组字段；保存后配置不可通过列表编辑，历史命中不得迁移配置。
• 自动模板列表和详情接口返回当前版本完整配置快照，但不返回适用会员分组展示字段；前端新增与详情使用相同字段结构，详情只读渲染且不提交更新请求。
• 自动记录接口必须拆分支持会员 ID、奖励订单号、模板名称、触发人群、领取方式、领取状态和命中时间范围筛选，并返回二十一个展示字段；看板接口使用同一已提交筛选快照返回扫描、命中、已赠送奖励金额、已领取奖励金额和已加倍人数。
• 自动记录详情接口必须按奖励订单号返回命中、基础奖励与稽核、充值与加倍、处理时间线四段数据；会员奖励作废接口仅允许待领取或等待充值转换为奖励作废，并使用订单号 + 状态版本号进行并发控制。
• 自动记录导出使用最近一次已提交筛选快照，不读取未查询输入；导出范围覆盖全部匹配数据，不受当前页码限制。
• 列表使用服务端分页；导出使用已提交筛选快照，不读取页面未提交输入。
• 所有时间存 UTC，页面按站点时区展示；有效期比较也使用站点时区转换后的明确 UTC 时间。

9.3 审计日志#

必须记录创建、提交、取消、任务作废、会员奖励作废、查看任务详情、会员明细导出、通知启停与模版内容快照、通知发送结果、自动模板启停、模板版本变更、技术重试和导出。日志至少包含操作人、角色、站点、操作时间、对象编号、筛选快照、变更前后配置、权限快照、请求来源 IP 和结果。通知正文涉及会员变量时，审计查询按权限展示，导出遵循现有敏感信息脱敏规则。

10. 非功能要求#

11. 验收标准#

11.1 人工优惠#

1. 财务管理可进入【人工优惠活动】，顶部可切换到【人工优惠活动记录】。
2. 顶部页签下方直接显示步骤 01【选择赠送对象】，不得出现“人工优惠派奖”、MANUAL REWARD、必填项数量、领取方式数量或 T+0 概览模块。
3. 单个会员可通过会员 ID 创建奖励；批量可通过 Excel 或会员分组创建。Excel 上传区下方必须展示【下载模版】，点击后下载可正常打开的 .xlsx 文件，首列字段名为 member_id。
4. 稽核区域第一行展示【稽核流水类型】和圆形单选【倍数 / 自定义流水】，不得继续使用左右分栏或分段按钮卡片；选中态必须包含主色外圈与圆点。
5. 稽核选择倍数时，下一行输入显示“倍”后缀；选择自定义流水时原位切换为固定数值输入且不显示 PHP 或其他币种单位，帮助文案必须为“填写固定有效投注流水数值”；桌面端稽核输入框必须与存入金额输入框等宽且左右边缘对齐，820px 以下两者均占满容器。
6. 三个领取方式选择卡片采用紧凑尺寸；弹窗领取的奖励加倍说明和开关独占一行。
7. 按充值金额加倍可打开模版列表，并继续新建固定或随机倍数模版；动态增删档位和保存回填正常。
8. 游戏参与支持全选/多选游戏类型、选择游戏标签和预览；仅命中范围的有效投注计入加倍稽核。
9. 自动领取创建成功后金额自动到账，并生成唯一账变记录。
10. Excel 文件提示文案必须为“仅支持xls、xlsx格式的文件（大小：<=15MB）”；非 xls/xlsx 或超过 15MB 的文件不得进入导入解析。
11. 前台备注帮助文案必须为“展示给会员，最多 100字符”，输入长度上限为 100 字符。
12. 弹窗领取的【奖励过期时间】为带“天”后缀的数字输入，允许正小数；从奖励获得开始计算，到期前只能领取一次，到期后不可领取。
13. 充值后领取不得出现【充值有效期】或日期时间控件，必须使用与弹窗领取相同的【奖励过期时间】天数输入；奖励过期仍未触发时自动作废。
14. 奖励加倍关闭时不生成加倍条件；开启时固定倍数和按充值金额模版互斥。
15. 固定倍数与充值阶梯模版均按第一笔充值成功订单触发一次，并生成独立稽核要求。
16. 单笔充值以奖励过期前最先充值成功订单判断，低于目标立即作废；累计充值在奖励过期前达到目标时自动派发。
17. 批量任务单个会员失败不影响其他会员，记录页可查询和导出失败原因。
18. 所有主要输入控件高度统一为 40px；标签、输入值、帮助文字具有明确字号层级，桌面端两列表单边缘对齐。
19. 加倍模版列表、固定倍数编辑、随机倍数编辑和人工派奖确认弹窗均垂直居中，正文超高时只滚动内容区。
20. 固定倍数档位必须保持正常文档流，不得与档位校验提示、表头或弹窗底部操作区重叠。
21. 人工任务详情和自动优惠模板使用右侧抽屉；标题与底部按钮固定，滚动正文时底部操作始终可见。
22. 创建页必须在领取方式之后展示步骤 04【配置系统通知】；默认开启，切换关闭后收起信件类型、标题、正文和站内通知选项，并在配置预览显示“系统通知：关闭”。
23. 通知开启时可在【站内信 / 平台公告】之间切换；标题和正文可编辑，分别限制 100、1000 字符并显示实时计数；默认内容必须为人工优惠活动模版，不得包含注册成功或首充解锁语义。
24. 人工优惠通知正文只支持用户名 {userName}、奖励金额 {rewardAmount}；内容输入框下必须同时标识中文名称和变量占位符，默认正文不得出现 {claimMethod}、{expiryDays}；创建任务后保存模版快照，批量任务按会员独立渲染且发送幂等。
25. 【是否发送站内通知】可选择否或是，默认是；该选择与信件类型、通知开关一起进入任务详情和审计日志。
26. 右侧配置预览必须完整展示当前有效的赠送对象、金额、稽核、前后台备注、领取方式、过期时间、奖励加倍、加倍配置、游戏参与及系统通知摘要；编辑金额、通知类型或标题后实时更新。
27. 创建页和配置预览不得出现【草稿】标签、【保存草稿】按钮或其他草稿操作入口。
28. 人工优惠活动记录顶部必须新增【已领取奖励金额】指标，并与今日任务、覆盖会员、奖励金额、领取/到账率组成五个等高指标方块。
29. 记录筛选条件必须为任务编号、领取方式、任务状态和时间选择；领取方式枚举必须为全部、自动领取、弹窗领取、充值后领取，任务状态必须为全部、已完结、进行中、已作废。
30. 时间快捷选择必须完整包含今日、昨日、本周、上周、本月、上月、全部；点击后回填正确起止日期，手动修改日期时不得继续高亮错误的快捷项。
31. 任务列表必须按定义顺序展示 22 列，不得展示任务级订单号；【领取方式】必须直接展示自动领取、弹窗领取或充值后领取；加倍倍数、稽核倍数只显示数值且不得带“倍”；【操作】为最后一列并固定在表格右侧。
32. 点击【查看会员】必须打开居中弹窗；会员 ID、领取状态、是否开启加倍奖励、【重置】和【查询】在桌面端同一行，筛选区不得使用背景框。
33. 会员列表必须按定义顺序展示 15 列；加倍倍数、稽核倍数只显示数值且不得带“倍”；领取状态枚举必须为待领取、已领取、等待充值、奖励作废；筛选无结果时显示明确空状态。
34. 会员明细必须提供导出功能，导出范围使用最近一次点击【查询】形成的筛选快照，不受当前分页限制。
35. 点击【详情】必须打开参考人工优惠创建页字段结构的任务详情抽屉，完整展示任务信息、活动配置快照、执行汇总和处理时间线；详情不得展示任务级订单编号。
36. 仅进行中任务可点击【作废】；确认弹窗必须说明未完成奖励停止处理以及已到账奖励不自动追回；确认后列表状态立即更新为已作废。
37. 会员列表【操作】必须作为最后一列固定在右侧；待领取、等待充值会员可点击【作废】并看到二次确认，确认后状态立即变为奖励作废；已领取、奖励作废会员按钮禁用。
38. 记录页默认时间范围必须为【全部】，默认列表中自动领取、弹窗领取、充值后领取均至少有一条可见记录，已完结、进行中、已作废也均至少有一条可见记录。
39. 分别选择三种领取方式或三种任务状态并查询时，每个选项均必须返回与筛选条件一致的任务数据；每条任务均可打开详情，详情中的领取方式、状态和汇总值必须与列表一致。

11.2 自动优惠#

1. 财务管理可进入【自动优惠活动】，顶部可切换到【自动优惠活动记录】。
2. 自动优惠活动页必须展示运行中模板、今日扫描会员、今日命中会员、今日已赠送、今日已领取金额和加倍触发率六项指标；【今日已领取金额】口径为今日实际到账的基础与加倍奖励。
3. 模板筛选必须将模板名称和模板编号拆成两个输入框，并提供模板状态、触发人群、领取方式；重复提出的“模板状态”只实现一个控件。
4. 模板状态必须覆盖全部状态、运行中、已暂停、已关闭；触发人群覆盖全部和注册限时未充值；领取方式覆盖全部、自动领取、弹窗领取、充值后领取。
5. 模板列表必须按定义顺序展示十七列：模板编号、模板名称、状态、扫描频率、触发人群、基础奖励、领取方式、是否开启加倍奖励、奖励加倍、命中人数、已领取人数、今日命中人数、今日已领取人数、备注、操作人、操作时间、操作；操作固定在最后一列。
6. 列表至少覆盖运行中、已暂停、已关闭三种状态，累计人数、今日人数、备注、操作人和操作时间必须有可读示例数据。
7. 点击【新增自动优惠模板】打开约 820px 右侧宽版抽屉，按 01 目标人群、02 奖励与稽核、03 领取方式、04 系统通知、05 生效与风控顺序展示。
8. 新增与详情的 03【配置领取方式】必须同排展示自动领取、弹窗领取、充值后领取三张互斥卡片，结构与人工优惠一致。
9. 自动领取仅展示命中后立即到账说明，不展示奖励过期、奖励加倍或充值条件。
10. 弹窗领取必须展示可输入正小数的奖励过期时间；奖励加倍开关和固定倍数/按充值金额加倍配置只在该方式中出现。
11. 充值后领取必须支持单笔充值与累计充值、目标充值金额、奖励过期时间和对应判定说明；不展示奖励加倍配置。
12. 新增时可配置完整五步内容并保存启用；切换领取方式时，保存对象不得携带其他方式的隐藏条件；保存后的列表操作不得出现编辑或“详情 / 编辑”。
13. 点击【详情】必须打开完整五步配置快照，所有输入框、下拉、日期、单选、开关、复选框和内嵌操作按钮统一灰显且不可修改；三种领取方式分别显示其命中时配置。
14. 新增与详情的 01【定义目标人群】均不得展示【适用会员分组】；保存对象不得包含会员分组字段，配置预览中的目标人群也不得拼接会员分组。
15. 详情底部只允许显示【关闭】按钮，不得显示取消、保存、保存并启用或编辑入口。
16. 运行中模板操作为详情、暂停、关闭；已暂停模板操作为详情、启用、关闭；已关闭模板只能查看详情。
17. 点击暂停后模板立即显示已暂停并停止新扫描；点击启用后恢复运行中并从下一扫描周期处理候选。
18. 点击关闭必须二次确认并说明不可恢复；确认后状态变为已关闭，操作区只剩详情，已命中会员继续按原配置快照处理。
19. 状态操作必须更新操作人、操作时间并写入审计；同一模板同一会员只命中一次，暂停、启用和关闭不得重复赠送。
20. 自动优惠活动记录的筛选区必须位于看板上方；点击【查询】后，看板和列表必须共同使用同一命中时间及其他已提交筛选快照。
21. 五项看板必须依次展示扫描会员、命中人数、已赠送奖励金额、已领取奖励金额、已加倍人数；不得再出现【基础奖励已领取】卡片。
22. 记录筛选必须拆分为会员 ID、订单号、模板名称、触发人群、领取方式、领取状态、命中时间七项；领取方式覆盖自动领取、弹窗领取、充值后领取。
23. 时间快捷项必须完整包含今日、昨日、本周、上周、本月、上月、全部；手动修改日期取消错误高亮，未点击查询前不得改变看板和列表。
24. 领取状态筛选必须覆盖已到账、待领取、等待充值、已领取、奖励过期、奖励作废。
25. 记录列表必须按定义顺序展示二十一列：会员 ID、订单号、模板编号、模板名称、触发人群、注册时间、命中时间、领取方式、基础奖励、稽核倍数、稽核金额、领取状态、是否开启加倍奖励、加倍方式、加倍倍数、充值金额、关联订单、已领取金额、已领取加倍金额、已稽核流水、操作。
26. 稽核倍数和加倍倍数只显示数值，不展示“倍”字；金额保持站点币种和两位小数；操作列固定在最右侧。
27. 所有记录显示【作废】【详情】；仅待领取、等待充值可点击作废，确认弹窗必须说明不可恢复，确认后状态显示奖励作废。
28. 点击【详情】打开右侧抽屉，必须展示命中信息、基础奖励与稽核、充值与奖励加倍、处理时间线，并包含订单号、稽核金额、关联充值订单、基础与加倍实际领取金额。
29. 点击【导出记录】按最近一次已提交筛选条件导出全部匹配记录，不读取未点击查询的输入值；导出包含二十个非操作字段。
30. 自动优惠模板和记录宽表只允许容器内横向滚动，页面整体不得横向位移；首列会员 ID 和末列操作在滚动中始终可见。
31. 自动优惠模板新增和只读详情中的系统通知正文只支持用户名 {userName}、奖励金额 {rewardAmount}；内容输入框下必须显示相同提示，默认正文不得出现 {claimMethod}、{expiryDays} 或其他变量。

12. 回归范围与已知问题#

12.1 回归重点#

• V2.12.0 原有财务菜单、埋点系统 10 页、用户 360、埋点管理和事件查询不受影响。
• 人工优惠的单个、Excel、会员分组入口继续继承站点、币种、会员分组范围和角色额度；自动模板继承站点、币种和角色额度，但不再使用会员分组。
• 奖励基础入账和加倍入账分别幂等；重复点击、重复回调和任务重跑不重复加款。
• 页面筛选、分页、导出与详情使用同一已提交条件。
• 所有奖励状态均能关联任务号、会员 ID、充值订单号和钱包账变单号。
• 模版版本、随机倍数结果、游戏类型/标签快照和有效投注累计结果可完整追溯。
• 系统通知开关、信件类型、标题、正文变量、站内通知选项和会员级发送结果可追溯；通知技术失败不得影响奖励幂等。
• 配置预览与创建请求使用同一表单状态，切换领取方式、奖励加倍或通知开关后不残留已隐藏配置。
• 人工优惠任务列表 22 个字段与会员弹窗 15 个字段必须使用同一数据口径；任务人数与金额汇总可由会员明细重算一致。
• 自动领取、弹窗领取、充值后领取以及已完结、进行中、已作废六个筛选选项必须分别回归，列表、详情和会员明细中的领取方式与状态不得冲突。
• 任务详情不得出现任务级订单编号；会员明细仍须保留会员奖励订单编号与关联充值订单用于追溯。
• 任务列表和会员列表横向滚动时最右侧操作列保持固定；会员筛选在桌面端同一行且不出现背景框，倍数字段保持无单位数值展示。
• 今日、跨周、跨月、上月及全部时间范围按站点时区计算，月初、周一和跨年边界不得错位。
• 任务作废、会员奖励作废与会员领取、充值回调、加倍派发并发时以服务端原子状态转换为准，不得重复入账或回滚已领取奖励。
• 自动模板五步配置在自动领取、弹窗领取、充值后领取、单笔/累计充值、加倍开关、加倍方式和通知开关之间反复切换时不得保存隐藏字段残留。
• 自动模板运行中、已暂停、已关闭状态必须逐一回归；运行中校验暂停/关闭，暂停校验启用/关闭，关闭校验仅详情，扫描重试不得重复命中。
• 自动模板名称、编号、状态、触发人群和领取方式五项筛选必须分别回归；新增、保存对象、配置预览和详情均不得出现适用会员分组，详情所有配置控件必须保持灰显禁用。
• 自动记录的三种领取方式、五种奖励状态、五种加倍状态分别查询后，列表与链路详情必须一致。
• 自动记录七个快捷时间范围、手动日期、记录/会员组合查询、模板筛选和导出必须使用同一筛选快照。

12.2 已知问题 / 待产品确认#

1. “固定倍数”的业务口径当前定义为“额外奖励 = 基础奖励 × 配置倍数”；如业务期望总奖励为基础奖励的 N 倍，应在开发前统一调整为“额外奖励 = 基础奖励 ×（N-1）”。
2. 自动模板弹窗奖励的前台视觉和多奖励并存排序沿用现有活动弹窗规范，本版本原型只覆盖后台配置与记录。
3. 批量 Excel 最大 5 万行作为本版实施上限；更大规模名单需拆分任务或后续改为对象存储异步导入。
4. 随机倍数的概率分布算法和期望倍数收敛窗口需研发、风控在技术评审时锁定；原型已覆盖字段、校验和审计要求。
5. 平台公告的会员可见范围、展示入口和前台排序沿用现有消息中心能力；若现网平台公告仅支持全站广播，研发前需确认是否支持按人工优惠任务会员集合定向投放。
6. 任务列表字段较多，原型采用横向滚动并同时固定任务编号与末列操作；正式开发需结合真实数据量确认是否增加列显隐、自定义列或常用字段冻结能力。
7. 自动优惠模板目前仅定义【注册限时未充值】一种触发人群；其他自动人群、模板优先级和互斥规则不在本版范围。