csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
Iteration/8-11
junhong_cmp_fiber/111.md
break 370fd3e67f
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 10m49s
Details
update
2026-09-03 09:28:28 +08:00

90 KiB
Raw Permalink Blame History

新卡管 8 月迭代需求

文档项 内容
产品名称 新卡管系统
迭代版本 2026 年 8 月迭代
文档类型 研发评审与排期版
文档状态 待研发评审
编写日期 2026-08-11
适用端 管理后台、财务管理、支付管理、运营商管理、店铺管理、换货管理、钱包余额、自动续费服务、通知中心、企业微信审批、佣金管理、资产管理
相关部门 自研产品部、研发部、测试、财务、行政、业务/客服/运营部门

1. 背景与目标

1.1 业务背景

新卡管系统 8 月迭代需要支撑支付、财务、店铺运营、换货追踪、流量预警、报表管理、佣金回溯、资产套餐详情展示、运营商通道流量阈值配置、优先轮询通道等能力的完善。

当前业务侧已明确提出以下问题：

  1. 代理或 C 端客户存在让员工代充值套餐的场景，员工收款后需要提交回款或核销流程，目前缺少系统化账单和销账闭环。
  2. 商户收款需要按商户池进行轮询，避免收款集中在单一商户，提升支付稳定性和风控承载能力。
  3. 店铺业务员换绑和清空当前依赖单条操作，批量维护效率低。
  4. 需要给店铺新增分组/分类能力，支持按组归属管理店铺。
  5. 换货管理需要展示是否迁移数据，便于判断换货后旧资产权益或业务数据是否已迁移。
  6. 流量预警阈值按套餐配置，并使用真流量计算套餐已使用量；当套餐真流量使用比例达到配置阈值后显示在列表中。
  7. 卡管自身报表需先支持激活情况统计表和套餐续费情况表，按设备、套餐、用户组、店铺、业务员等维度沉淀运营分析数据。
  8. 退款链路需同时支持原路退款和客户提供收款凭证退款，并在原路退款前校验原收款商户退款能力。
  9. 广电风险停机卡需要在 H5 对客户进行弹窗提醒，也需要支持运营主动配置弹窗用于换卡提醒、套餐政策推广。
  10. 代理侧需要分销码发展下级代理，并完善佣金提现前的合同、营业执照、法人身份证、门头照、发票等资料提交规则。
  11. H5 登录需按资产规则强制完成手机号和验证码绑定，后台可批量解绑，需可管理、可追溯；手机号绑定资产数量需受限，一个手机号最多只能绑定 10 个资产。
  12. 客户钱包余额有余额时，可按后台配置自动续费客户当前购买套餐，后台需可控制自动续费服务是否开启。
  13. 佣金回溯后需要生成独立扣款记录，便于财务核对、代理查询和后续追溯。
  14. 资产详情套餐详情列表中，主套餐与关联加油包需要绑定展示，存在关联加油包的主套餐需默认展开，避免套餐关系展示不清晰。
  15. 运营商管理模块新建运营商通道时，需要支持配置该通道是否设置流量阈值，并按通道维度维护阈值数值、单位、统计周期和生效状态。
  16. 当资产新购有效套餐、套餐过期续购、流量用完后购买加油包时，系统需将资产对应卡加入优先轮询通道，优先执行套餐、流量、状态等轮询。

1.2 产品目标

目标 说明
财务闭环 员工代客户收款、代充值、代购套餐产生的账单可记录、可查询、可审批、可核销。
支付稳定 商户池支持按金额、笔数、时间进行轮询，降低单商户集中收款风险。
运营提效 店铺业务员可批量换绑/清空；店铺分类规范跟随业务员所在用户组，店铺换绑业务员后分类归属自动更新。
风险可追踪 换货记录明确展示是否迁移数据，支持后续追溯。
主动预警 套餐真流量达到套餐配置阈值时写入列表，降低客户流量耗尽风险。
退款合规 退款申请支持不同退款方式，原路退款前校验商户能力，凭证退款可追溯。
站内通知 H5 弹窗支持风险停机换卡提醒和运营活动触达。
渠道增长 代理分销码自动建立下级归属，佣金提现资料可校验、可审核、可追溯。
资产实名触达 资产导入默认要求绑定手机号，H5 登录强制完成手机号验证码绑定，后台可查看和解绑绑定关系，并限制一个手机号最多绑定 10 个资产。
自动续费 客户钱包余额充足时，可自动续费当前购买套餐，后台可统一控制自动续费是否开启。
佣金可追溯 佣金回溯生成独立扣款记录，支持原发放佣金与回溯扣款记录双向关联查询和导出。
套餐关系清晰 资产详情套餐详情列表中，主套餐与关联加油包绑定展示，存在关联加油包时默认展开。
通道阈值配置 支持在运营商管理模块新建或编辑运营商通道时配置是否设置流量阈值，使阈值规则按通道独立生效。
报表分析 支持激活情况统计和套餐续费情况统计，按业务维度查询、汇总、可视化和导出。
优先轮询 对无有效套餐、过期续购、流量用完购买加油包等关键资产，优先加入轮询通道，提升套餐生效、流量恢复和卡状态同步时效。
研发可执行 输出页面、字段、流程、状态、权限、数据记录、验收标准，便于研发拆分排期。

2. 迭代范围

2.1 本期建议纳入开发范围

编号 模块 需求名称 优先级 建议排期 状态
PRD-08-001 财务管理 员工账单管理与核销审批 P0 第一阶段 待评审
PRD-08-002 支付管理 商户池支付方式轮询 P0 第一阶段 待评审
PRD-08-004 店铺管理 批量换绑/清空业务员 P1 第二阶段 待评审
PRD-08-005 店铺管理 店铺分类规范跟随业务员用户组 P1 第二阶段 待评审
PRD-08-006 流量预警 套餐流量阈值配置与真流量预警通知 P1 第二阶段 待评审
PRD-08-007 换货管理 列表新增是否迁移数据字段 P2 第三阶段 待评审
PRD-08-008 退款管理 退款方式选择与原路退款能力校验 P0 第一阶段 待评审
PRD-08-009 H5/通知管理 广电风险停机与运营弹窗提醒 P1 第二阶段 待评审
PRD-08-010 代理管理/佣金管理 代理分销码与佣金提现资料管理 P1 第二阶段 待评审
PRD-08-011 资产管理/H5 资产导入手机号绑定要求、H5 强制绑定与数量限制 P1 第二阶段 待评审
PRD-08-012 钱包余额/套餐续费 自动续费服务与后台开关配置 P1 第二阶段 待评审
PRD-08-013 佣金管理 佣金明细导出、佣金回溯扣款记录与关联明细 P1 第二阶段 待评审
PRD-08-014 资产管理 资产详情套餐详情列表主套餐与加油包绑定展示 P1 第二阶段 待评审
PRD-08-015 运营商管理 运营商通道流量阈值配置 P1 第二阶段 待评审
PRD-08-016 报表管理 卡管自身报表模块：激活情况统计与套餐续费统计 P1 第二阶段 待评审
PRD-008-019 轮询管理/资产管理 优先轮询通道 P1 第二阶段 待评审

2.2 本期同步优化范围

本期同步优化佣金明细导出、佣金回溯记录生成、佣金明细关联查询、资产详情套餐详情列表展示规则、运营商通道流量阈值配置，以及优先轮询通道。上述内容属于既有业务页面能力增强，需纳入本期研发评审、测试用例和上线验收范围。

3. 角色与权限设计

角色 权限范围
超级管理员 查看和操作全部数据，配置商户池、平台用户组、员工账单、预警规则、H5 弹窗规则、资产手机号绑定策略、自动续费开关和续费规则，查看佣金回溯关联明细和资产套餐关联关系，配置运营商通道流量阈值，查看和导出卡管自身报表，查看和处理优先轮询任务。
财务人员 查看员工账单、核销记录、代充值订单、退款凭证、佣金提现资料、佣金明细和佣金回溯记录，参与核销/退款/提现审核，导出财务数据。
部门领导 企业微信审批节点，审核员工核销申请。
平台业务员 查看本人负责店铺，可接收流量预警通知。查看本人员工账单，提交核销凭证，可按权限发起代充值。
运营管理员 批量换绑业务员、维护平台用户组并通过业务员用户组规范店铺分类、配置 H5 弹窗、维护资产导入手机号绑定要求、执行后台批量解绑、查看导入结果，按权限维护运营商通道流量阈值配置，查看激活情况统计和套餐续费情况统计，查看优先轮询任务和异常记录。
代理 在 H5 查看并分享个人分销码，提交佣金提现资料，按权限查看本人佣金明细及关联回溯记录。
H5 用户/客户 登录 H5 后按资产绑定规则完成手机号和验证码绑定，绑定完成后继续访问资产和业务页面。
研发/测试 依据 PRD 开发和验收，不作为线上业务角色。

权限原则：

  1. 涉及财务金额、凭证、客户付款截图的页面必须鉴权。
  2. 员工默认只能查看本人账单和本人提交的核销记录。
  3. 财务与超级管理员可查看全部员工账单。
  4. 店铺批量换绑必须受店铺数据权限控制。
  5. 流量预警通知只发送给当前有效业务员及配置范围内接收人。
  6. 商户池配置仅允许具备支付配置权限的角色操作。
  7. 自动续费开关、续费扣款和套餐生效记录必须受权限控制并保留操作日志。
  8. 佣金明细、佣金回溯扣款记录、关联佣金明细和导出能力必须受佣金数据权限控制。
  9. 资产详情套餐详情列表需按资产查看权限展示，主套餐与加油包关联关系不得越权展示。
  10. 运营商通道流量阈值配置必须受权限控制，新增、修改、启用、停用均需保留操作日志。
  11. 卡管自身报表查询和导出必须受数据权限控制，导出需记录操作人、导出时间、筛选条件和导出结果。
  12. 优先轮询通道需受任务权限控制，资产入队、执行、失败、重试、出队均需记录触发来源、操作来源和执行结果。

