feat: 实名即生效套餐沉默期、延期办理与资产出库时间
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:
邹进
2026-10-27 16:32:58 +09:00
parent d2b0d2f534
commit 909f4d0ec2
112 changed files with 10473 additions and 82 deletions

View File

@@ -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** 回填后出库时间仍为空

View File

@@ -0,0 +1,19 @@
## ADDED Requirements
### Requirement: 沉默期已过期的套餐不能退款
沉默期总开关打开时,退款申请创建 MUST 拦截 `silence_status = expired` 的套餐,返回 `silence_expired_not_refundable`。沉默期延期费 MUST NOT 退款,仅在延期执行异常时按支付单冻结的商户原路退回。
#### Scenario: 申请退款过期套餐
- **WHEN** 为一笔沉默期已过期的套餐发起退款申请
- **THEN** 系统拒绝,返回 `silence_expired_not_refundable`
### Requirement: 换货时沉默期随套餐迁移
换货迁移套餐记录时,沉默期字段 MUST 随记录迁移,不重新起算、不重新给沉默期;现有迁移条件 `status IN (0,1,2)` 已包含 `waiting` 与 `expired` 记录,无需修改。迁移后:`waiting` 记录按新资产实名事实判定;`expired` 记录仍为过期,可在新资产上延期。延期执行按套餐记录当前载体,审批在换货前提交、换货后通过的,延期作用于迁到新资产的同一笔套餐。迁移 MUST 写沉默期流水(换货单号、前后资产、截止时间)。
#### Scenario: 过期套餐换货后延期
- **WHEN** 卡 A 上一笔沉默期已过期的套餐随换货迁到卡 B
- **THEN** 套餐在卡 B 上仍为过期,截止日不变,可在卡 B 上办理延期

View File

@@ -0,0 +1,15 @@
## ADDED Requirements
### Requirement: 排队与孤儿恢复跳过沉默期已过期套餐
沉默期总开关打开时,排队取下一个主套餐(`getNextPendingMainPackage`)MUST 跳过 `silence_status = expired` 的套餐记录,避免过期套餐挡住同资产后续套餐;孤儿待生效套餐扫描(`findAndActivateOrphanPackages`)的候选查询 MUST 排除 `silence_status = expired` 的记录,不得为其重复提交激活任务。总开关关闭时行为与现状一致。
#### Scenario: 队首是过期套餐
- **WHEN** 当前主套餐到期,同资产队首待生效套餐 `silence_status = expired`,其后还有一笔正常待生效套餐
- **THEN** 系统跳过过期套餐,激活其后的正常套餐
#### Scenario: 孤儿扫描不选中过期套餐
- **WHEN** 资产没有生效中主套餐,唯一的待生效主套餐已沉默期过期
- **THEN** 孤儿扫描不选中该记录,不提交激活任务

View File

