break
1e4f998fe7
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m11s
104 lines
8.5 KiB
Markdown
104 lines
8.5 KiB
Markdown
# 七月迭代人工验收清单
|
||
|
||
> 用途：前后端联调完成后的逐项人工核对。页面可访问不等于验收通过；每项至少检查权限、正常路径、失败路径、重复操作和最终数据。
|
||
|
||
## 一、业务需求
|
||
|
||
- [ ] **UR#33 套餐临期提醒**：核对 0～15 天临期列表、0～3 天置顶、Dashboard 数量、C 端续费入口，以及 15/7/3 天向全部有效店铺账号、有效绑定的平台业务员和资产绑定个人账号发送防重站内通知；正文明确资产标识、到期状态和到期日期。
|
||
- [ ] **UR#34 充值审核流程**：核对代理在线扫码充值与平台线下代充值隔离；支付、企微审批、重复回调和入账补偿正确；到账后通知全部有效店铺账号及有效绑定的平台业务员，正文明确店铺名称和精确到分的充值金额。
|
||
- [ ] **UR#35 退款审核**：核对企微审批、整单终结、钱包回充、套餐失效和佣金处理；重复终态不重复退款或通知；退款完成后通知全部有效店铺账号及有效绑定的平台业务员。
|
||
- [ ] **UR#36 批量订购套餐**：核对 CSV 上传、跨代理资产、统一支付方式、逐行结果、部分成功、失败原因、任务恢复及重复执行不重复扣款。
|
||
- [ ] **UR#37 企业微信审核流转**：核对企微应用、模板、成员绑定、代理固定代提交人、回调、主动同步和异常恢复；系统内不得提供本地同意或拒绝入口。
|
||
- [ ] **UR#38 不同渠道额度处理**：核对角色默认信用只影响新店铺；已有店铺单独调额；扣款、冻结、退款、充值及并发修改遵守代理主钱包信用边界。
|
||
- [ ] **UR#40 下架套餐历史续费**：核对下架套餐不能新购，但历史使用资产可以续费；直接请求不能绕过资格校验。
|
||
- [ ] **UR#42 统一导出与字段权限**：核对角色字段配置、不同角色最终列、数据行范围、CSV/XLSX、任务恢复及受保护附件。当前仓库已知角色级导出字段权限尚未实现。
|
||
- [ ] **UR#43 代理系列套餐批量授权**：核对首次授权必须包含套餐；后续支持批量新增、改价和移除；已授权项不可重复选择，并兼容 `packages[].remove`。
|
||
- [ ] **UR#44 列表提交人与审批摘要**：核对退款、充值、换货列表的提交人、审批来源、审批状态、当前审批人和处理状态；分页不得逐行请求审批详情。
|
||
- [ ] **UR#45 换货新旧资产独立搜索**：核对旧资产和新资产筛选互不混淆，支持 ICCID、接入号和虚拟号，组合筛选及数据权限正确。
|
||
- [ ] **UR#46 预计最终到期时间**：核对无套餐、单套餐、多个排队套餐和未知激活时间；后台详情、卡/设备列表与 C 端结果一致。
|
||
- [ ] **UR#47 卡片手动限速**：核对仅 IoT 卡详情提供固定档位和恢复不限速；设备无入口；明确失败与结果未知提示正确。
|
||
- [ ] **UR#48 不同资产使用不同支付方式**：核对卡、设备允许方式不同；订单创建固化方式，支付再次校验；配置变化后旧单取消重建。
|
||
- [ ] **UR#49 设备批量分配代理和套餐系列**：核对两个独立入口、CSV 文本格式、任务进度、部分成功、失败明细、重试幂等及平台代理权限。
|
||
- [ ] **UR#53 卡和设备实名状态筛选**：核对全部、已实名、未实名筛选；设备状态随绑定、解绑、换卡正确变化，翻页保留筛选条件。
|
||
- [ ] **UR#55 套餐生效条件**：核对套餐默认值、代理覆盖值和最终值；只影响未来购买；订单和使用记录保存并使用购买快照。
|
||
- [ ] **UR#57 退款中禁止换货**：核对活跃退款资产创建换货直接失败且不产生半成品；退款拒绝、撤销或处理完成后允许换货。
|
||
- [ ] **UR#60 店铺联系电话检索**：核对 11 位联系电话精确查询、非法号码、空结果及代理数据范围。
|
||
- [ ] **UR#62 H5 购买与实名顺序**：核对无需实名、先实名后购买、先购买后实名三种流程；卡/设备批量配置和冲突提示正确。
|
||
- [ ] **UR#73 按运营商实名能力控制复机**：核对不能只按行业卡放行；不同运营商的无需实名、模板实名、Gateway 实名规则分别生效。
|
||
- [ ] **UR#86 资产换货链**：核对资产详情前代、后代和链路跳转；旧资产、新资产、中间资产及无权限场景正确。
|
||
- [ ] **UR#94 卡状态同步与运营商回调**：核对轮询、手动刷新、业务操作和移动/联通/电信回调统一更新；设备号不得传给要求 ICCID 的 Gateway。
|
||
- [ ] **UR#96 店铺业务员归属**：核对店铺创建、编辑、清空、筛选和详情；只能绑定启用的平台账号，代理不能指定其他业务员。
|
||
- [ ] **UR#97 代理钱包低余额提醒**：核对现金可用余额首次降至 100 元以下时通知一次；持续低位不重复，回升后可再次触发。
|
||
- [ ] **UR#98 换货新资产继承店铺**：核对换货完成后新资产自动继承旧资产店铺；前端不能选择目标店铺；重复完成幂等且不能越权换入其他店铺资产。
|
||
|
||
需求16明确排除，不应出现对应入口、迁移或业务逻辑。
|
||
|
||
## 二、公共技术能力
|
||
|
||
- [ ] **七月公共开发基础**：Outbox、幂等、异步任务五态、配置、迁移和任务中断恢复。
|
||
- [ ] **公共站内通知**：未读数、列表、已读、防重、接收人和受控跳转。
|
||
- [ ] **全局审计与外部集成追踪**：人员、资源、资金、风险、请求链路和外部调用。该部分曾移出当前交付范围，应单独确认最终约定。
|
||
|
||
## 三、临期功能专项验证
|
||
|
||
### 3.1 实时列表
|
||
|
||
```http
|
||
GET /api/admin/expiring-assets
|
||
```
|
||
|
||
该接口每次请求都根据当前套餐、排队套餐和购买快照实时计算，不依赖定时任务。建议准备预计最终到期分别为 15、8、7、4、3、0、已过期和无法预计的资产，核对：
|
||
|
||
- [ ] 只有剩余 0～15 个上海自然日且可精确推算的资产进入列表。
|
||
- [ ] 0～3 天为红色并优先，4～7 天为紫色，8～15 天为粉色。
|
||
- [ ] 已过期、无套餐和等待未知实名激活的资产不进入临期列表。
|
||
- [ ] 卡、设备数量汇总和分页列表使用相同筛选及权限口径。
|
||
|
||
### 3.2 手动触发通知扫描
|
||
|
||
```http
|
||
POST /api/admin/expiring-assets/reminder-scan
|
||
Authorization: Bearer <超级管理员Token>
|
||
```
|
||
|
||
成功响应示例：
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"data": {
|
||
"task_type": "package:expiry:reminder",
|
||
"message": "套餐临期提醒扫描任务已提交"
|
||
}
|
||
}
|
||
```
|
||
|
||
接口只允许超级管理员调用，并立即提交与每日 03:00 相同的异步任务。Worker 只处理当天恰好剩余 15、7、3 天的资产，随后通过 Outbox 向全部有效店铺账号、当前有效平台业务员和资产绑定的个人账号生成站内通知。
|
||
|
||
- [ ] API 返回成功后 Worker 日志出现“开始执行套餐临期节点提醒”。
|
||
- [ ] 15、7、3 天资产产生通知；其他剩余天数不产生节点通知。
|
||
- [ ] 所属店铺的所有启用店铺账号都收到通知，不限于主账号。
|
||
- [ ] 店铺当前绑定且启用的平台业务员收到通知；已禁用、已换绑或非平台账号不收到。
|
||
- [ ] 资产绑定的启用个人账号仍收到通知。
|
||
- [ ] 同一资产、到期日、节点和接收人重复触发不重复通知。
|
||
- [ ] 未绑定启用个人账号的资产仍可正常向店铺侧通知，不产生错误个人通知。
|
||
- [ ] Worker 或 Outbox 暂时失败后可重试，且最终仍只有一条通知。
|
||
|
||
## 四、全链路检查
|
||
|
||
- [ ] **INT-01**：实名、复机、卡状态同步和运营商回调。
|
||
- [ ] **INT-02**：换货创建、退款拦截、完成、资产归属和换货链。
|
||
- [ ] **INT-03**：套餐授权、购买、生效条件、续费、预计到期和临期提醒。
|
||
- [ ] **INT-04**：CSV 批量任务、进度恢复、导出和字段权限。
|
||
- [ ] **INT-05**：支付方式、扫码充值、钱包信用、退款回充和余额预警。
|
||
- [ ] **INT-06**：企微审批、退款、线下充值和重复回调。
|
||
- [ ] **INT-07**：IoT 卡限速和 Gateway 调用。
|
||
- [ ] **INT-08**：权限收回、重复提交、Worker 重启、外部超时和发布回滚。
|
||
|
||
## 五、依据
|
||
|
||
- [七月迭代技术方案（标准评审稿）](./7月迭代技术方案-标准评审稿.md)
|
||
- [七月迭代禅道研发需求逐条录入稿](./7月迭代禅道研发需求逐条录入稿.md)
|
||
- [七月迭代 AI 实施与验收操作手册](./七月迭代-AI实施与验收操作手册.md)
|