refactor(pay): 充值商品以充值金额为唯一真值,移除销售金额与折扣
充值商品行此前是双值模型:price 充值金额决定到账、pay_price 销售金额决定支付, pay_price 为 0 时回落到 price,否则即「付更少拿更多」的折扣。该模型把三处耦合在 一起——后台 schema 暴露销售金额输入、线格式首段携带支付额、下单时计价与到账分离。 只改其中一处就会出现「后台不再可配但前端仍在展示折扣」或「展示已合并但下单仍按 旧价扣款」的静默不一致,故本次三层一并收口,充值金额即实际支付金额。 后台 schema 有两份且必须同步:SPA 侧 recharge.js 负责渲染表单,PHP 侧 SchemaPayment 负责默认值与清洗。只改一份会让界面不再可配而默认值仍在写 pay_price。 线格式三段 "支付|到账|标题" 保持不动,仅为兼容历史已存的字符串配置:支付段不再读取 任何配置来源,恒等于充值金额,故历史配置里的折扣价会被忽略。旧数据无需迁移,pay_price 键留在库中只是不再被读取,从重建后的后台保存一次即自然消失。 行为变化(需知悉): - 已配置折扣的站点,其用户将按充值金额全额支付,即对这些用户是涨价。这是「不做优惠 和促销」的必然结果。 - parse_packages 的校验口径随之变松:有效性只由到账段决定,故 "abc|10|x" 这类首段 非法、到账段合法的行会被解析为 10 元档,而旧实现两段都作金额校验、会丢弃。理由是 支付段已不表达任何含义,因一个无用字段是垃圾就丢弃一条本来有效的档位只会让运营困惑。 既有数据不受影响——旧格式化器写出的首段恒为数字,只有手改出的脏数据才可能命中。 该取舍已写入方法文档。 - recharge.js / SchemaPayment:删除 pay_price 字段与三档默认值中的该键,help 去掉 「同时支持设置折扣」 - PaymentRuntime::format_product_lines:不再读取 pay_price,支付段由充值金额充当 - BalanceServiceCharge::parse_packages:不再产出 pay_price 键,金额唯一来源为到账段 - BalanceServiceCharge::create_charge_order:支付额与到账额同源于 price - credits-wallet.php:移除销售金额行、「省X」折扣徽标及仅服务折扣的差额计算 - BalanceServiceRest:仅注释改写,说明积分路径的 pay_price 是售价而非折扣 - 新增 tests/widget-system/recharge-product-price-contract.test.cjs:5 条跨层契约 范围边界:积分商品 pay_points_product 的 pay_price 是「积分|支付|标签」里的实际售价, 本身不含折扣语义,保留不动。契约测试以正向断言固定该边界,避免日后被误当作同类问题 一并删掉。 验证:新增契约测试 5 项通过;node --test 全量 375 项 / 375 通过(原 370 项);PHPUnit 44 项 / 106 断言通过;改动的 PHP 文件 php -l 全部通过。变异验证:把 create_charge_order 改回按 pay_price 计价、把 pay_price 重新注入模板,对应断言分别转红,证明回归测试拦得 住回退。另以反射调用真实代码做端到端执行验证 11 项全过,覆盖结构化数组 -> 线格式 -> 商品数组全链路、数组内残存 pay_price 被忽略、历史折扣字符串(98|100|旧折扣档 取 100)、 到账段为 0 或非法时跳过等边界。 部署提示:assets/admin/build 为部署时构建、未入库,后台表单的改动需在目标机执行 cd assets/admin && npm ci && npm run build 后才会生效。前端 credits.js 走 filemtime 版本号,无需手工清缓存。
This commit is contained in:
@@ -151,17 +151,13 @@ $charge_custom_block = static function () use ($mark, $charge_mark_html, $charge
|
||||
<?php if ($packages) : ?>
|
||||
<div class="charge-box mb20">
|
||||
<div class="muted-color mb6"><?php esc_html_e('请选择充值金额', 'aksrt'); ?></div>
|
||||
<?php foreach ($packages as $idx => $pkg) :
|
||||
$package_credit = $normalize_balance($pkg['price'] ?? '');
|
||||
$package_pay = $normalize_balance($pkg['pay_price'] ?? '');
|
||||
$package_saving_minor = max(0, $package_credit->minor() - $package_pay->minor());
|
||||
?>
|
||||
<?php foreach ($packages as $idx => $pkg) : ?>
|
||||
<div class="zib-widget vip-product relative product-box<?php echo $idx === 0 ? ' active' : ''; ?>" data-for="balance_product" data-value="<?php echo esc_attr((string) $pkg['key']); ?>">
|
||||
<?php if (!empty($pkg['tag'])) : ?>
|
||||
<div class="abs-right vip-tag badg jb-yellow"><?php echo esc_html((string) $pkg['tag']); ?></div>
|
||||
<?php endif; ?>
|
||||
<?php /* 充值金额即实际支付金额,不设折扣,故金额只呈现一次。 */ ?>
|
||||
<div class="em14"><?php echo $charge_mark_html; // phpcs:ignore WordPress.Security.EscapeOutput -- escaped span + esc_html mark above ?><?php echo esc_html((string) $pkg['price']); ?></div>
|
||||
<div class="c-red"><?php echo $charge_mark_html; // phpcs:ignore WordPress.Security.EscapeOutput ?><span><?php echo esc_html((string) $pkg['pay_price']); ?></span><?php if ($package_saving_minor > 0) : ?><span class="ml6 c-yellow smail"><?php printf(esc_html__('省%s', 'aksrt'), esc_html(\AKSRT\Ledger\AssetAmount::decimal_from_minor($package_saving_minor) . $charge_unit)); ?></span><?php endif; ?></div>
|
||||
</div>
|
||||
<?php endforeach; ?>
|
||||
<?php if ($custom_s) : ?>
|
||||
|
||||
Reference in New Issue
Block a user