@@ -0,0 +1,157 @@
## ADDED Requirements
### Requirement: 延期政策可配置
系统 SHALL 提供延期政策 `tb_package_silence_extension_policy` 的列表、详情、新增、编辑、启停与"查询某套餐当前匹配政策",需 `package_silence:policy` 权限,变更写审计。政策字段:名称、适用范围(`all` 全部 / `series` 系列 / `package` 指定套餐)与范围 ID、每月单价(分)、免费延期次数、付费延期累计最多月数、单次最多月数(可空)、免审批场景(多选)、生效与失效时间、启停。配置按月填写,1 个月 = 30 天。
匹配规则:候选为启用且在生效期内的政策,优先级"指定套餐 > 套餐系列 > 全部套餐";同一优先级的适用范围与生效时间段 MUST NOT 重叠,保存时重叠返回 `silence_policy_overlap`。上线预置一条"全部套餐、长期有效、500 分/月、免费 1 次、累计 6 个月、单次不限、无免审批场景"的默认政策。
延期订单、批次与明细 MUST 冻结政策快照(政策 ID 与名称、单价、免审批场景、免费次数、付费累计与单次上限);修改或停用政策只影响之后发起的延期。
#### Scenario: 按优先级匹配
- **WHEN** 存在全部套餐政策(5 元/月)与"年卡"系列政策(3 元/月),为年卡系列套餐查询延期资格
- **THEN** 单价返回 300 分
#### Scenario: 同级重叠
- **WHEN** 新建一条与已有系列政策同系列、生效时间重叠的政策
- **THEN** 保存失败,返回 `silence_policy_overlap`
#### Scenario: 改价不影响已创建订单
- **WHEN** 延期订单创建后政策单价从 5 元改为 8 元
- **THEN** 该订单仍按 5 元计价
### Requirement: 延期资格与计费
系统 SHALL 提供按套餐记录查询延期资格的接口(后台与 H5 同语义),返回:能否付费延期 `can_extend` 与原因、能否申请特殊延期、原截止日、已过期天数、最少与最多可输入天数、最少与最多月数、已累计与已付费延期天数、能否申请免费延期、单价、各月数选项(计费天数、金额、新截止日)。计算 MUST 由后端完成,不接受前端传入金额:
```text
overdue_days = 今天日期 − 套餐截止日期
min_months = floor(overdue_days / 30) + 1
remain = 政策.paid_max_months − silence_paid_extended_days / 30
max_months = min(remain, 政策.single_max_months)(单次上限为空时取 remain)
min_days = overdue_days + 1;max_days = max_months × 30
months = ceil(输入天数 / 30);计费天数 = 延长天数 = months × 30
amount = months × 政策单价
新截止日 = (原截止日 + 延长天数) 当日 23:59:59
```
前置条件:套餐 `silence_status = expired`(`waiting` 但已到期的先判定为过期)。未到期、无沉默期、已激活、已退款的拒绝。套餐 `silence_extension_enabled = false` 或未匹配到政策时不能付费延期,但可申请特殊延期。`min_months > max_months` 时不能付费延期。总开关关闭时返回 `silence_feature_disabled`。
#### Scenario: 过期 75 天的资格
- **WHEN** 套餐截止日 2026-10-01,2026-12-15 查询,默认政策,未延期过
- **THEN** 返回 `overdue_days = 75`、`min_days = 76`、`max_days = 180`、`min_months = 3`、`max_months = 6`、单价 500
#### Scenario: 按天向上取整计费
- **WHEN** 客户输入 1、30、31、60 天
- **THEN** 分别按 30、30、60、60 天计费并延长相同天数
#### Scenario: 超过可延期期限
- **WHEN** 截止日 2026-10-01,2027-04-05 查询(已过期 186 天),默认政策
- **THEN** `can_extend = false`,返回 `min_months = 7`、`max_months = 6`,特殊延期仍可申请
### Requirement: 在线付费延期
客户在 H5 自助下单,或运营在后台创建订单并生成支付二维码由客户扫码支付,MUST 支付成功后自动延期,不审批。
- 创建延期订单(`tb_package_silence_extension_order`)与支付单 `tb_payment`(`order_type = silence_extension`);商户按支付方式经 `merchantpayment` 商户池路由选择并冻结在支付单上;后台二维码复用渠道适配器生成支付内容存入 `qr_content`。
- 下单时冻结输入天数、月数、单价、金额、下单时截止日与预计新截止日;按当天重算 min/max 校验。
- 同一笔套餐同时最多一笔未结束订单:新建前若已有待支付订单,先对旧支付单查单,确认未支付则关闭旧订单再新建,已支付则按已支付处理并不再新建。
- 支付回调按 `order_type` 分发,条件更新 `pending_payment → paid → completed`,重复回调幂等;回调金额不一致进入 `exception`。未支付订单复用支付恢复任务查单,过期关闭。
- 支付时新截止日不再晚于当天的,明细进入 `exception`,按冻结的商户原路退款。
- 回调、查单、退款按支付单冻结的商户加载凭证,不按当前商户池推断。
- 延期费不参与分佣,不计入代理累计充值与业绩。不从代理钱包扣款。
#### Scenario: H5 付款后自动延期
- **WHEN** 客户在 H5 输入 76 天,微信支付 15 元成功
- **THEN** 订单 `completed`,套餐截止日延长 90 天,回到 `waiting`,不产生审批与佣金
- **AND** 订单列表显示支付方式、收款商户名称、交易流水号
#### Scenario: 后台二维码与客户旧订单冲突
- **WHEN** 客户已有一笔未支付的 H5 延期订单,运营为同一套餐生成二维码
- **THEN** 系统先查单旧支付单,未支付则关闭旧订单后生成新二维码
#### Scenario: 重复支付回调
- **WHEN** 同一支付单的成功回调到达两次
- **THEN** 只延期一次
### Requirement: 线下付费延期
运营(`package_silence:offline`)登记线下付款时 SHALL 输入延期天数(换算后月数在 min~max 内),填写线下收款方式(复用现有线下收款方式字典)、交易单号、实收金额、付款时间,上传收款凭证与客户申请依据。实收金额 MUST 等于系统计算金额,否则返回 `silence_offline_amount_mismatch`;同一收款方式下交易单号 MUST 唯一,重复返回 `silence_offline_trade_no_duplicate`。
政策未勾选免审批场景 `offline_paid` 时,订单 `pending_approval` 并提交企微审批(申请类型"线下付费延期"):通过后执行延期,驳回或撤回订单 `rejected`、不延期、系统不退款。勾选时登记即执行。线下付费计入付费累计天数,受政策上限与套餐"是否支持延期"约束。
#### Scenario: 默认需审批
- **WHEN** 运营登记一笔 15 元线下付款,政策未设免审批
- **THEN** 订单待审批,审批通过后延期生效
#### Scenario: 交易单号重复
- **WHEN** 同一收款方式下再次登记相同交易单号
- **THEN** 系统拒绝
### Requirement: 特殊延期
有权限的运营 SHALL 可提交特殊延期:免费、优惠价、客诉补偿、系统异常补偿、特殊客户政策;批量延期需上传明细且仅限 `package_silence:extend_batch`。申请字段包括资产、套餐与订单号、原截止日(系统带出)、延期天数(按天向上取整到 30 的倍数)、原因、客户申请记录或截图、费用(免费为 0)、免费或优惠依据;优惠价有收款的同时登记线下收款信息。
特殊延期 MUST NOT 受政策付费上限与套餐"是否支持延期"约束,只要求新截止日晚于今天(月数 ≥ min_months),天数不计入付费累计。免费延期次数 MUST 受政策 `free_extension_limit`(默认 1)约束:提交与执行时都校验,执行成功后计数加 1;驳回与撤回不占次数;同一笔套餐同时只能有一个进行中的免费延期申请。
政策未勾选对应免审批场景(批量看 `batch`,否则看延期类型)时提交企微审批(申请类型"特殊延期"),通过后自动执行,驳回或撤回不产生任何变化;勾选时提交即执行。需审批的场景 MUST NOT 先延期后补审批。批量延期逐条执行,部分失败不影响其他行,记录成功数、失败数与失败原因。
#### Scenario: 免费延期次数用完
- **WHEN** 套餐已成功使用 1 次免费延期,政策免费次数为 1,再次申请免费延期
- **THEN** 拒绝,返回 `silence_free_extension_used_up`
#### Scenario: 付费办不了仍可特殊延期
- **WHEN** 套餐已过期 186 天、付费延期不可办理
- **THEN** 仍可提交特殊延期,月数不受上限限制
#### Scenario: 批量部分失败
- **WHEN** 批量特殊延期 10 条,审批通过时其中 2 条已被退款
- **THEN** 8 条延期成功,2 条记失败及原因
### Requirement: 延期执行
所有延期路径 MUST 在同一事务内执行:锁载体与套餐记录并重读;校验仍为 `expired`、新截止日晚于当天;付费延期另校验单次与累计上限(按政策快照);更新 `silence_status = waiting`、`silence_deadline_at = SilenceDeadline(原截止日期, 延长天数)`、累计延期天数、付费延期天数(付费延期)、延期次数、免费次数(免费延期);同事务写明细状态、批次计数、流水与审计;提交后执行沉默期判定,期内已实名则激活或排队。执行以明细状态条件更新保证幂等。执行失败进入 `exception`,有 `package_silence:exception` 权限者可重试或关闭,MUST NOT 直接改库时间。事务内 MUST NOT 调用支付渠道、Gateway 或企微接口。
延期只延长实名等待时间,不增加套餐使用时长;延期后再次到期未实名可再次延期。
#### Scenario: 延期时资产已实名
- **WHEN** 卡在过期后、延期前已实名,延期后新截止日晚于实名时间
- **THEN** 延期执行后套餐立即激活(或排队)
#### Scenario: 重复审批通过事件
- **WHEN** 同一审批单的通过事件到达两次
- **THEN** 只执行一次延期
### Requirement: 沉默期企微审批场景
系统 SHALL 新增一个企微审批业务类型 `package_silence_approval`,用模板中的"申请类型"控件区分"购买时调整沉默期""特殊延期""线下付费延期"。申请人为发起人绑定的企微成员(`creator_userid`),审批人按模板配置(`use_template_approver = 1`);发起人未绑定企微成员时拒绝提交。回调按审批单关联的业务记录(调整申请 / 延期批次 / 延期订单)分发,不依赖表单文本。复用现有场景配置、模板指纹校验、可靠提交、回调与轮询。勾选为免审批的场景不提交到本场景。
#### Scenario: 发起人未绑定企微
- **WHEN** 未绑定企微成员的运营提交特殊延期
- **THEN** 系统拒绝提交
### Requirement: 延期订单查询
系统 SHALL 提供延期订单列表、详情与导出:后台按套餐、资产、订单号、状态、支付方式、收款商户、交易流水号、支付时间筛选,叠加店铺数据范围;在线订单返回 `payment_method`、`payment_merchant_name`、`third_party_trade_no`(取已支付或已退款支付单快照),线下订单返回收款方式与交易单号;H5 客户查看自己的延期订单。延期订单纳入财务交易流水查询与导出。交易记录不删除。
#### Scenario: 查询在线延期订单
- **WHEN** 后台查询一笔已完成的微信延期订单
- **THEN** 返回收款商户名称与交易流水号,与线上套餐订单字段一致