4. 总体设计方案

4.1 页面结构建议

财务管理
├─ 员工账单管理
│  ├─ 员工账单列表
│  ├─ 员工账单详情
│  └─ 核销审批记录
├─ 钱包代充值记录

支付管理
├─ 商户池管理
│  ├─ 商户池列表
│  ├─ 新建/编辑商户池
│  └─ 轮询记录

钱包余额 / 自动续费服务
├─ 自动续费配置
├─ 自动续费记录
└─ 自动续费异常处理

店铺管理
├─ 店铺列表
│  ├─ 批量换绑业务员
│  └─ 批量任务记录
├─ 店铺分类（跟随业务员用户组）

平台用户管理 / 系统管理
├─ 用户组管理

资产管理
├─ 资产导入（默认需要绑定手机号）
├─ 资产详情
│  ├─ 绑定手机号字段
│  └─ 套餐详情列表（主套餐与关联加油包绑定展示）
├─ 批量解绑手机号
└─ 解绑操作记录

运营商管理
└─ 运营商通道管理
   ├─ 新建/编辑运营商通道
   └─ 流量阈值配置

H5
├─ 登录强制绑定手机号
└─ 验证码校验

换货管理
├─ 换货列表（新增是否迁移数据）

预警管理 / 通知管理
├─ 套餐流量预警配置
└─ 流量预警记录

报表管理
├─ 激活情况统计表
└─ 套餐续费情况表

轮询管理
├─ 优先轮询通道
├─ 优先轮询队列
├─ 优先轮询记录
└─ 异常与重试记录

佣金管理
├─ 我的佣金
│  ├─ 佣金明细列表
│  ├─ 佣金明细详情
│  └─ 关联佣金明细
└─ 佣金明细导出

4.2 状态与日志原则

  1. 所有涉及金额、业务员归属、商户路由、预警通知的操作均需记录操作日志。
  2. 企业微信、支付回调、异步批量任务必须支持幂等，重复回调不得重复核销、重复入账、重复通知。
  3. 重要配置变更需要记录变更前后值。
  4. 自动续费扣款、套餐续费、支付流水号和退款流水号必须可追溯，重复任务或重复回调不得造成重复扣款、重复续费或重复退款。
  5. 佣金回溯扣款记录必须与原发放佣金记录建立关联关系，重复回调或重复提交不得重复生成扣款记录。
  6. 主套餐与加油包的关联关系需可追溯，资产详情展示、查询和导出需基于同一关联关系，避免重复或错挂展示。
  7. 运营商通道流量阈值配置及阈值命中记录需记录触发原因、周期、流量用量、阈值、操作来源和执行结果。

5. PRD-08-001 员工账单管理与核销审批

5.1 业务说明

当代理或 C 端客户将套餐购买款、钱包充值款转账给员工，由员工代客户在系统中完成购买或充值时，系统需要记录一笔员工账单。员工后续提交客户付款凭证、聊天截图等材料，经过企业微信审批后完成核销，员工欠款金额减少。

5.2 页面设计

5.2.1 员工账单列表

建议入口：财务管理 > 员工账单管理

页面区域：

  1. 顶部统计卡片。
  2. 筛选区。
  3. 账单列表。
  4. 批量导出按钮。
  5. 核销/查看详情操作按钮。

顶部统计：

指标 说明
未核销总金额 当前权限范围内待核销 + 已驳回账单未核销金额合计。
审批中金额 审批中账单金额合计。
已核销金额 已核销账单金额合计。
待处理账单数 待核销 + 已驳回数量。

筛选项：

筛选项 类型 说明
员工姓名/账号 输入框 支持模糊查询；普通员工不展示或仅固定本人。
账单编号 输入框 精确查询。
来源订单号 输入框 精确查询套餐订单/充值订单。
客户名称 输入框 支持模糊查询。
来源业务类型 下拉 套餐购买、钱包充值、其他。
账单状态 下拉 待核销、审批中、已核销、已驳回、已关闭。
产生时间 时间范围 按账单生成时间筛选。
核销通过时间 时间范围 按审批通过时间筛选。

列表字段：

字段 说明
员工账单编号 系统生成唯一编号。
来源业务类型 套餐购买/钱包充值/其他。
来源订单号 点击可跳转原业务订单详情。
员工姓名 代操作员工。
客户类型 代理/C 端客户。
客户名称 付款客户名称。
账单金额 应核销金额。
已核销金额 已完成核销金额。
未核销金额 账单金额 - 已核销金额。
账单状态 待核销/审批中/已核销/已驳回/已关闭。
产生时间 账单创建时间。
操作 查看详情、提交核销、关闭账单、查看凭证。

5.2.2 员工账单详情

详情页展示：

  1. 账单基础信息。
  2. 来源订单信息。
  3. 客户信息。
  4. 员工信息。
  5. 核销记录。
  6. 企业微信审批记录。
  7. 凭证附件。
  8. 操作日志。

5.3 账单生成规则

场景 是否生成员工账单 规则
员工代客户购买套餐 是 平台账号创建订单时选择“线下转账”后生成。
员工代客户充值钱包余额 是 平台账号代充值成功后生成。
客户自行在线支付 否 客户直接支付不计员工账单。
员工线下收款后代充 是 同第一行和第二行。
订单失败/取消 否 不生成或自动关闭已生成账单。
已生成账单的订单退款 冲销 需生成冲销记录或关闭未核销账单。

设计要求：

  1. 来源订单必须能追溯到员工账单。
  2. 员工账单必须能反查来源订单。
  3. 同一来源订单不得重复生成员工账单。
  4. 重复提交或重复回调必须幂等。

5.4 核销流程设计

flowchart TD
    A[系统生成员工账单: 待核销] --> B[员工上传凭证并提交核销]
    B --> C[账单状态: 审批中]
    C --> D[企业微信: 部门领导审核]
    D -->|驳回| E[账单状态: 已驳回]
    E --> B
    D -->|通过| F[企业微信: 财务审核]
    F -->|驳回| E
    F -->|通过| G[账单状态: 已核销]
    G --> H[员工未核销金额减少]

5.5 核销提交字段

字段 类型 是否必填 说明
核销金额 金额 是 默认等于未核销金额；是否支持部分核销待确认。
核销凭证 附件 是 客户支付凭证、聊天截图、转账记录等，至少 1 个。
备注 文本 否 员工补充说明。

5.6 状态流转

当前状态 触发动作 下一状态
待核销 员工提交核销 审批中
审批中 审批通过 已核销
审批中 审批驳回 已驳回
已驳回 员工重新提交 审批中
待核销/已驳回 财务关闭 已关闭
已核销 无 终态
已关闭 无 终态

5.7 验收标准

  1. 员工代客户购买套餐或充值钱包后，可生成员工账单。

  2. 员工仅能查看本人账单，财务/管理员可查看权限范围内全部账单。

  3. 员工可上传凭证提交核销。

  4. 核销申请可成功流转至企业微信审批。

  5. 部门领导通过后流转财务，财务通过后账单变为已核销。

  6. 任一节点驳回后账单变为已驳回，员工可重新提交，驳回需要有审批意见。

  7. 重复回调不重复核销。

  8. 账单、审批、附件、操作日志均可追溯。

6. PRD-08-002 商户池支付方式轮询

6.1 业务说明

商户池用于维护同一支付方式下的多个收款商户。系统根据配置策略选择实际收款商户，支持按金额、按笔数、按时间轮询。同时支持微信、支付宝分别设置轮询方式。

建议入口：支付管理 > 商户池管理

6.2 页面设计

商户池列表

字段：

字段 说明
商户池名称 商户池名称。
支付方式 微信/支付宝/其他。
轮询方式 按金额/按笔数/按时间。
商户数量 启用商户数量/总商户数量。
当前商户 当前命中的商户。
状态 启用/停用。
更新时间 最近配置更新时间。
操作 编辑、启用、停用、查看轮询记录。

新建/编辑商户池

配置项：

字段 类型 是否必填 说明
商户池名称 输入框 是 不允许重复。
支付方式 下拉 是 微信、支付宝等。
商户列表 多选 是 至少选择 1 个启用商户。
轮询方式 单选 是 金额、笔数、时间。
金额阈值 金额 条件必填 轮询方式为金额时填写。
笔数阈值 数字 条件必填 轮询方式为笔数时填写。
时间周期 数字 + 单位 条件必填 轮询方式为时间时填写。
起始时间 时间 否 时间轮询生效起点。
状态 开关 是 启用/停用。
备注 文本 否 配置说明。

6.3 轮询规则

按金额轮询

每个商户成功收款金额达到配置阈值后，下一笔订单切换到下一个商户。

规则：

  1. 只统计支付成功金额。
  2. 支付失败、取消、超时不计入。
  3. 当前商户达到或超过阈值后，下一笔新订单切换商户。
  4. 商户停用后自动跳过。
  5. 修改阈值后，新订单按最新配置执行，历史订单不变。

按笔数轮询

每个商户成功收款笔数达到配置阈值后，下一笔订单切换到下一个商户。

规则：

  1. 只统计支付成功订单数。
  2. 支付失败、取消、超时不计入。
  3. 达到笔数阈值后，下一笔新订单切换商户。
  4. 并发下单时，需要通过锁或事务保证计数准确。

按时间轮询

按配置时间周期切换商户。

规则：

  1. 到达时间周期后，下一笔新订单切换到下一个商户。
  2. 支持按分钟/小时/天配置，最小周期待研发评审确认。
  3. 商户停用后跳过。
  4. 时间轮询切换记录需可追溯。

6.4 异常规则

场景 处理方式
商户池只有 1 个启用商户 固定使用该商户。
当前商户停用 自动切换到下一个启用商户。
所有商户停用 创建支付单失败，并提示暂无可用商户。
商户支付创建失败 按现有失败逻辑处理，不无限重试。是否自动切换商户重试需评审确认。
商户池配置变更 记录配置快照，新订单使用新配置。

6.5 数据记录要求

