# 营销活动类优秀用例范式

> 适用于平台端/商家端活动配置、列表管理、状态流转、C 端资格展示与领取发放类需求。
> 重点不是照抄标题，而是学习以下覆盖结构：后台正向成功链路、后台失败/限制链路、选择弹窗交互、端间数据隔离、C 端状态拆分、领取幂等与并发。

## 推荐覆盖框架

1. 后台列表能力
- 列表字段
- 默认排序与分页
- 搜索、筛选、重置、空结果提示
- 状态与操作栏映射

2. 后台配置能力
- 新建成功
- 编辑成功
- 时间/名称/奖品等失败态
- 失效、删除、查看只读

3. 选择弹窗能力
- 刷新
- 搜索
- 字段展示
- 分页
- 排序
- 单选/多选反馈
- 数据归属范围

4. C 端资格与展示
- 进行中时展示
- 未开始/已结束/已失效分别不展示
- 老用户/未登录分别不展示
- 奖品展示与后台一致
- 广告等弹窗优先级

5. 发放与稳健性
- 领取成功
- 幂等防重
- 超时重试
- 并发领取
- 失败日志
- 端间/角色间隔离

## 示例用例

| 用例编号 | 模块 | 用例标题 | 优先级 | 类型 | 前置条件 | 测试步骤 | 测试数据 | 预期结果 | 备注 |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| MKT_ACT_001 | 平台端-营销管理-活动配置 | 验证平台端新建合法营销活动可保存成功 | P0 | 功能测试 | 平台运营账号已登录；存在 1 个符合条件的活动资源；当前无时间冲突活动 | 1. 点击新建活动<br>2. 填写活动名称、时间、资源配置<br>3. 点击确定保存<br>4. 返回列表并进入详情查看 | 活动名称=春季促销；开始时间=明天 10:00；结束时间=后天 10:00 | 1. 页面提示创建成功<br>2. 列表新增活动记录且字段展示正确<br>3. 详情页展示与保存内容一致<br>4. 后台主表和资源明细表正确落库 | 示例 |
| MKT_ACT_002 | 平台端-营销管理-资源选择弹窗 | 验证资源选择弹窗支持刷新搜索分页排序和单选反馈 | P1 | 功能测试 | 平台运营账号已登录；资源池存在多条可用与不可用资源 | 1. 打开资源选择弹窗<br>2. 点击刷新<br>3. 按名称搜索<br>4. 切换分页和排序<br>5. 选择 1 条资源并确认返回 | 关键字=春季；分页项=10/20；目标资源=RES_1001 | 1. 刷新、搜索、分页、排序行为正确<br>2. 列表字段展示完整<br>3. 不符合条件资源不可选或不展示<br>4. 选中后页面正确回填资源信息 | 示例 |
| MKT_ACT_003 | 商家端-营销管理-活动列表 | 验证商家端列表字段和状态按钮映射正确 | P1 | 功能测试 | 商家端存在未开始、进行中、已结束、已失效四类活动；商家账号已登录 | 1. 进入活动列表<br>2. 逐条核对活动字段和操作栏<br>3. 对比不同状态按钮 | 活动A=未开始；活动B=进行中；活动C=已结束；活动D=已失效 | 1. 列表字段完整且内容正确<br>2. 未开始/进行中/已结束/已失效的操作按钮按规则展示<br>3. 不出现错态按钮或越权操作入口 | 示例 |
| MKT_ACT_004 | 用户端-首页-活动弹窗 | 验证活动未开始时首页不展示活动弹窗 | P1 | 功能测试 | 存在 1 条未开始活动；用户满足基础资格；当前无其他进行中活动 | 1. 用户进入首页<br>2. 观察首页弹窗<br>3. 查询资格检查结果 | 活动开始时间=当前时间后 1 小时 | 1. 首页不展示活动弹窗<br>2. 资格检查返回无可领取活动或活动未开始<br>3. 页面不提前曝光活动入口 | 示例 |
| MKT_ACT_005 | 用户端-首页-活动领取 | 验证同一用户重复点击领取时仅成功一次 | P0 | 回归测试 | 用户满足资格；存在进行中活动；前端可模拟快速重复点击 | 1. 打开活动弹窗<br>2. 1 秒内连续点击领取 3 次<br>3. 查询权益结果和发放日志 | 用户ID=USER_1001；重复点击次数=3 | 1. 页面最多提示 1 次成功<br>2. 用户仅获得 1 份权益<br>3. 发放日志仅有 1 条成功记录<br>4. 其余请求被幂等拦截 | 示例 |