View File

@@ -0,0 +1,178 @@
## ADDED Requirements
### Requirement: 实名即生效套餐沉默期按每笔套餐计算
系统 SHALL 在订单支付成功、创建套餐记录的同一事务内,为满足条件的套餐记录设置沉默期:主套餐(`master_usage_id IS NULL`)、生效条件快照为 `from_activation`、购买时资产尚未实名(`pending_realname_activation = true`)、所购套餐已配置默认沉默期。沉默期字段 MUST 保存在套餐记录上,资产上 MUST NOT 保存沉默期字段。同一资产的多笔实名即生效套餐 MUST 各自计算。
截止时间 MUST 按天计算:`(支付成功日期 + 沉默期天数) 当日 23:59:59`,时区 `Asia/Shanghai`,由唯一领域函数计算。
#### Scenario: 资产未实名时购买实名即生效套餐
- **WHEN** 2026-09-24 10:00 为未实名的卡购买默认沉默期 30 天的实名即生效主套餐并支付成功
- **THEN** 套餐记录 `silence_status = waiting`、`silence_start_at` 为支付成功时间、`silence_period_days = 30`
- **AND** `silence_deadline_at = 2026-10-24 23:59:59`
- **AND** 写入一条沉默期流水(set),含默认值快照、是否调整、操作人、原因
#### Scenario: 不进入沉默期的套餐
- **WHEN** 购买的是加油包、购买即生效套餐,或购买时资产已实名,或套餐未配置默认沉默期
- **THEN** 套餐记录 `silence_status` 为空,行为与现状一致
#### Scenario: 同一资产多笔套餐各自计算
- **WHEN** 同一张未实名卡在 09-01 与 09-20 各购买一笔实名即生效套餐
- **THEN** 两笔套餐的截止日分别按各自的支付日期计算,一笔过期不影响另一笔
### Requirement: 套餐默认沉默期与是否支持延期配置
实名即生效套餐 MUST 配置默认沉默期 `silence_period_days`(1~90 天,新建时预填 30)与 `silence_extension_enabled`(默认支持);普通套餐 MUST NOT 写入沉默期。修改默认值 MUST 只影响之后的新购买,并写审计。系统 SHALL 提供"未配置沉默期的实名即生效套餐"清单(筛选与导出)。
#### Scenario: 实名即生效套餐未填默认沉默期
- **WHEN** 新建或编辑 `from_activation` 套餐时未提供 `silence_period_days`,或值不在 1~90
- **THEN** 系统拒绝保存,返回 `silence_period_out_of_range`
#### Scenario: 修改默认值不影响已购买记录
- **WHEN** 将套餐默认沉默期从 30 改为 45
- **THEN** 已有套餐记录的截止日不变,之后的新购买按 45 天计算
### Requirement: 禁止绕过沉默期的生效条件变更
系统 MUST 在套餐服务与店铺分配(单个、批量、系列授权)写入路径的共用校验中阻断:套餐 `from_activation` 改为 `from_purchase`、分配覆盖把 `from_activation` 套餐改为 `from_purchase`、分配覆盖把 `from_purchase` 套餐改为 `from_activation`。套餐 `from_purchase` 改为 `from_activation` 时同一请求 MUST 提供默认沉默期。
#### Scenario: 实名即生效改为购买即生效
- **WHEN** 管理员把实名即生效套餐改为购买即生效,或在店铺分配上覆盖为购买即生效
- **THEN** 系统拒绝,返回 `package_expiry_base_change_forbidden`
### Requirement: 后台购买时调整沉默期
后台给资产购买会进入沉默期的套餐时,有 `package_silence:override` 权限的运营 SHALL 可以设置本次沉默期(≥ 1 天,不设上限),必须填写原因;优先级为本次设置值高于套餐默认值。
- 设置值不超过默认值:直接生效。
- 设置值超过默认值:按匹配到的延期政策判断;未勾选免审批场景 `purchase_adjust`(含未匹配到政策)时,系统 MUST 先按默认值创建套餐记录,同时提交企微审批(申请类型"购买时调整沉默期"),并标记 `silence_adjust_pending = true`;勾选时直接按设置值生效。
- 审批中的套餐 MUST NOT 因到期而过期。审批通过后按 `起算日期 + 审批天数` 重算截止日;驳回或撤回保持默认值。审批结束后立即重新判定沉默期。
- 自动购包、钱包自动续费等无人参与的路径 MUST 只用默认值。
#### Scenario: 无权限传入调整值
- **WHEN** 无 `package_silence:override` 权限的账号在购买时传入沉默期
- **THEN** 系统拒绝,返回 `silence_override_forbidden`
#### Scenario: 超默认值需审批
- **WHEN** 默认 30 天的套餐在后台购买时设置为 120 天,政策未设免审批
- **THEN** 套餐记录按 30 天设置截止日,`silence_adjust_pending = true`,并提交企微审批
- **AND** 审批期间超过 30 天截止日也不会过期
- **AND** 审批通过后截止日改为购买日期 + 120 天;若重算后已过截止且期内未实名,立即过期
#### Scenario: 超默认值且政策免审批
- **WHEN** 匹配到的延期政策勾选了 `purchase_adjust`
- **THEN** 套餐记录直接按设置值计算截止日,不提交审批
### Requirement: 实名与过期判定
系统 SHALL 用统一判定处理 `waiting` 的套餐记录:期内已实名则沉默期结束(`ended`),之后按现有逻辑激活;同资产已有生效主套餐时继续排队,排队期间不再受沉默期限制。已到期、期内未实名且无调整审批的,MUST 标记为 `expired`,`status` 保持 0,记录 `silence_expired_at`,写流水与审计。
实名时间取实际业务时间:卡取 `first_realname_at`;设备取所有已绑定且已实名卡中 `max(卡实名时间, 绑定时间)` 的最小值。卡当前已实名但 `first_realname_at` 为空时 MUST 视为期内已实名,并补写 `first_realname_at` 为判定时间。
判定入口包括:运营商实名观测与人工实名、卡绑定设备、排队接续、指定激活、孤儿套餐扫描、延期生效、调整审批结束、沉默期扫描。
#### Scenario: 截止日当天实名
- **WHEN** 截止日为 10-24 23:59:59,卡在 10-24 23:30 实名
- **THEN** 套餐 `silence_status = ended` 并按现有逻辑激活,有效期从激活时间起算
#### Scenario: 截止后实名
- **WHEN** 卡在 10-25 08:00 才实名
- **THEN** 套餐标记为 `expired`,不激活
#### Scenario: 截止后才绑定已实名卡的设备
- **WHEN** 设备套餐截止后,才绑定一张早已实名的卡
- **THEN** 设备实名时间取绑定时间,晚于截止日,套餐过期
#### Scenario: 期内实名但需排队
- **WHEN** 资产在截止前实名,但同资产已有生效主套餐
- **THEN** 这笔套餐 `silence_status = ended`、`status` 仍为 0 排队,之后按排队接续激活,不再因沉默期过期
#### Scenario: 实名时间为空的已实名卡
- **WHEN** 卡 `real_name_status` 为已实名但 `first_realname_at` 为空
- **THEN** 判定为期内已实名,不判过期,并补写 `first_realname_at`
### Requirement: 沉默期已过期的套餐不能激活
`silence_status = expired` 的套餐 MUST NOT 被任何激活入口激活。`ActivationService.canActivatePendingUsage` MUST 在现有实名判断前先执行沉默期判定,过期时返回不可激活。对外展示 MUST 显示"沉默期已过期(失效)"并返回截止日与过期时间。任何人 MUST NOT 通过修改时间或状态把 `expired` 恢复为 `waiting`;只能通过延期。
#### Scenario: 过期套餐实名后仍不激活
- **WHEN** 已过期套餐所属卡完成实名
- **THEN** 套餐不激活,仍为 `expired`
#### Scenario: 已到期但尚未被扫描
- **WHEN** 套餐仍为 `waiting` 但已过截止日,此时触发任一激活入口
- **THEN** 入口先判定为过期,不激活
### Requirement: 沉默期扫描
系统 SHALL 每 10 分钟运行 `package:silence:scan`,查询 `status = 0 AND silence_status = 'waiting' AND silence_deadline_at < now() AND silence_adjust_pending = false` 的记录(单批 200,最多 20 批,Unique 9 分钟,MaxRetry 3),逐条执行统一判定。状态更新 MUST 带期望状态条件并检查影响行数,重复执行幂等。扫描只在总开关打开时运行。
#### Scenario: 扫描与实时判定一致
- **WHEN** 扫描和实名事件同时处理同一条到期记录
- **THEN** 只有一方更新成功,结果一致,审计只写一次
### Requirement: 沉默期总开关
系统 SHALL 提供系统配置 `package.silence.enabled`,默认关闭,仅超级管理员可切换,每次切换写审计 `package.silence_switch_changed`(操作人、前后值、检查结果)。
- 关闭时:新购买照常写入沉默期字段(只记录);不拦截激活、不扫描、不拦截退款、不展示沉默期与延期入口;延期资格、下单、线下登记、特殊延期申请返回 `silence_feature_disabled`;套餐与政策配置、审批模板配置、历史回填工具可用;购买时调整照常记录与提交审批。
- 打开前检查:实名即生效套餐全部已配置默认沉默期;没有"待实名、实名即生效主套餐、沉默期字段为空"的记录;存在启用中的"全部套餐"延期政策;企微审批场景 `package_silence_approval` 已配置启用。任一项不满足 MUST 拒绝打开,返回 `silence_switch_precheck_failed` 及未满足项与数量。
- 打开后:所有规则同时生效,扫描开始运行。
- 打开后再关闭:规则暂停、数据保留;已发生的付款回调、查单补偿与审批回调 MUST 照常处理完;关闭期间不接受新的延期申请。
#### Scenario: 默认关闭时行为不变
- **WHEN** 总开关关闭,未实名卡购买实名即生效套餐后超过截止日才实名
- **THEN** 套餐记录有截止日,但实名后照常激活,不判过期
#### Scenario: 检查未通过拒绝打开
- **WHEN** 仍有 3 个实名即生效套餐未配置默认沉默期时尝试打开
- **THEN** 系统拒绝,返回未满足项"未配置默认沉默期的套餐:3"
#### Scenario: 应急关闭时处理进行中的付款
- **WHEN** 总开关打开后又关闭,此时一笔延期订单的支付回调到达
- **THEN** 回调照常处理并执行延期
### Requirement: 历史数据回填
系统 SHALL 提供沉默期回填工具,可在总开关关闭时运行。前提是相关套餐的默认沉默期已补齐。回填范围为 `status = 0 AND pending_realname_activation = true` 的实名即生效主套餐记录;起算为该笔套餐的购买(支付成功)时间;天数取套餐默认沉默期;未配置的套餐不回填并列入清单。回填时 MUST 同时按实名时间判定,截止前已实名的直接记为 `ended`。不给上线宽限:截止早于上线日且期内未实名的,打开总开关后过期。
回填 MUST 先生成影响清单(套餐记录数、按代理与套餐分布、期内已实名数、实名时间为空的已实名数、将过期数、将过期且无法付费延期数),经业务确认后执行;每条写流水(backfill);可重复执行。
#### Scenario: 回填时已实名
- **WHEN** 历史套餐按购买时间算出的截止日之前,卡已实名
- **THEN** 回填记为 `ended`,不会过期
#### Scenario: 回填后截止日已过
- **WHEN** 历史套餐购买于 2026-03-01、默认 30 天,上线日为 2026-11-15,卡未实名
- **THEN** 回填截止日为 2026-03-31 23:59:59,打开总开关后第一轮扫描标记为过期
### Requirement: 沉默期变更留痕
套餐沉默期的设置、调整、过期、结束、延期、换货迁移、回填 MUST 写入不可变流水 `tb_package_silence_record`(套餐记录、事件类型、变更前后状态与截止时间、天数、默认值快照、是否调整、操作人、原因、审批单号、延期明细、时间),并写对应审计事件。系统 SHALL 提供按套餐查询流水的接口。
#### Scenario: 查询一笔套餐的沉默期历史
- **WHEN** 查询某笔经历过购买、过期、延期的套餐流水
- **THEN** 依次返回 set、expired、extend 三条记录及前后截止时间