每笔支付订单需要记录：

  1. 商户池 ID。
  2. 实际商户 ID。
  3. 轮询方式。
  4. 下单时配置快照。
  5. 是否计入金额/笔数累计。
  6. 支付成功时间。

6.6 验收标准

  1. 可创建金额、笔数、时间三类轮询商户池。
  2. 按金额达到阈值后，下一笔订单切换商户。
  3. 按笔数达到阈值后，下一笔订单切换商户。
  4. 按时间达到周期后，下一笔订单切换商户。
  5. 支付失败、取消、超时不计入累计。
  6. 商户停用后自动跳过。
  7. 并发下单下不会出现计数错乱。
  8. 支付订单可追溯命中的商户池和商户。

8. PRD-08-004 店铺批量换绑/清空业务员

8.1 业务说明

店铺换绑业务员或清空业务员时，支持通过 Excel 批量操作，减少运营手工维护成本。

入口建议：店铺管理 > 店铺列表 > 批量换绑业务员

8.2 操作流程

flowchart LR
    A[下载模板] --> B[填写店铺和目标业务员]
    B --> C[上传 Excel]
    C --> D[系统预校验]
    D -->|存在错误| E[下载错误明细]
    D -->|通过| F[确认提交]
    F --> G[执行批量任务]
    G --> H[展示处理结果]

8.3 导入模板字段

字段 是否必填 说明
店铺名称 是 支持精确匹配；若重名则提示使用店铺 ID。
操作类型 是 换绑/清空。
目标业务员账号 条件必填 操作类型为换绑时，与目标业务员名称二选一。
目标业务员名称 条件必填 操作类型为换绑时，与目标业务员账号二选一。
备注 否 导入说明。

8.4 校验规则

  1. 店铺 ID 存在时优先按店铺 ID 匹配。
  2. 店铺名称重名时，该行失败，提示使用店铺 ID。
  3. 操作类型只允许“换绑”“清空”。
  4. 换绑时必须填写目标业务员。
  5. 目标业务员必须为启用状态的平台账号。
  6. 操作人必须有该店铺操作权限。
  7. 单次导入建议最多 1000 行。
  8. 单行失败不影响其他行。

8.5 验收标准

  1. 可下载标准 Excel 模板。
  2. 可批量换绑店铺业务员。
  3. 可批量清空店铺业务员。
  4. 失败行有明确失败原因。
  5. 成功行实际更新店铺业务员。
  6. 导入任务可追溯并可下载错误明细。
  7. 操作日志记录变更前后业务员。

9. PRD-08-005 店铺分类规范跟随业务员用户组

9.1 业务说明

本期店铺分类规范明确跟随业务员的用户组。平台先维护业务员所属用户组，店铺绑定业务员后，店铺分类自动读取并展示该业务员所在用户组，用于运营管理、列表筛选、导出统计和后续报表汇总。

店铺不再单独维护一套独立分类口径，避免店铺分类与业务员组织归属不一致。店铺换绑业务员或清空业务员后，店铺分类需随新业务员用户组自动更新或展示为未分组。

9.2 业务目标

目标 说明
店铺分类统一 店铺分类以绑定业务员所在用户组为准。
降低维护成本 运营只需维护业务员用户组，无需重复维护店铺分类。
支持筛选和导出 店铺列表可按业务员用户组筛选，导出包含店铺分类信息。
支持后续报表 后续卡管自身报表可按业务员用户组统计店铺数据。
归属自动同步 店铺换绑业务员后分类归属自动更新。

9.3 页面入口

平台用户管理 / 系统管理
├─ 用户组管理
│  ├─ 用户组列表
│  ├─ 新增/编辑用户组
│  └─ 用户组成员维护

店铺管理
├─ 店铺列表
│  ├─ 展示绑定业务员
│  ├─ 展示店铺分类/业务员用户组
│  └─ 按业务员用户组筛选/导出

9.4 用户组字段

字段 类型 是否必填 说明
用户组名称 输入框 是 例如：智能产品组-酷蛙。
用户组编码 输入框 否 不填时系统自动生成；需全局唯一。
所属业务线 下拉 否 标品、智能产品、其他。
上级用户组 选择器 否 若支持多级用户组则填写。第一期可不做。
状态 开关 是 启用/停用。
排序 数字 否 展示顺序。
备注 文本 否 用户组用途说明。

9.5 用户组成员规则

仅平台业务员账号纳入本期店铺分类口径。第一期建议采用“一个业务员只属于一个业务用户组”的规则，保证店铺分类结果唯一。

场景 处理规则
业务员加入用户组 用户组成员新增记录，该业务员名下店铺分类展示为该用户组。
业务员已有用户组 提示确认是否从原用户组移出，避免一个业务员多个分类。
业务员从用户组移除 其绑定店铺分类展示为未分组。
用户组停用 历史店铺可继续展示停用用户组名称，筛选项标记已停用。
业务员账号禁用 店铺仍可展示该业务员用户组，但通知、任务等仅发送给启用账号。

如业务要求一个业务员加入多个用户组，需先补充“主用户组”规则，否则店铺列表无法明确展示唯一分类。

9.6 店铺继承规则

店铺展示的“店铺分类”来自当前绑定业务员所属用户组。

flowchart LR
    A[业务员加入用户组] --> B[业务员绑定店铺]
    B --> C[店铺展示业务员所在用户组]
    D[店铺换绑业务员] --> E[读取新业务员用户组]
    E --> C
    F[店铺清空业务员] --> G[店铺展示未分组]

店铺列表新增字段：

字段 说明
绑定业务员 店铺当前绑定业务员。
店铺分类/业务员用户组 当前绑定业务员所属用户组。
用户组业务线 用户组所属业务线。

店铺筛选增加：

筛选项 类型 说明
店铺分类/业务员用户组 下拉/树选择 查询绑定该用户组成员作为业务员的店铺。
用户组业务线 下拉 标品、智能产品、其他。
是否未分组 下拉 筛选业务员无用户组或店铺未绑定业务员的店铺。

店铺导出增加：绑定业务员、店铺分类/业务员用户组、用户组业务线。

9.7 与批量换绑业务员联动 是批量换绑还是交接？

场景 处理规则
店铺从业务员 A 换绑到业务员 B 店铺分类展示为 B 所属用户组。
店铺清空业务员 店铺分类展示为空或未分组。
批量换绑部分成功 成功行同步新用户组，失败行不变。
目标业务员无用户组 店铺分类展示为未分组。

9.8 数据实现建议

第一期建议优先实时关联查询：店铺列表实时关联绑定业务员与用户组成员表，保证用户组变化即时生效。如店铺量较大或报表统计压力明显，再增加异步快照。

9.9 验收标准

  1. 可新增、编辑、启用、停用平台用户组。
  2. 可将业务员加入或移出用户组。
  3. 店铺绑定业务员后，店铺分类展示该业务员所在用户组。
  4. 店铺换绑业务员后，店铺分类随新业务员自动变化。
  5. 店铺清空业务员后，店铺分类展示为空或未分组。
  6. 店铺列表可按店铺分类/业务员用户组筛选。
  7. 店铺导出包含店铺分类/业务员用户组字段。
  8. 无店铺权限的用户不能通过用户组筛选查看越权店铺。
  9. 用户组维护、成员维护和业务员换绑均记录操作日志。

10. PRD-08-006 套餐流量阈值配置与真流量预警

10.1 业务说明

流量预警阈值按套餐配置。系统以资产当前生效套餐的真流量使用量计算使用比例。

计算口径：

套餐真流量使用比例 = 套餐已使用真流量 / 套餐总流量 × 100%

其中“套餐已使用真流量”必须取真实流量消耗，不使用虚量、展示量、放大量或营销折算量。

10.2 页面入口

建议入口：套餐管理 > 套餐流量预警配置 或 预警管理 > 流量预警规则。

10.3 套餐阈值配置字段

字段 类型 是否必填 说明
套餐 选择 是 选择预警生效套餐。
套餐总流量 系统带出 是 用于计算预警比例；套餐无总量时不可启用预警。
预警阈值 百分比 是 1-100，例如 80%。第一期支持单阈值。
流量计算口径 系统字段 是 固定为真流量，不允许配置为虚量或展示量。
状态 开关 是 启用/停用。
备注 文本 否 规则说明。

生成一个套餐达量预警列表：

字段 说明
店铺 该笔资产对应的代理店铺
业务员 该店铺对应的业务员
用户组 该业务员所在的用户组
资产类型 卡/设备
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等
设备型号 CDB001、CDB006等
资产标识 ICCID/设备号
套餐名称 当前生效套餐名称
已使用流量 运营商周期内已用量
套餐总流量 当前生效套餐总流量
到期时间 生效中套餐的到期时间
剩余天数 套餐可用的天数

10.4 触发规则

项 规则
规则匹配 按资产当前生效套餐读取套餐预警阈值。
计算公式 套餐已使用真流量 / 套餐总流量 × 100%。
触发条件 真流量使用比例首次达到或超过套餐配置阈值。
套餐无总量 不允许启用阈值；历史异常数据记录为不可计算。
规则停用 停用后不再触发；已生成的预警记录保留。

触发判断流程：

1. 定时任务扫描资产当前生效套餐的真流量使用情况。
2. 读取套餐总流量和套餐预警阈值。
3. 计算套餐真流量使用比例。
4. 判断当前使用比例是否达到套餐阈值。
5. 写入预警记录，记录真流量用量、套餐总流量和命中的套餐阈值。

生成一个套餐达量预警列表：

字段 说明
店铺 该笔资产对应的代理店铺
业务员 该店铺对应的业务员
用户组 该业务员所在的用户组
资产类型 卡/设备
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等
设备型号 CDB001、CDB006等
资产标识 ICCID/设备号
运营商通道 对应卡所属的运营商通道
对应标识符 资产标识符（若为设备需要，显示达到阈值的卡的唯一标识符）
已使用流量 运营商周期内已用量
当前生效套餐 生效中套餐的到期时间
剩余天数 套餐可用的天数

10.5 预警记录字段

