SOP-504：批量账户政策标签设置

📋 文档信息

  • 编号：SOP-504
  • 文档类型：操作流程文档（SOP）
  • 适用场景：http://localhost:3000/crm/adaccount 广告账户管理界面
  • 相关接口：
  • POST /api/v1/customers/policy_labels - 获取客户政策标签
  • POST /api/v1/advertiser/batch_apply_policy_labels - 批量应用政策标签
  • 功能路径：广告账户列表 → 批量选择账户 → 批量设置政策标签按钮 → 选择标签 → 应用
  • 优势：无需审批，即时生效，直观的UI操作界面

🎯 功能概述

批量账户政策标签设置功能允许用户在广告账户列表页面中： - 选择多个广告账户 - 同时为这些账户设置政策标签（折扣、后返、扣点、奖励） - 查看所有选中账户的共同可用标签 - 直接应用，无需审批流程

与 SOP-503 的区别： - SOP-503：批量调整政策标签，需要走审批流程，适用于大规模调整 - SOP-504：直接批量设置，无需审批，快速生效，适用于日常操作

🔄 操作流程图

graph LR
    A[广告账户列表] --> B[勾选多个账户]
    B --> C[点击批量设置按钮]
    C --> D[打开设置对话框]
    D --> E[显示选中账户]
    E --> F[选择政策标签]
    F --> G[点击应用按钮]
    G --> H[确认操作]
    H --> I[直接生效]
    I --> J[更新账户标签]
    J --> K[完成]

📋 任务矩阵

Task 1: 进入广告账户页面

Step Task Name Action URL/Path Expected Result Status
1.1 打开广告账户页面 点击左侧导航栏"广告账户" http://localhost:3000/crm/adaccount 显示广告账户列表页面 [ ]
1.2 验证页面加载 检查页面元素 - 表格正常显示，包含账户列表 [ ]
1.3 验证操作按钮 查看工具栏 - 显示"批量设置政策标签"按钮（禁用状态） [ ]

预期结果： - ✅ 页面完整加载 - ✅ 账户列表正常显示 - ✅ 批量操作按钮存在但禁用

Task 2: 选择多个账户

Step Task Name Action URL/Path Expected Result Status
2.1 单个账户选择 点击表格行选择框 - 账户被选中，行高亮显示 [ ]
2.2 多个账户选择 继续选择其他账户 - 多个账户被选中 [ ]
2.3 验证按钮状态 查看批量操作按钮 - 按钮变为可用状态，显示选中数量 [ ]
2.4 取消选择测试 取消勾选某个账户 - 该账户取消选中，计数更新 [ ]
2.5 全选测试（可选） 点击表头全选框 - 当前页所有账户被选中 [ ]

预期结果： - ✅ 支持单选和多选 - ✅ 按钮状态随选择动态更新 - ✅ 显示选中账户数量 - ✅ 支持取消选择和全选

建议选择： - 选择 3-5 个属于同一客户的账户（测试正常流程） - 选择 2-3 个属于不同客户的账户（测试交集逻辑）

Task 3: 打开批量设置对话框

Step Task Name Action URL/Path Expected Result Status
3.1 点击批量设置按钮 点击"批量设置政策标签"按钮 - 对话框弹出 [ ]
3.2 验证对话框标题 查看对话框顶部 - 显示"批量设置政策标签" [ ]
3.3 验证选中账户显示 查看对话框中的账户列表 - 显示所有选中的账户信息 [ ]
3.4 验证账户信息 检查每个账户卡片 - 显示账户名称、客户名称、当前标签 [ ]

预期结果： - ✅ 对话框成功弹出 - ✅ 标题清晰明确 - ✅ 显示所有选中账户 - ✅ 账户信息完整

Task 4: 查看可用政策标签

Step Task Name Action URL/Path Expected Result Status
4.1 查看标签分类 滚动标签选择区域 - 显示折扣、后返、扣点、奖励四类 [ ]
4.2 查看标签布局 检查标签排列 - 2列网格布局，文本自动截断 [ ]
4.3 验证"不选择"选项 查看每个类型 - 每个类型都有"不选择"选项 [ ]
4.4 验证标签信息 查看标签显示 - 显示标签名称和折扣率 [ ]
4.5 悬停查看完整信息 鼠标悬停在被截断的标签上 - 显示完整的标签名称和折扣率 [ ]

