同步回执广义筛选控制器注释口径

This commit is contained in:
萝卜
2026-03-19 00:49:18 +08:00
parent 39208840d7
commit dd03499b8f

View File

@@ -284,7 +284,7 @@ class PlatformOrderController extends Controller
'batch_mark_activated_24h' => (string) $request->query('batch_mark_activated_24h', ''),
// 只看“对账不一致”的订单粗版meta.payment_summary.total_amount 与 paid_amount 不一致
'reconcile_mismatch' => (string) $request->query('reconcile_mismatch', ''),
// 支付回执筛选has有回执/none无回执
// 支付回执筛选has有回执/none无回执(广义)
'receipt_status' => trim((string) $request->query('receipt_status', '')),
// 退款轨迹筛选has有退款/none无退款
'refund_status' => trim((string) $request->query('refund_status', '')),
@@ -1367,7 +1367,7 @@ class PlatformOrderController extends Controller
'batch_mark_activated_24h' => (string) $request->query('batch_mark_activated_24h', ''),
// 只看“对账不一致”的订单粗版meta.payment_summary.total_amount 与 paid_amount 不一致
'reconcile_mismatch' => (string) $request->query('reconcile_mismatch', ''),
// 支付回执筛选has有回执/none无回执
// 支付回执筛选has有回执/none无回执(广义)
'receipt_status' => trim((string) $request->query('receipt_status', '')),
// 退款轨迹筛选has有退款/none无退款
'refund_status' => trim((string) $request->query('refund_status', '')),
@@ -1605,7 +1605,7 @@ class PlatformOrderController extends Controller
return redirect()->back()->with('warning', '当前筛选为「有退款」订单集合。为避免带退款订单直接同步订阅,请先完成退款治理(核对退款回执/修正状态)后再批量同步订阅。');
}
// 防误操作(回执治理优先):当用户显式筛选「无回执」时,禁止直接批量同步
// 防误操作(回执治理优先):当用户显式筛选「无回执(广义)」时,禁止直接批量同步
// 原因:已支付/已生效但无回执证据的订单属于收费闭环缺口,应先补齐回执留痕(可治理、可对账)再同步订阅。
if ($scope === 'filtered'
&& ($filters['syncable_only'] ?? '') === '1'
@@ -1937,7 +1937,7 @@ class PlatformOrderController extends Controller
return redirect()->back()->with('warning', '当前已勾选「只看可同步」:该集合语义为“已生效(activated)+未同步”,与本动作处理的“待处理(pending)”互斥。请先取消只看可同步后再执行。');
}
// 治理优先:当用户显式筛选「无回执」时,不允许直接批量生效
// 治理优先:当用户显式筛选「无回执(广义)」时,不允许直接批量生效
if ((string) ($filters['receipt_status'] ?? '') === 'none') {
return redirect()->back()->with('warning', '当前筛选为「无回执(广义)」订单集合。为保证收费闭环可治理,请先补齐支付回执留痕后再执行批量仅标记为已生效。');
}
@@ -2534,7 +2534,7 @@ class PlatformOrderController extends Controller
->when(($filters['receipt_status'] ?? '') !== '', function (Builder $builder) use ($filters) {
// 支付回执筛选:
// - has有回执payment_summary.total_amount 存在 或 payment_receipts[0].amount 存在)
// - none无回执两者都不存在
// - none无回执广义payment_summary / payment_receipts 两者都不存在)
$status = (string) ($filters['receipt_status'] ?? '');
if ($status === 'has') {