字段 说明
记录编号 系统生成。
店铺 触发店铺。
资产标识 ICCID/IMEI/虚拟号。
套餐 触发套餐。
套餐预警规则 ID 命中的套餐阈值配置。
阈值 套餐配置阈值。
套餐已使用真流量 触发时套餐已使用真流量。
套餐总流量 套餐总量。
使用比例 真流量使用比例。
触发时间 首次达到阈值时间。

10.6 验收标准

  1. 可按套餐配置流量预警阈值。
  2. 阈值计算固定使用真流量，不使用虚量、展示量或折算量。
  3. 套餐无总流量时不可启用预警阈值。
  4. 资产当前套餐真流量使用比例达到套餐阈值时，可通知配置范围内接收人。
  5. 停用套餐预警规则后不再触发。
  6. 预警记录可查询，并展示套餐已使用真流量、套餐总流量、阈值。

11. PRD-08-007 换货列表新增“是否迁移旧资产全部数据”字段

11.1 业务说明

换货完成后，需要在换货管理列表中明确展示旧资产相关数据是否已迁移至新资产，方便运营、售后、测试判断换货结果。

11.2 展示位置

入口：换货管理 > 换货列表

新增列表字段：是否迁移数据

建议同时在换货详情展示：

  1. 是否迁移数据。

11.3 字段值规则

字段值 说明
是 已完成旧资产相关数据迁移。
否 未迁移旧资产数据。

11.4 验收标准

  1. 换货列表展示“是否迁移旧资产全部数据”。
  2. 换货详情展示迁移状态。
  3. 换货导出包含该字段。
  4. 字段值与实际迁移记录一致。
  5. 迁移失败时可查看失败原因。

12. PRD-08-008 退款方式选择与原路退款能力校验

12.1 业务说明

退款申请需支持原路退款和客户提供收款凭证退款。在线支付订单选择原路退款时，系统需校验原收款商户退款能力；校验失败时提示失败原因，并允许改为客户提供收款凭证退款。

新增口径：退款审批需带出套餐已使用流量；支付单和退款单都必须记录交易流水号，微信记录微信交易单号，支付宝记录支付宝交易单号，其他渠道记录对应渠道流水号。

12.2 退款方式规则

订单类型 可选退款方式 规则说明
在线支付订单 原路退款、客户提供收款凭证退款 选择原路退款前需校验原收款商户退款能力。
代理钱包充值订单 原路退回钱包、客户提供收款凭证退款 原路退回钱包时增加代理钱包余额或冲销充值流水，具体按现有钱包规则。
线下收款购买订单 客户提供收款凭证退款 不展示原路退款选项。
员工代收款订单 客户提供收款凭证退款 需关联员工账单或核销记录，便于财务追溯。

12.3 退款申请表单字段

字段 类型 是否必填 说明
来源订单号 系统带出 是 当前退款对应订单。
退款金额 金额 是 不得超过可退金额。
套餐已使用流量 系统带出 是 带出退款资产当前套餐已使用流量，建议使用真流量口径。
退款方式 单选 是 原路退款、客户提供收款凭证退款、原路退回钱包。按订单类型展示。
原收款商户 系统带出 条件必填 原路退款时展示。
原支付交易流水号 系统带出 条件必填 微信交易单号、支付宝交易单号或其他渠道交易流水号。
商户退款能力校验结果 系统字段 条件必填 原路退款时自动校验。
收款凭证 附件 条件必填 客户提供收款凭证退款时必填。
收款账户信息 文本/结构化字段 条件必填 可包含户名、账号、开户行、支付宝/微信账号等。
退款交易流水号 系统带出/财务填写 条件必填 原路退款成功后记录渠道退款流水；线下退款由财务填写处理流水或凭证编号。
退款原因 文本 是 员工填写。
备注 文本 否 补充说明。

12.4 原路退款能力校验

校验项 说明
原收款商户是否存在 不存在则不可原路退款。
商户状态是否启用 停用不可原路退款。
商户是否支持退款接口 不支持则不可原路退款。
商户退款证书/密钥是否有效 无效则不可原路退款。
订单是否仍在可原路退款期限内 超期不可原路退款。
可退金额是否充足 退款金额不得超过可退金额。
原支付交易流水号是否存在 缺少渠道交易流水号时不可发起原路退款。

校验触发时机：用户选择原路退款时、提交退款申请前、财务执行原路退款前。

12.5 支付单与退款单流水号要求

支付单需记录：支付渠道、系统支付单号、渠道交易流水号、收款商户、商户池、实际收款商户、支付成功时间和回调关键字段。

退款单需记录：系统退款单号、来源支付单号、来源订单号、原支付渠道交易流水号、退款渠道交易流水号或线下退款处理流水号、套餐已使用流量快照、退款执行时间、执行人、回调状态和失败原因。

12.6 验收标准

  1. 退款申请时可按订单类型展示可选退款方式。
  2. 在线支付订单选择原路退款时，系统自动校验原收款商户退款能力。
  3. 商户校验失败时，展示失败原因，并允许切换为客户提供收款凭证退款。
  4. 线下收款购买订单不展示原路退款选项。
  5. 代理钱包充值订单可支持原路退回钱包。
  6. 退款审批字段带出套餐已使用流量。
  7. 支付单可追溯微信交易单号、支付宝交易单号或其他渠道交易流水号。
  8. 退款单可追溯原支付交易流水号和退款交易流水号。
  9. 重复提交、重复回调、重复执行不会造成重复退款。

13. PRD-08-009 H5 弹窗提醒

13.1 业务说明

H5 需要支持弹窗提醒能力，优先用于广电风险停机卡的客户提醒，提示客户需要换卡，并引导客户填写收货地址。后续也可用于套餐政策推广引导客户消费。

本需求提供两种触发方式：

  1. 系统自动弹窗：命中业务规则后自动弹窗，例如广电风险停机卡。
  2. 运营主动弹窗：后台配置弹窗内容、适用客户、设备类型、卡类型等，由运营主动投放。

13.2 页面入口

后台建议入口：

通知管理 / H5 配置
├─ H5 弹窗配置
└─ 弹窗效果统计（可后续迭代）

H5 展示位置：

  1. 用户进入首页时弹窗。
  2. 用户进入套餐购买/充值页时弹窗。

具体展示页面由弹窗配置决定。

13.3 弹窗类型

类型 说明 优先级建议
风险停机换卡提醒 广电风险停机卡，提示客户换卡并填写收货地址。 高
套餐政策推广 推广新的套餐政策或优惠。 中
通用公告 业务公告、维护通知等。 低

13.4 自动弹窗：广电风险停机换卡

触发条件：

  1. 资产为广电风险停机卡。
  2. 当前客户登录 H5 后能识别到该资产。
  3. 该资产未完成换卡或未生成有效物流换货单。
  4. 同一资产弹窗频率符合配置，避免反复打扰。

弹窗内容建议：

您的卡片存在风险停机可能，建议尽快申请换卡。
请填写收货地址，我们将为您安排后续处理。

弹窗操作：

按钮 说明
立即填写地址 跳转收货地址填写页。
稍后处理 关闭弹窗，按频率规则下次提醒。
不再提醒 是否支持待业务确认，不建议第一期开放。

地址填写字段：

字段 是否必填 说明
收货人 是 客户姓名。
手机号 是 收货手机号。
省市区 是 标准地址选择。
详细地址 是 街道门牌。
备注 否 补充说明。

后续联动建议：

  1. 地址提交后同步至后台。
  2. 后台生成换卡待处理记录。
  3. 如条件成熟，可直接生成物流换货单。
  4. 后续可对接 ERP 系统创建物流/换货单。

13.5 运营主动弹窗配置

配置字段：

字段 类型 是否必填 说明
弹窗标题 输入框 是 H5 弹窗标题。
弹窗内容 富文本/文本 是 支持换行，后续可支持图片。
弹窗类型 下拉 是 套餐推广、公告。
适用客户 选择器 否 可按店铺选择。
适用设备类型 多选 否 例如 MIFI、定位灯等。
适用卡类型 多选 否 例如广电、移动、联通、电信。
生效时间 时间范围 是 弹窗展示周期。
展示页面 多选 是 首页、资产详情、套餐页等。
展示频率 下拉 是 自定义
状态 开关 是 启用/停用。

13.6 弹窗优先级与频率

规则：

  1. 同一页面同一时间只展示一个弹窗。
  2. 风险停机换卡提醒优先级高于营销推广。
  3. 用户已完成地址提交后，不再展示同一资产的换卡提醒。
  4. 每天一次、仅一次等频率需按用户维度记录。
  5. 停用或过期弹窗不再展示。

13.7 验收标准

  1. 广电风险停机卡可在 H5 自动弹窗提醒。
  2. 用户点击后可填写收货地址，地址同步到后台。
  3. 同一资产完成地址填写后不再重复弹出换卡提醒。
  4. 后台可配置运营主动弹窗，支持自定义内容和适用范围。
  5. 弹窗可按客户、设备类型、卡类型筛选投放。
  6. 弹窗展示频率生效，不会频繁打扰用户。
  7. 若后续对接 ERP，生成物流换货单需保证幂等，不重复建单。

14. PRD-08-010 代理分销码与佣金提现资料管理

14.1 业务说明

代理在 H5 需要拥有自己的唯一分销码。新代理可通过扫码注册或加入，系统默认将其发展为扫码代理的下级代理，并自动建立分销归属关系。代理首次默认密码为：adm@手机号后四位

首次佣金提现前，代理必须完成合同签署并上传法人身份证；营业执照、门头照、发票等其余资料为可选。若代理已完成必填资料完善且资料有效，后续提现不再重复提示；若未完善、审核驳回或资料过期，则每次发起提现都必须提示补充资料，且不允许继续提交提现。

14.2 需求清单