预期结果： - ✅ 标签按类型分组显示 - ✅ 2列布局，整齐排列 - ✅ 长文本自动截断，悬停显示完整内容 - ✅ 每个类型都可选择"不设置"

特殊情况： - 如果选择的账户属于不同客户，只显示共同的可用标签（交集） - 如果没有共同标签，显示提示信息

Task 5: 选择政策标签

Step Task Name Action URL/Path Expected Result Status
5.1 选择折扣标签 点击折扣类型下的某个标签 - 该标签被选中（单选） [ ]
5.2 选择后返标签 点击后返类型下的某个标签 - 该标签被选中 [ ]
5.3 选择扣点标签 点击扣点类型下的某个标签 - 该标签被选中 [ ]
5.4 选择奖励标签 点击奖励类型下的某个标签 - 该标签被选中 [ ]
5.5 更改选择测试 重新选择折扣类型的其他标签 - 新标签被选中，旧选择被取消 [ ]
5.6 取消选择测试 选择"不选择"选项 - 该类型标签被清空 [ ]

预期结果： - ✅ 每个类型只能选择一个标签（单选） - ✅ 可以更改选择 - ✅ 可以选择"不设置" - ✅ 选择状态清晰可见

Task 6: 应用政策标签

Step Task Name Action URL/Path Expected Result Status
6.1 点击应用按钮 点击对话框底部"应用到所有账户" - 弹出确认对话框 [ ]
6.2 查看确认信息 阅读确认对话框内容 - 显示将要操作的账户数量 [ ]
6.3 确认应用 点击"确认应用"按钮 - 显示加载状态，执行应用 [ ]
6.4 等待应用完成 等待操作完成 - 显示成功提示，包含成功/失败数量 [ ]
6.5 关闭对话框 对话框自动关闭或手动关闭 - 返回账户列表页面 [ ]

预期结果： - ✅ 确认对话框显示清晰 - ✅ 应用过程有加载提示 - ✅ 显示操作结果统计 - ✅ 成功后对话框关闭

Task 7: 验证应用结果

Step Task Name Action URL/Path Expected Result Status
7.1 刷新表格 等待表格自动刷新或手动刷新 - 表格数据更新 [ ]
7.2 查看账户标签 查看之前选中的账户 - 显示新应用的政策标签 [ ]
7.3 验证标签内容 点击标签查看详情 - 标签名称和折扣率正确 [ ]
7.4 验证所有账户 逐个检查选中的账户 - 所有账户都已更新 [ ]
7.5 清空选择 取消所有账户选择 - 批量操作按钮变为禁用 [ ]

预期结果： - ✅ 标签应用成功 - ✅ 所有选中账户都已更新 - ✅ 标签信息正确显示 - ✅ 操作状态已重置

🔍 异常场景测试

场景 1: 选择空账户（无客户）

操作步骤： 1. 选择没有关联客户的账户 2. 点击批量设置按钮

预期结果： - ❌ 系统提示"选中的账户必须关联客户" - 或自动过滤掉无客户的账户

场景 2: 不同客户账户混选

操作步骤： 1. 选择属于不同客户的账户（如客户A的2个账户 + 客户B的2个账户） 2. 打开批量设置对话框

预期结果： - ⚠️ 显示警告提示"所选账户属于不同客户，只会显示共同的可用标签" - ✅ 对话框显示所有客户共同拥有的标签（交集） - ✅ 如果没有共同标签，显示提示信息

场景 3: 客户无政策标签

操作步骤： 1. 选择客户没有配置政策标签的账户 2. 打开批量设置对话框

预期结果： - ℹ️ 显示"所选账户没有共同的可用政策标签" - ℹ️ 提示"请确保所选账户属于相同的客户" - ❌ "应用"按钮禁用

场景 4: 取消操作

操作步骤： 1. 选择账户并打开对话框 2. 选择标签后点击"取消"按钮

预期结果： - ✅ 对话框关闭 - ✅ 不执行任何应用操作 - ✅ 账户选择状态保持

场景 5: 网络错误

操作步骤： 1. 断开网络连接 2. 尝试应用标签

