feat: 实名即生效套餐沉默期、延期办理与资产出库时间
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Failing after 8m39s
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Failing after 8m39s
- 迁移 000259~000265:套餐记录沉默期字段与扫描索引、套餐默认沉默期、延期政策/流水/订单/批次/明细 5 张表、默认政策与系统配置(总开关默认关闭)、企微审批白名单、卡与设备出库时间及出库记录 - 沉默期设置(订单发放、自动购包、钱包续费)、后台购买时调整(超默认值按政策免审或企微审批)、统一判定与激活闸门、排队与孤儿扫描跳过过期套餐、过期套餐禁止退款、每 10 分钟扫描 - 总开关专用接口与打开前 4 项检查;延期政策;延期资格与计费;H5 自助与后台二维码在线支付(商户池路由)、支付回调与查单恢复、线下登记、特殊/批量延期、异常重试与原路退款;沉默期审批场景与终态处理 - 换货沉默期流水与出库时间;卡/设备列表、详情、导出与出库记录接口;延期订单与即将过期套餐列表及导出;财务流水纳入延期支付 - 沉默期与出库时间回填工具 cmd/silence-backfill;前端接口变更说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,49 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 卡与设备出库时间
|
||||
|
||||
系统 SHALL 为 IoT 卡与设备记录出库时间 `outbound_at` = 资产当前世代第 1 次购买套餐(主套餐或加油包)的订单支付成功时间。卡取单卡订单,设备取设备订单;**当前绑定在设备上的卡不记录出库时间**(套餐在设备上)。出库时间写入后 MUST NOT 被后续订单覆盖,首笔订单退款也不清空。出库时间只用于展示、筛选与导出,MUST NOT 参与业务判断,不受沉默期总开关影响。
|
||||
|
||||
写入发生在订单支付后发放套餐的两个入口(订单 `activatePackage`、自动购包 `activatePackages`)的同一事务内:`UPDATE ... SET outbound_at = :paid_at WHERE id = :asset_id AND generation = :order_generation AND outbound_at IS NULL`,影响行数为 1 时插入出库记录。
|
||||
|
||||
#### Scenario: 首次购买写入
|
||||
|
||||
- **WHEN** 新卡当前世代第一次支付套餐订单
|
||||
- **THEN** 卡 `outbound_at` 为该订单支付时间,并新增一条出库记录(来源 `order`,带订单号)
|
||||
|
||||
#### Scenario: 后续订单不覆盖
|
||||
|
||||
- **WHEN** 同一世代再次购买套餐,或首笔订单被退款
|
||||
- **THEN** `outbound_at` 不变
|
||||
|
||||
#### Scenario: 设备上绑定的卡
|
||||
|
||||
- **WHEN** 设备订单支付成功,设备上绑定了两张卡
|
||||
- **THEN** 只写设备的出库时间,两张卡不写
|
||||
|
||||
### Requirement: 出库记录
|
||||
|
||||
系统 SHALL 用 `tb_asset_outbound_record` 保存每个世代的出库记录:资产类型与 ID、资产标识快照、世代、出库时间、来源(`order` / `exchange` / `backfill`)、订单号或换货单号、店铺、结束时间与原因。同一资产同一世代只有一条(唯一约束);记录只新增与填写结束信息,不修改出库时间、不删除。系统 SHALL 提供按资产查询各世代出库记录的接口。
|
||||
|
||||
#### Scenario: 换货后历史可查
|
||||
|
||||
- **WHEN** 资产换货回库后再次销售并购买套餐
|
||||
- **THEN** 能查到两条记录:旧世代带结束时间与原因 `exchange_return`,新世代为新的出库时间
|
||||
|
||||
### Requirement: 换货时的出库时间
|
||||
|
||||
换货时旧资产世代 +1、回到在库的同一事务内,系统 MUST 清空旧资产 `outbound_at` 并为旧世代记录填写结束时间与原因;换货后的新资产若当前世代出库时间为空,MUST 写入换货完成时间并插入出库记录(来源 `exchange`,带换货单号)。
|
||||
|
||||
#### Scenario: 换货新资产
|
||||
|
||||
- **WHEN** 卡 A 换成卡 B 完成
|
||||
- **THEN** 卡 A 出库时间清空,卡 B 出库时间为换货完成时间
|
||||
|
||||
### Requirement: 出库时间历史回填与展示
|
||||
|
||||
系统 SHALL 提供出库时间回填工具:按资产当前世代最早一笔已支付或已退款的套餐订单回填(排除当前绑定在设备上的卡),分批执行、只更新为空的、可重复执行,并插入来源 `backfill` 的出库记录;回填前输出可回填数与无订单数。老系统迁移、新系统无订单的资产保持为空,后续另行回填。卡列表、设备列表返回出库时间并支持按时间范围筛选;卡详情、设备详情与资产解析返回出库时间;卡、设备导出增加"出库时间"列。字段与记录只读。
|
||||
|
||||
#### Scenario: 无订单资产
|
||||
|
||||
- **WHEN** 老系统迁移的卡在新系统没有任何套餐订单
|
||||
- **THEN** 回填后出库时间仍为空
|
||||
Reference in New Issue
Block a user