编号 需求 优先级
DST-001 代理在 H5 拥有唯一分销码，新发展代理扫码后默认为该代理下级代理，并在后台新建该代理或生成待审核记录。 P1
DST-003 首次佣金提现前，代理必须签署合同。 P1
DST-004 佣金提现可上传营业执照，营业执照为可选。 P2
DST-005 首次佣金提现前，代理必须上传法人身份证。 P1
DST-006 佣金提现可选上传门头照。 P2
DST-007 佣金提现可上传发票，且公司主体需与合同一致，发票为可选。 P2
DST-008 必填资料完善后后续提现不再提示；未完善或失效则每次提示并阻断提现。 P1

14.3 分销码规则

规则 说明
唯一性 每个代理仅有一个唯一分销码。
生成时机 代理创建成功后自动生成。
归属关系 新代理通过分销码注册后，自动归属为扫码代理的下级代理。
防重复 同一新代理账号不可被多个分销码重复绑定。
失效规则 代理禁用后，分销码不可继续发展新代理。

分销码字段：

字段 说明
代理商名称 每个代理仅有一个唯一分销码。
代理商联系方式 代理创建成功后自动生成。
代理商详细地址 代理商的地址信息。
上级代理 归属的上级店铺。（自动代入）
业务员 同步上级代理的业务员。（直接同步）

14.4 佣金提现资料规则

资料 是否必填 规则
合同 首次提现前必填 代理首次提现前必须完成签署，签署完成且有效后后续提现不再提示。
法人身份证 首次提现前必填 需上传正反面或按现有附件规则上传，资料有效后后续提现不再提示。
营业执照 可选 可作为企业主体证明，未上传不影响提现提交。
门头照 可选 可用于代理真实性补充证明，未上传不影响提现提交。
发票 可选 如上传，发票公司主体需与合同主体一致；未上传不影响提现提交。

提示与阻断规则：

  1. 代理发起首次佣金提现时，系统校验合同和法人身份证。
  2. 合同未签署、法人身份证未上传、资料审核驳回或资料过期时，展示资料完善提示并阻断提现提交。
  3. 合同和法人身份证均完成且有效后，后续提现不再提示资料完善。
  4. 可选资料未上传时不阻断提现；如已上传发票，则需校验发票公司主体与合同主体一致。

14.5 佣金提现流程

flowchart TD
    A[代理发起佣金提现] --> B[系统校验合同和法人身份证]
    B -->|必填资料已完善且有效| C[进入提现审批流程]
    B -->|必填资料未完善或失效| D[提示补充资料并阻断提现]
    C --> E[财务审核]
    E -->|通过| F[提现处理]
    E -->|驳回| G[代理重新提交]

14.6 数据记录要求

需记录：分销码生成记录、分销码扫码注册记录、上下级代理归属关系、佣金提现资料附件、资料审核记录、提现申请时的资料校验结果。

14.7 验收标准

  1. 每个代理有唯一分销码和二维码。
  2. 新代理扫码注册后，可自动建立上下级代理关系。
  3. 后台可查看代理分销码、上级代理和下级代理数量。
  4. 禁用代理的分销码不可继续发展新代理。
  5. 首次佣金提现前必须校验合同和法人身份证。
  6. 合同未签署、法人身份证缺失、资料驳回或资料过期时，每次提现都提示补充资料，且不允许提交提现。
  7. 合同和法人身份证完成且有效后，后续提现不再提示资料完善。
  8. 发票为可选，但上传后需校验公司主体与合同一致。
  9. 营业执照和门头照为可选资料，可上传、查看、审核。
  10. 资料审核记录和提现校验结果可追溯。

15. PRD-08-011 资产导入手机号绑定要求、H5 强制绑定与数量限制

15.1 业务说明

默认规则：资产导入时默认均为“需要绑定手机号”。

绑定完成后，后台资产详情页需展示字段“绑定手机号”。系统同时提供后台解绑能力和后台批量解绑能力。手机号绑定资产数量需受限：一个手机号最多只能绑定 10 个资产。

15.2 业务目标

目标 说明
导入可控 默认强制绑定。
登录强校验 命中绑定要求的资产，用户登录 H5 后优先完成手机号与验证码绑定。
后台可追溯 资产详情展示绑定手机号，绑定、解绑、批量解绑均记录操作日志。
数量可限制 一个手机号最多绑定 10 个资产，超过限制时阻断新增绑定。

15.3 页面入口

资产管理
├─ 资产导入
│  ├─ 上传导入文件
│  ├─ 默认：是
│  └─ 导入结果
├─ 资产列表
│  ├─ 绑定手机号筛选
│  └─ 批量解绑手机号
├─ 资产详情
│  ├─ 是否需要绑定手机号
│  ├─ 绑定手机号
│  ├─ 绑定时间
│  └─ 解绑记录
└─ 手机号绑定/解绑记录

15.4 资产导入规则

场景 规则
新增资产导入 默认为“是”。
选择需要绑定 当前导入批次资产写入 require_phone_binding=是，H5 登录时触发强制绑定。
选择不需要绑定 当前导入批次资产写入 require_phone_binding=否，H5 登录时不触发强制绑定。
未选择直接导入 按默认值“需要绑定手机号”处理。
导入失败重试 重试时需沿用原导入批次的绑定要求，避免同一批次资产规则不一致。
导入记录 导入结果需展示该批次是否需要绑定手机号。

15.5 H5 强制绑定流程

触发条件：用户已登录、存在关联资产、至少一条资产要求绑定手机号且当前未绑定。

处理流程：

  1. H5 登录成功后，系统优先查询是否存在待绑定资产。
  2. 若存在待绑定资产，优先弹出或跳转至绑定手机号页面。
  3. 用户输入手机号并通过验证码校验。
  4. 系统校验该手机号绑定资产数量是否超过上限。
  5. 验证通过且未超过上限后，将手机号写入资产绑定关系，并记录绑定时间、绑定用户、绑定来源。
  6. 绑定成功后跳转至用户原本要访问的 H5 页面。
  7. 验证失败或数量超限时提示失败原因，不允许跳过绑定继续访问。

15.6 绑定数量限制

规则 说明
数量上限 一个手机号最多绑定 10 个资产。
计数范围 统计当前有效绑定关系；已解绑关系不计入上限。
单资产绑定 提交绑定时校验该手机号当前有效绑定资产数，已达到 10 个则阻断。
多资产批量绑定 本次待绑定资产数 + 该手机号当前有效绑定资产数不得超过 10 个。
后台补录 后台补录绑定手机号同样受 10 个资产上限限制。
后台解绑 解绑成功后释放该手机号可绑定数量。
失败提示 明确提示“该手机号已绑定 10 个资产，无法继续绑定”。

15.7 绑定关系与展示字段

字段 类型 是否展示 说明
绑定状态 枚举 是 未绑定、已绑定、已解绑。
绑定手机号 文本 是 用户 H5 绑定成功后的手机号，建议按权限脱敏展示。
绑定资产数量 数字 是 当前手机号有效绑定资产数量。
绑定时间 时间 是 绑定成功时间。
绑定来源 枚举 是 H5 绑定、后台导入、后台补录等。
最近解绑时间 时间 条件展示 发生解绑后展示。
最近解绑人 用户 条件展示 后台平台用户。
解绑原因 文本 条件展示 后台解绑时填写。

15.8 后台解绑与批量解绑

能力 规则
单个解绑 资产详情页已绑定资产展示“解绑手机号”按钮，需二次确认并填写解绑原因。
批量选择解绑 资产列表勾选多个已绑定资产后批量解绑。
Excel 导入解绑 按资产标识导入批量解绑。
批量校验 仅允许解绑已绑定资产；无权限、资产不存在、未绑定资产需生成失败明细。
任务记录 批量解绑建议异步执行，展示成功数、失败数、失败原因。

15.9 异常与安全规则

异常场景 处理方式
验证码错误 提示错误，可重试，超过次数后短时间限制。
验证码过期 提示重新获取验证码。
手机号已绑定 10 个资产 阻断绑定并提示更换手机号或联系后台处理。
资产已被后台解绑 H5 下次登录按是否仍需绑定判断是否重新触发绑定。
导入批次选择不需要绑定 H5 不弹强制绑定页面。
批量解绑部分失败 成功项提交，失败项输出失败明细。

安全要求：后台展示手机号建议脱敏；验证码发送需限制频率；绑定、解绑操作需写入审计日志；批量解绑需二次确认。

15.10 验收标准

  1. 导入时选择“需要绑定手机号”的资产，H5 登录后会优先进入绑定手机号页面。
  2. H5 用户必须输入手机号并通过验证码校验后，才可继续访问原页面。
  3. 导入时选择“不需要绑定手机号”的资产，H5 登录不触发强制绑定。
  4. 绑定成功后，后台资产详情页展示“绑定手机号”。
  5. 后台资产详情可查看是否需要绑定手机号、绑定状态、绑定时间、绑定资产数量、解绑记录。
  6. 一个手机号最多只能绑定 10 个资产，超过上限时 H5 绑定和后台补录均需阻断。
  7. 平台后台用户可对单个资产执行解绑，H5 用户不可自助解绑。
  8. 后台资产列表支持批量解绑，成功和失败结果可追溯。
  9. 解绑后若资产仍要求绑定手机号，用户下次登录 H5 需重新绑定。
  10. 绑定、解绑、批量解绑均有操作日志。

16. PRD-08-012 自动续费服务

16.1 业务说明

当客户钱包余额有可用余额时，系统可自动为客户当前购买的套餐续费。后台需提供自动续费总开关和配置能力，控制自动续费服务是否打开；关闭后不再触发新的自动续费任务，已生成的续费记录保留。轮询时判断钱包是否余额，若有自动续费，不停机

16.2 业务目标

目标 说明
降低断套风险 客户钱包余额充足时自动续费当前套餐，减少客户因忘记续费导致套餐中断。
后台可控 后台可控制自动续费服务是否开启，支持按业务规则停用。
扣款可追溯 自动续费扣款、钱包流水、套餐续费记录和失败原因均可追溯。
防重复扣款 自动续费任务需幂等，避免重复续费和重复扣款。

16.3 页面入口

