- 迁移 000259~000265:套餐记录沉默期字段与扫描索引、套餐默认沉默期、延期政策/流水/订单/批次/明细 5 张表、默认政策与系统配置(总开关默认关闭)、企微审批白名单、卡与设备出库时间及出库记录 - 沉默期设置(订单发放、自动购包、钱包续费)、后台购买时调整(超默认值按政策免审或企微审批)、统一判定与激活闸门、排队与孤儿扫描跳过过期套餐、过期套餐禁止退款、每 10 分钟扫描 - 总开关专用接口与打开前 4 项检查;延期政策;延期资格与计费;H5 自助与后台二维码在线支付(商户池路由)、支付回调与查单恢复、线下登记、特殊/批量延期、异常重试与原路退款;沉默期审批场景与终态处理 - 换货沉默期流水与出库时间;卡/设备列表、详情、导出与出库记录接口;延期订单与即将过期套餐列表及导出;财务流水纳入延期支付 - 沉默期与出库时间回填工具 cmd/silence-backfill;前端接口变更说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
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 由后端完成,不接受前端传入金额:
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 返回收款商户名称与交易流水号,与线上套餐订单字段一致