预期结果： - ❌ 显示错误提示"政策标签应用失败: [错误信息]" - ✅ 对话框保持打开状态 - ✅ 可以重试操作

场景 6: 无变更应用

操作步骤： 1. 选择已有标签的账户 2. 在对话框中选择相同的标签 3. 点击应用

预期结果： - ℹ️ 提示"没有需要应用的变更" - ✅ 对话框自动关闭 - ✅ 不执行任何操作

📊 进度采集模板

测试概览

  • 测试环境：[开发/测试/生产]
  • 测试日期：YYYY-MM-DD
  • 测试人员：[姓名]
  • 总体结果：✅ 通过 / ⚠️ 部分通过 / ❌ 失败

测试统计

Task ID Task Name Status Issues Notes
T1 进入广告账户页面 [ ] 通过 / [ ] 失败
T2 选择多个账户 [ ] 通过 / [ ] 失败
T3 打开批量设置对话框 [ ] 通过 / [ ] 失败
T4 查看可用政策标签 [ ] 通过 / [ ] 失败
T5 选择政策标签 [ ] 通过 / [ ] 失败
T6 应用政策标签 [ ] 通过 / [ ] 失败
T7 验证应用结果 [ ] 通过 / [ ] 失败

异常场景测试结果

场景 Status Notes
选择空账户 [ ] 通过 / [ ] 失败
不同客户混选 [ ] 通过 / [ ] 失败
客户无政策标签 [ ] 通过 / [ ] 失败
取消操作 [ ] 通过 / [ ] 失败
网络错误 [ ] 通过 / [ ] 失败
无变更应用 [ ] 通过 / [ ] 失败

📝 注意事项

⚠️ 重要提示

  1. 无审批流程
  2. 此功能直接应用，不需要审批
  3. 操作即时生效，请谨慎操作

  4. 如需审批流程，使用 SOP-503

  5. 客户限制

  6. 建议选择相同客户的账户
  7. 不同客户账户只显示共同标签（交集）

  8. 无客户的账户无法设置标签

  9. 标签选择

  10. 每个类型只能选择一个标签（单选）
  11. 可以选择"不设置"来清空该类型标签

  12. 未选择的类型不会被修改

  13. 操作影响

  14. 操作会立即更新账户的政策配置
  15. 会影响后续的订单计算和折扣应用
  16. 无法撤销，请确认后再应用

✅ 最佳实践

  1. 选择账户
  2. 优先选择同一客户的账户
  3. 检查账户状态是否正常

  4. 确认账户有关联的客户

  5. 标签配置

  6. 在应用前仔细检查选择的标签
  7. 确认折扣率是否符合预期

  8. 必要时可以先测试单个账户

  9. 验证结果

  10. 应用后立即检查账户标签
  11. 验证所有选中账户都已更新
  12. 如有问题及时反馈

🔧 故障排查

问题 可能原因 解决方案
按钮一直禁用 未选择账户 至少选择一个账户
对话框无标签 客户无政策标签配置 为客户配置政策标签
对话框标签很少 选择了不同客户账户 选择同一客户的账户
应用失败 网络问题或权限不足 检查网络和权限，重试
标签未更新 表格未刷新 手动刷新页面

🔗 相关文档

🎯 功能特性总结

核心功能

  • ✅ 批量选择多个广告账户
  • ✅ 直观的UI界面操作
  • ✅ 支持四种政策类型（折扣、后返、扣点、奖励）
  • ✅ 2列网格布局，文本自动截断
  • ✅ 每种类型支持单选
  • ✅ 支持"不设置"选项
  • ✅ 实时显示选中账户和数量
  • ✅ 直接应用，无需审批
  • ✅ 即时生效，自动刷新

用户体验

  • ✅ 操作简单，流程清晰
  • ✅ 反馈及时，状态明确
  • ✅ 错误提示友好
  • ✅ 支持取消和重试

技术特性

  • ✅ 自动获取客户政策标签
  • ✅ 智能识别共同可用标签（交集）
  • ✅ 批量API调用，性能优化
  • ✅ 错误处理完善
  • ✅ 响应式布局，适配各种屏幕

最后更新：2026-02-01
文档版本：v1.0
维护人员：技术团队