钱包余额 / 套餐管理
├─ 自动续费配置
│  ├─ 自动续费总开关
│  ├─ 续费触发规则
│  └─ 操作日志
├─ 自动续费记录
└─ 自动续费异常记录

16.4 配置字段

字段 类型 是否必填 说明
自动续费总开关 开关 是 后台可控制自动续费服务是否打开。
适用套餐范围 多选/全部 是 默认可选择全部套餐或指定套餐。
触发时间 下拉/数字 是 建议套餐到期前或流量即将耗尽时触发，具体时间可配置。
扣款钱包 系统字段 是 使用客户钱包可用余额。
余额不足处理 系统规则 是 不扣款、不续费，记录失败原因并通知相关人员。
状态 开关 是 配置启用/停用。
备注 文本 否 配置说明。

16.5 自动续费规则

场景 处理规则
总开关关闭 不触发新的自动续费任务。
客户钱包余额充足 按客户当前购买套餐生成续费订单并完成钱包扣款。
客户钱包余额不足 不生成成功续费，记录失败原因，可按通知能力提醒客户。
当前套餐不可续费 不执行自动续费，记录不可续费原因。
客户当前有多个套餐 按资产当前生效套餐逐个判断，避免串套。
手动续费已完成 自动续费任务需识别最新套餐状态，避免重复续费。
扣款成功但续费失败 进入异常处理，需支持补偿或退款，记录完整链路。

16.6 数据记录要求

需记录：自动续费配置及变更日志、自动续费任务编号、客户、资产、当前套餐、续费套餐、钱包扣款金额、扣款前余额、扣款后余额、钱包流水号、续费订单号、任务状态、失败原因、重试次数、处理人和处理时间。

16.7 验收标准

  1. 后台可开启或关闭自动续费服务。
  2. 自动续费开启后，客户钱包余额充足时可自动续费客户当前购买套餐。
  3. 自动续费关闭后，不再触发新的自动续费任务。
  4. 钱包余额不足时不扣款、不续费，并记录失败原因。
  5. 自动续费成功后生成钱包流水和套餐续费记录。
  6. 自动续费任务具备幂等能力，不重复扣款、不重复续费。
  7. 自动续费配置变更、扣款记录、续费记录和异常处理记录可追溯。

17. PRD-08-013各审批流字段

17.1 预存款审批 需要识别支付凭证中的交易流水号

字段 说明
收款方式 选择项（可支持自己维护相关类目）：邓总微信、邓总支付宝、牟略微信、牟略支付宝等
充值单号 后台充值订单对应的单号
交易流水号 支付凭证中的交易流水号（用ocr解决）
付款方 对应店铺
充值金额 充值的实际金额
支付凭证 支付截图
其他凭证 可支持多张或附件上传
备注 可支持填写相关内容

17.2 退款审批

收款人/收款方式/收款账号只有线下收款时需要填写。钱包余额购买的套餐会直接退回钱包余额、预存款支付的订单也会直接退回预存款。

字段 说明
资产类型 卡/设备
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等
资产标识 资产的标识符，例如：ICCID、设备号
退款方式 原路退回/线下转账（字典维护）（微信/支付宝/银行卡等）
退款单号 卡管自身的流水号
关联订单号 关联的该笔订单的流水号
交易流水号 支付凭证中的交易流水号（用ocr解决）
订单实收金额 关联订单的实际支付金额
申请退款金额 需要退款的金额
套内使用量 套餐内使用的流量总量，决定需要扣款的金额
退款原因 申请退款的原因，需要填写
退款凭证 退款申请的凭证，支持多图上传或附件
备注 平台用户填写的备注内容
收款人 该笔退款的实际收款人
收款账号 收款账号信息

17.3 核销审批

字段 说明
资产类型 卡/设备
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等
设备型号 CDB001、CDB006等
资产标识 资产的标识符，例如：ICCID、设备号
关联订单号 关联的该笔订单的流水号
交易流水号 支付凭证中的交易流水号（用ocr解决）
订单实收金额 关联订单的实际支付金额
核销凭证 核销申请的凭证，支持多图上传或附件
备注 平台用户填写的备注内容

17.4 拥金提现审批

字段 说明
店铺 这笔佣金提现的店铺
提现金额 代理申请提现的金额
手续费 手续费金额
实际到账金额 扣除手续费后需要给代理发放的佣金金额
收款方式 微信/支付宝/钱包/预存款/银行卡
收款账号 收款账号信息
开票信息 代理发起提现时上传的发票（上传则有；未上传则不显示）

17.5 代理分销码新增代理审批

字段 说明
代理商名称 每个代理仅有一个唯一分销码。
代理商联系方式 代理创建成功后自动生成。
代理商详细地址 代理商的地址信息。
上级代理 归属的上级店铺。（自动代入）
业务员 同步上级代理的业务员。（直接同步）

18. PRD-08-014 导出

18.1 临期列表导出

字段 说明
店铺 该笔资产对应的代理店铺
业务员 该店铺对应的业务员
用户组 该业务员所在的用户组
资产类型 卡/设备
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等
设备型号 CDB001、CDB006等
资产标识 ICCID/设备号
当前套餐 即将到期套餐
到期时间 生效中套餐的到期时间
剩余天数 套餐可用的天数

18.2 佣金明细导出

字段 说明
店铺 该笔资产对应的代理店铺。
业务员 该店铺对应的业务员。
用户组 该业务员所在的用户组。
资产类型 卡/设备。
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等。
设备型号 CDB001、CDB006等
资产标识 ICCID/设备号。
订单号 原充值订单号；佣金回溯记录与原发放记录订单号保持一致。
下单时间 原充值订单号的创建时间。
佣金金额 该笔佣金金额；佣金回溯扣款记录为负数。
佣金来源 成本差价、套餐退款等。
佣金状态 待结算、已结算、回溯等，按系统佣金状态字典展示。
关联佣金明细 存在回溯关系时，导出关联佣金明细编号或关联原佣金明细编号。
入账后金额 该笔佣金入账后剩余金额。
创建时间 创建该笔佣金明细的时间。

18.3 套餐流量达量列表（阈值）导出（PRD-08-006）

字段 说明
店铺 该笔资产对应的代理店铺
业务员 该店铺对应的业务员
用户组 该业务员所在的用户组
资产类型 卡/设备
设备类型 该资产的类型，例如：MiFi、Dongle、充电宝等
设备型号 CDB001、CDB006等
资产标识 ICCID/设备号
对应标识符 资产标识符（若为设备需要，显示达到阈值的卡的唯一标识符）
套餐名称 当前生效套餐名称
已使用流量 运营商周期内已用量
套餐总流量 当前套餐的总流量
到期时间 生效中套餐的到期时间
剩余天数 套餐可用的天数

19.PRD-08-015佣金明细

19.1 业务说明

在「佣金管理-我的佣金」中，当某笔已发放佣金发生佣金回溯时，系统需新增生成一条佣金扣款记录，用于体现本次回溯扣减金额。原佣金记录状态不作变更。

19.2 页面范围

佣金管理
└─ 我的佣金
   ├─ 佣金明细列表
   ├─ 佣金明细详情
   └─ 关联佣金明细

19.3 回溯扣款记录生成规则

字段 规则
佣金金额 记录为负数。例如原发放佣金为 40，则回溯记录为 -40。
佣金来源 “套餐退款/不同资产换货”。
状态 “回溯”。
订单号 与被回溯的原发放佣金记录订单号保持一致。
其他字段 默认沿用原发放佣金记录的对应信息，除上述字段外不做变更。

生成要求：

  1. 每次佣金回溯成功后，系统需生成一条独立的佣金扣款记录，不直接修改原发放佣金记录的佣金金额。
  2. 原发放佣金记录需保留原始发放金额、佣金来源、订单号、创建时间等信息。
  3. 回溯扣款记录金额需与本次实际回溯金额一致；全额回溯时金额等于原佣金金额的负数，部分回溯时金额等于本次回溯金额的负数。
  4. 同一回溯业务单不得重复生成佣金扣款记录，重复回调或重复提交需做幂等处理。

19.6 验收标准

  1. 已发放佣金发生回溯后，系统新增生成一条佣金扣款记录。
  2. 回溯扣款记录佣金金额为负数，佣金来源为“套餐退款/不同资产换货”，状态为“回溯”。
  3. 回溯扣款记录订单号与原发放佣金记录订单号保持一致。
  4. 除佣金金额、佣金来源、状态等回溯字段外，其他字段按规则沿用原发放佣金记录。
  5. 同一回溯业务单重复提交或重复回调时，不得重复生成扣款记录。
  6. 佣金明细导出支持导出佣金来源、佣金状态。

20.PRD-08-016资产详情

20.1 业务说明

在「资产详情-套餐详情列表」中，若主套餐存在关联加油包，系统需将主套餐与其关联加油包进行绑定展示。存在关联加油包的主套餐默认展开，展开后展示该主套餐下的加油包信息，以明确主套餐与加油包之间的从属关系。

20.2 页面范围

资产管理
└─ 资产详情
   └─ 套餐详情列表
      ├─ 主套餐记录
      └─ 关联加油包记录

20.3 套餐绑定展示规则

场景 展示规则
主套餐存在关联加油包 主套餐与加油包绑定展示，主套餐默认展开其下关联加油包信息。
主套餐不存在关联加油包 按普通套餐记录展示，无需默认展开。
加油包存在多个 按加油包生效时间或购买时间排序展示在对应主套餐下。
加油包已失效 仍归属在对应主套餐下展示，并按套餐状态展示为已失效。

展示要求：

  1. 加油包需作为主套餐的关联明细展示，不作为与主套餐同级的独立套餐记录散列展示。
  2. 主套餐行需提供展开/收起能力；存在关联加油包时默认展开，不存在关联加油包时不展示展开入口。
  3. 展开后需清晰区分主套餐与加油包，可通过层级缩进、标签、套餐类型字段等方式体现。
  4. 主套餐折叠后，仅隐藏其下关联加油包记录，不影响主套餐自身信息展示。

