- 字段 outbound_at → first_purchase_at,记录表 tb_asset_outbound_record → tb_asset_first_purchase_record,接口 /outbound-records → /first-purchase-records,筛选参数与导出列同步更名 - 换货后的新资产不因换货写入,在当前世代真正支付套餐订单时才记录;记录来源只保留 order / backfill,去掉换货单字段 - 迁移 000266 重命名列、表、索引与约束;同步 Spec、设计、任务与前端接口变更说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.7 KiB
ADDED Requirements
Requirement: 卡与设备首次购买套餐时间
系统 SHALL 为 IoT 卡与设备记录首次购买套餐时间 first_purchase_at = 资产当前世代第一笔套餐订单(主套餐或加油包)的支付成功时间。卡取单卡订单,设备取设备订单;当前绑定在设备上的卡不记录(套餐在设备上)。写入后 MUST NOT 被后续订单覆盖,首笔订单退款也不清空。该时间只用于展示、筛选与导出,MUST NOT 参与业务判断,不受沉默期总开关影响。
写入发生在订单支付后发放套餐的入口(订单 activatePackage、自动购包 activatePackages、钱包自动续费)的同一事务内:UPDATE ... SET first_purchase_at = :paid_at WHERE id = :asset_id AND generation = :order_generation AND first_purchase_at IS NULL,影响行数为 1 时插入首次购买套餐记录。
Scenario: 首次购买写入
- WHEN 新卡当前世代第一次支付套餐订单
- THEN 卡
first_purchase_at为该订单支付时间,并新增一条首次购买套餐记录(来源order,带订单号)
Scenario: 后续订单不覆盖
- WHEN 同一世代再次购买套餐,或首笔订单被退款
- THEN
first_purchase_at不变
Scenario: 设备上绑定的卡
- WHEN 设备订单支付成功,设备上绑定了两张卡
- THEN 只写设备的首次购买套餐时间,两张卡不写
Requirement: 首次购买套餐记录
系统 SHALL 用 tb_asset_first_purchase_record 保存每个世代的首次购买套餐记录:资产类型与 ID、资产标识快照、世代、首次购买套餐时间、来源(order / backfill)、订单号、店铺、结束时间与原因。同一资产同一世代只有一条(唯一约束);记录只新增与填写结束信息,不修改时间、不删除。系统 SHALL 提供按资产查询各世代记录的接口。
Scenario: 换货回库后历史可查
- WHEN 资产换货回库后再次销售并购买套餐
- THEN 能查到两条记录:旧世代带结束时间与原因
exchange_return,新世代为新的首次购买套餐时间
Requirement: 换货时的首次购买套餐时间
换货时旧资产世代 +1、回到在库的同一事务内,系统 MUST 清空旧资产 first_purchase_at 并为旧世代记录填写结束时间与原因。换货后的新资产 MUST NOT 因换货完成而写入首次购买套餐时间;套餐记录随换货迁移不算购买,新资产在当前世代真正支付套餐订单时才按首次购买写入。
Scenario: 换货新资产未购买套餐
- WHEN 卡 A 换成卡 B 完成,套餐记录迁移到卡 B,卡 B 当前世代没有支付过套餐订单
- THEN 卡 A 首次购买套餐时间清空;卡 B 首次购买套餐时间为空,直到卡 B 当前世代第一笔套餐订单支付成功
Requirement: 首次购买套餐时间历史回填与展示
系统 SHALL 提供首次购买套餐时间回填工具:按资产当前世代最早一笔已支付或已退款的套餐订单回填(排除当前绑定在设备上的卡),分批执行、只更新为空的、可重复执行,并插入来源 backfill 的记录;回填前输出可回填数与无订单数。老系统迁移、新系统无订单的资产保持为空,后续另行回填。卡列表、设备列表返回首次购买套餐时间并支持按时间范围筛选;卡详情、设备详情与资产解析返回该时间;卡、设备导出增加"首次购买套餐时间"列。字段与记录只读。
Scenario: 无订单资产
- WHEN 老系统迁移的卡在新系统没有任何套餐订单
- THEN 回填后首次购买套餐时间仍为空