20.6 验收标准

  1. 主套餐存在关联加油包时，资产详情套餐详情列表默认展开展示关联加油包。
  2. 加油包展示在对应主套餐下，能清晰识别其为主套餐的关联明细。
  3. 主套餐不存在关联加油包时，按普通套餐记录展示，不显示无效展开入口。
  4. 多个加油包能按规则展示在同一主套餐下。
  5. 展开、收起操作只影响当前主套餐下的加油包展示，不影响其他套餐记录。
  6. 加油包与主套餐的关联关系可追溯，异常情况下不会重复或错挂展示。

21.PRD-08-017 运营商通道流量阈值配置

21.1 业务说明

为避免部分运营商通道存在达量断网、达量限制或特殊流量使用规则时，系统只能通过后续人工判断和临时处理，运营商管理模块需在新建运营商通道时支持配置该通道是否设置流量阈值。

当运营在“新建运营商通道”时，可根据该通道的运营商政策选择是否启用流量阈值；启用后达到流量阈值的资产对应的该通道的卡需要操作停机。且在该运营商当前周期内不允许操作复机。

21.2 页面范围

运营商管理
└─ 运营商通道管理
   ├─ 新建运营商通道
   │  └─ 流量阈值配置
   ├─ 编辑运营商通道
   │  └─ 流量阈值配置
   └─ 运营商通道详情
      └─ 流量阈值配置展示

21.3 配置字段

字段 类型 是否必填 说明
是否设置流量阈值 开关 是 新建运营商通道时即可配置；默认关闭。
流量阈值 数字 + 单位 条件必填 当“是否设置流量阈值”为开启时必填，支持 MB/GB 等单位。
阈值生效范围 系统规则 是 默认适用于该运营商通道下的卡和资产。

22. PRD-08-016 卡管自身报表模块：激活情况统计与套餐续费统计

22.1 业务说明

卡管后台需建设“报表管理”模块，第一期支持“激活情况统计表”和“套餐续费情况表”。报表用于运营按设备、套餐、用户组、代理、店铺、业务员等维度查看资产激活、在网、活跃、流量使用、套餐到期和续费转化情况，并支持按日、按月、自定义时间段查询、汇总、可视化和导出。

22.2 页面范围

报表管理
├─ 激活情况统计表
│  ├─ 查询筛选
│  ├─ 统计汇总
│  ├─ 明细列表
│  └─ 导出
└─ 套餐续费情况表
   ├─ 查询筛选
   ├─ 统计汇总
   ├─ 明细列表
   └─ 导出

22.3 公共查询与权限要求

项目 要求
时间维度 支持按日、按月；激活情况统计需支持查看某一天的累计快照，支持自定义时间段查询。
组织维度 支持按用户组、店铺、业务员分类查询和汇总。
设备维度 支持按设备名称、设备型号、制造商查询和汇总。
套餐维度 套餐续费情况表支持按套餐系列、套餐名称查询和汇总。
数据权限 按后台账号可见的数据范围展示报表，越权数据不可查询和导出。
导出权限 导出需受权限控制，并记录操作人、导出时间、筛选条件和导出结果。

22.4 激活情况统计表字段分析

22.4.1 表格字段

字段 字段类型 口径/计算规则 备注
序号 展示字段 按当前查询结果排序生成。 导出时保留。
设备名称 维度字段 资产配置中的设备名称。 支持筛选、分组。
设备型号 维度字段 资产配置中的设备型号。 支持筛选、分组。
制造商 维度字段 设备对应制造商。 支持筛选、分组。
采购数量 基础指标 系统录入的设备数量。 来源为设备入库/采购基础数据。
累计激活数（已实名） 统计指标 截至统计日，卡管内已实名设备数量；一个设备对应多张卡时，任意一张卡已实名则设备视为已实名。 使用卡管当前实名数据
激活率 计算指标 累计激活数（已实名） ÷ 采购数量 × 100%。 采购数量为 0 时展示 0 或“-”。
新增激活数 统计指标 当前统计日累计激活数 - 前一日累计激活数。 用于观察每日新增实名激活。
累计在网数（有套餐已实名） 统计指标 已实名且存在有效套餐的设备数量。 实名判断以卡管内当前实名状态为准。
活跃用户数（流量 > 0） 统计指标 套餐周期内流量使用量大于 0GB 的设备数量。 用于排除未使用流量的在网设备。
累计用量（GB） 统计指标 套餐周期内设备下所有卡的使用流量合计。 单位统一为 GB。
单用户卡均（GB） 计算指标 累计用量（GB） ÷ 累计在网数（有套餐已实名）。 分母为 0 时展示 0 或“-”。
含流量为 0 有套餐预测设备卡均（GB） 计算指标 累计用量（GB） ÷ 累计在网数（有套餐已实名） ÷ 当月已过天数 × 当月总天数。 包含流量为 0 但有有效套餐的设备。
不含流量为 0 预测设备卡均（GB） 计算指标 累计用量（GB） ÷ 活跃用户数（流量 > 0） ÷ 当月已过天数 × 当月总天数。 只统计已产生流量的活跃设备。

22.4.2 汇总与展示规则

  1. 列表底部需展示合计行，汇总采购数量、累计激活数、新增激活数、累计在网数、活跃用户数和累计用量，并按合计结果计算整体激活率和卡均指标。
  2. 报表顶部需生成文字总结，包含采购总设备数、累计实名激活数、整体激活率、有套餐在网设备数、活跃用户数、累计总流量和激活设备平均单台流量。
  3. 支持按累计日期、用户组、代理、店铺、设备型号、厂家、业务员分类输出激活情况统计表。
  4. 自定义时间段查询时，累计类指标以所选结束日期的快照为准；新增激活数按所选时间段内新增量统计。
  5. 报表数据需支持导出，导出字段与页面展示字段保持一致。

22.5 套餐续费情况表字段分析

22.5.1 表格字段

字段 字段类型 口径/计算规则 备注
套餐系列 维度字段 套餐所属系列，用于按套餐系列汇总到期和续费情况。
套餐名称 维度字段 套餐配置中的套餐名称。 支持筛选、分组。
到期数 统计指标 统计周期内套餐到期的资产数或套餐记录数。 默认按套餐到期记录统计，是否按资产去重需评审确认。
续费数 统计指标 统计周期内发生续费的资产数或续费订单数。 默认按续费订单/记录统计，需与到期数口径保持一致。
续费率 计算指标 续费数 ÷ 到期数 × 100%。 到期数为 0 时展示 0 或“-”。

22.5.2 统计周期与公式

周期 计算规则
按日 当日续费率 = 当日续费数 ÷ 当日到期数 × 100%；新增未续费数 = 当日到期数 - 当日续费数。
按月 当月续费率 = 当月续费数 ÷ 当月到期数 × 100%；支持查看月度累计到期、续费和未续费。
自定义时间段 按所选时间段汇总到期数、续费数和新增未续费数，并计算周期续费率。

22.5.3 汇总与展示规则

  1. 支持按套餐系列、套餐名称、用户组、店铺、业务员分类查询和汇总套餐续费情况。
  2. 列表需展示合计行，合计到期数、续费数、新增未续费数，并按合计值计算整体续费率。
  3. 支持按日、按月切换可视化统计趋势，展示到期数、续费数、未续费数和续费率变化。
  4. 支持导出当前查询结果，导出字段需与页面展示字段保持一致。
  5. 对同一资产在统计周期内多次续费的情况，需在评审中确认按订单笔数统计还是按资产去重统计；确认后页面说明、导出和计算逻辑需保持一致。

22.6 数据来源与计算规则

计算要求：

  1. 报表应优先使用稳定的日报/月报快照，避免历史报表因实时状态变化产生口径漂移。
  2. 涉及除法的指标需处理分母为 0 的情况，页面统一展示 0 或“-”，导出保持同口径。
  3. 百分比字段页面建议保留两位小数，导出可保留原始计算值或两位小数，需在评审中确认。
  4. 流量单位统一折算为 GB，计算和导出保持一致。

22.7 验收标准

  1. 报表管理模块下存在“激活情况统计表”和“套餐续费情况表”两个页面。
  2. 激活情况统计表支持按日期、用户组、店铺、设备名称、设备型号、厂家、业务员分类查询和导出。
  3. 激活情况统计表可正确展示采购数量、累计激活数、激活率、新增激活数、累计在网数、活跃用户数、累计用量、单用户卡均和预测设备卡均。
  4. 激活情况统计表合计行和文字总结可按当前筛选条件正确生成。
  5. 套餐续费情况表支持按日、按月、自定义时间段查询，并可按套餐系列、套餐名称、用户组、代理、店铺、业务员分类汇总。
  6. 套餐续费情况表可正确展示到期数、续费数、新增未续费数和续费率。
  7. 套餐续费情况表合计行和可视化趋势可按当前筛选条件正确生成。
  8. 两张报表均支持导出，导出结果与页面筛选条件和展示字段一致。
  9. 报表查询和导出受数据权限控制，导出操作可追溯。
  10. 指标公式、数据来源和统计口径与评审确认结果一致，并纳入测试用例。

23. PRD-008-019 优先轮询通道

23.1 业务说明

当资产处于无有效套餐、套餐过期后续购、流量用完后购买加油包等场景时，客户通常期望套餐、流量或卡状态尽快恢复可用。若这些资产仍按普通轮询队列执行，可能出现套餐已购买但状态同步延迟、流量已充值但设备仍不可用、卡状态未及时刷新等问题，影响客户使用体验和客服处理效率。

因此，系统需建设“优先轮询通道”：当命中指定业务场景时，系统自动将资产对应的卡加入优先轮询队列，优先执行套餐状态、流量余量、卡状态、实名状态和设备可用性等同步轮询。优先轮询完成后，系统需根据执行结果更新资产、卡、套餐和订单相关状态，并保留完整任务记录。

23.2 页面范围

轮询管理
├─ 优先轮询通道
│  ├─ 优先轮询队列
│  ├─ 优先轮询记录
│  ├─ 优先级规则配置
│  └─ 异常与重试记录

资产管理
├─ 资产信息
│  └─ 优先轮询状态
├─ 物联网卡管理
│  └─ 优先轮询状态
└─ 订单/套餐相关记录
   └─ 触发优先轮询记录

23.3 触发场景

触发场景 触发条件 入队对象 轮询目标
资产无有效套餐 资产当前不存在有效套餐，且存在待同步的套餐、订单或卡状态 资产对应的全部在用卡 校验套餐有效性、卡状态、设备可用性
套餐过期续购 资产套餐已过期，客户续购套餐且订单支付成功或套餐生效任务已创建 续购资产对应的在用卡 优先同步套餐生效状态、有效期和卡状态
流量用完购买加油包 主套餐流量用完或触发达量状态，客户购买加油包且支付成功或加油包生效任务已创建 购买加油包资产对应的在用卡 优先同步加油包生效、流量余量和卡状态
人工补充触发 客服、运营或管理员确认资产需立即刷新状态 指定资产或指定卡 按人工选择的轮询项执行
系统异常补偿 普通轮询失败、状态长时间未更新或订单/套餐状态不一致 异常资产对应卡 重新同步套餐、流量、卡状态和异常原因

23.4 入队规则

规则 说明
入队粒度 以资产为业务主体，以资产对应卡为实际轮询对象。一个资产存在多张卡时，需将该资产当前在用卡全部纳入优先轮询范围。
去重规则 同一资产、同一卡、同一触发场景在未完成前不得重复入队；重复触发时更新触发次数和最近触发时间。
优先级规则 套餐过期续购、流量用完购买加油包优先级高于无有效套餐；人工补充触发可按最高优先级处理。
有效期规则 优先轮询任务需设置有效期，超过有效期仍未执行成功时进入异常记录。
出队规则 轮询成功、达到最大重试次数、人工关闭、资产状态已恢复或任务过期时出队。
数据权限 运营和客服只能查看其权限范围内资产的优先轮询记录；管理员可查看全部记录。

23.5 优先轮询执行规则

  1. 系统监听套餐购买、续费、加油包购买、订单支付成功、套餐生效任务创建、资产无有效套餐状态变更等事件。
  2. 命中触发条件后，系统自动生成优先轮询任务，并写入资产 ID、设备号、ICCID、触发场景、触发来源、优先级和轮询目标。
  3. 轮询调度时，优先轮询队列需优先于普通轮询队列执行；普通轮询不得阻塞优先轮询任务。
  4. 优先轮询需支持并发控制，避免短时间大量续费或加油包购买导致外部运营商接口压力过高。
  5. 每次轮询需记录执行开始时间、结束时间、执行结果、失败原因、接口响应摘要和下一次重试时间。
  6. 轮询成功后，系统需更新资产套餐状态、套餐有效期、流量余量、卡状态和相关业务状态。
  7. 如果轮询结果显示套餐或加油包仍未生效，系统需按重试策略继续优先轮询，直到成功、过期或达到最大重试次数。
  8. 如果资产已恢复有效套餐且卡状态正常，系统需自动将该资产对应卡从优先轮询队列移出。

23.6 优先级与重试策略

优先级 场景 建议处理规则
P0 人工补充触发、套餐过期续购成功、流量用完购买加油包成功 立即进入优先轮询队列，优先执行。
P1 资产无有效套餐但存在待生效订单或套餐任务 高于普通轮询执行，按配置间隔重试。
P2 普通轮询失败后的系统异常补偿 进入优先轮询异常补偿队列，按失败原因重试。

重试要求：

  1. 支持配置最大重试次数、重试间隔和任务有效期。
  2. 失败原因属于外部接口超时、网络异常、结果不确定时，可自动重试。
  3. 失败原因属于订单未支付、套餐未创建、资产归属异常、卡不存在等业务校验失败时，不应无限重试，需进入异常记录。
  4. 达到最大重试次数仍失败时，任务状态更新为“轮询失败”，并支持人工重新触发。

23.7 页面字段

23.7.1 优先轮询队列字段

字段 说明
任务编号 系统生成的优先轮询任务唯一编号。
资产编号 被加入优先轮询的资产 ID 或资产编码。
设备号 资产对应设备编号。
ICCID 实际执行轮询的卡号。
店铺/代理 资产所属店铺和代理。
触发场景 无有效套餐、套餐过期续购、流量用完购买加油包、人工触发、异常补偿等。
触发来源 订单支付、套餐生效任务、加油包购买、人工操作、系统补偿等。
优先级 P0、P1、P2。
轮询目标 套餐状态、流量余量、卡状态、实名状态、设备可用性等。
当前状态 待执行、执行中、执行成功、轮询失败、已出队、已过期。
重试次数 当前已重试次数和最大重试次数。
最近执行时间 最近一次轮询执行时间。
下一次执行时间 下一次计划轮询时间。
失败原因 最近一次失败原因或异常摘要。
创建时间 任务入队时间。

23.7.2 资产详情展示字段

字段 说明
是否在优先轮询中 展示当前资产是否存在未完成的优先轮询任务。
最近触发场景 展示最近一次触发优先轮询的业务场景。
最近轮询结果 展示执行成功、失败、处理中、已过期等结果。
最近轮询时间 展示最近一次优先轮询执行时间。
失败原因 如执行失败，展示最近失败原因。

23.8 操作流程

23.8.1 套餐过期续购触发优先轮询

  1. 客户对已过期套餐的资产发起续购。
  2. 订单支付成功后，系统生成套餐生效任务。
  3. 系统识别该资产属于“套餐过期续购”场景。
  4. 系统将资产对应在用卡加入优先轮询队列。
  5. 优先轮询任务优先同步套餐有效期、套餐状态、卡状态和设备可用性。
  6. 同步成功后，资产恢复有效套餐状态，并从优先轮询队列出队。
  7. 同步失败时，按重试策略继续执行或进入异常记录。

23.8.2 流量用完购买加油包触发优先轮询

  1. 资产主套餐流量用完或被系统识别为流量不足。
  2. 客户购买加油包并支付成功。
  3. 系统生成加油包生效任务。
  4. 系统将资产对应在用卡加入优先轮询队列。
  5. 优先轮询任务同步加油包生效状态、流量余量和卡状态。
  6. 确认加油包生效且流量恢复后，任务执行成功并出队。
  7. 若加油包未生效或接口结果不确定，系统继续重试并保留失败原因。

23.8.3 资产无有效套餐触发优先轮询

  1. 系统识别资产当前无有效套餐。
  2. 判断该资产是否存在待支付订单、已支付待生效订单、待生效套餐或异常套餐任务。
  3. 若存在待同步业务，系统将资产对应卡加入优先轮询队列。
  4. 优先轮询任务同步套餐状态、卡状态和设备可用性。
  5. 若确认资产已恢复有效套餐，则任务成功出队。
  6. 若确认资产确实无有效套餐且无待生效业务，则任务结束并记录原因。

23.9 异常处理

异常场景 处理方式
同一资产重复触发入队 不重复创建任务，更新触发次数和最近触发时间。
资产对应多张卡 按资产当前在用卡全部执行轮询，并记录每张卡执行结果。
卡不存在或卡已解绑 不执行轮询，记录业务校验失败原因。
订单未支付或支付结果不确定 暂不执行套餐生效类轮询，等待支付结果确认或进入结果不确定记录。
外部接口超时 记录失败原因，按配置间隔重试。
外部接口返回失败 记录响应摘要，根据失败码判断是否重试或转人工处理。
达到最大重试次数 任务状态更新为轮询失败，支持人工重新触发。
资产已恢复正常 自动出队，不再继续优先轮询。

23.10 数据记录要求

需记录：任务编号、资产 ID、资产编号、设备号、ICCID、店铺 ID、代理 ID、订单号、套餐 ID、加油包 ID、触发场景、触发来源、优先级、轮询目标、任务状态、入队时间、最近执行时间、下一次执行时间、出队时间、重试次数、最大重试次数、执行结果、失败原因、接口请求摘要、接口响应摘要、操作人、人工触发原因和操作日志。

23.11 验收标准

  1. 资产无有效套餐且存在待同步订单、套餐或卡状态时，系统可将资产对应卡加入优先轮询通道。
  2. 套餐过期续购支付成功后，系统可自动将资产对应在用卡加入优先轮询通道。
  3. 流量用完后购买加油包支付成功后，系统可自动将资产对应在用卡加入优先轮询通道。
  4. 优先轮询队列执行优先级高于普通轮询队列。
  5. 同一资产、同一卡、同一触发场景未完成前不得重复创建优先轮询任务。
  6. 一个资产存在多张在用卡时，系统可对全部在用卡执行优先轮询，并分别记录执行结果。
  7. 优先轮询成功后，系统可更新套餐状态、套餐有效期、流量余量、卡状态和资产状态。
  8. 轮询失败时，系统可记录失败原因，并按配置执行重试。
  9. 达到最大重试次数或任务过期后，系统可进入异常记录并支持人工重新触发。
  10. 资产详情和物联网卡详情可展示当前是否处于优先轮询中、最近触发场景、最近轮询结果和失败原因。
  11. 优先轮询任务的入队、执行、失败、重试、出队和人工处理均可追溯。

24. PRD-008-020需要过滤时间段: 年月日 时分秒

1，Lot卡任务：无法支持 2.设备任务：无法支持 3.临期列表：可支持 但希望优化为一个字段选择开始和结束，同其他筛选时间样式 4.换货管理：不支持 5.分配记录：不支持 6.授权记录：支持，可使用 7.导出支持 8.订单列表不支持 9.代理充值没看到时间筛选字段： 10.佣金明细不支持，查询无效（我的佣金中的佣金明细） 11.提现记录不支持（我的佣金中的提现记录）

25. PRD-008-021 代理自充收款方式可配置

代理自充收款方式由后台超管账号可自定义配置：仅微信支付、仅支付宝支付、同时支持。

Reference in New Issue View Git Blame Copy Permalink