[WLOS-010] 澄清白名单修正规则与验收口径

plan/2026-01-23_16-45-56-whitelist-order-status-complete.md

@@ -17,6 +17,21 @@ created_at: 2026-01-23T16:45:56.6767838+08:00
    - 明确“白名单支付”的判定字段：`order_basic_info.pay_mode` 是否恒为 `3`（参考 `OrderPayModeEnum.PAYMENT_OF_WHITELIST`），以及是否需要同时检查支付流水 `order_pay_record.pay_mode`。
    - 定义修正规则：仅对白名单支付订单，且当前状态 ∈ {`ABNORMAL(4)`, `STAY_SETTLEMENT(2)`} 时修正为 `ORDER_COMPLETE(6)`；确认是否需要同步设置 `settlement_time`、`order_amount`、`refund_amount`、`virtual_amount`、`settle_amount`、`pay_status` 等字段。
 
+✅ 规则清单（可实现/可测试）
+- 白名单判定：以 `order_basic_info.pay_mode == OrderPayModeEnum.PAYMENT_OF_WHITELIST(3)` 为主（系统业务字段）；若存在支付流水，可选做一致性校验 `order_pay_record.pay_mode == OrderPayRecordEnum.WHITELIST_PAYMENT(3)`，不一致时仅记录告警日志，不阻断补偿。
+- 修正边界：仅当订单状态 ∈ {`ABNORMAL(4)`, `STAY_SETTLEMENT(2)`} 才允许修正为 `ORDER_COMPLETE(6)`；其余状态必须保持不变。
+- 字段同步（补偿落库时）：
+  - `order_status`：置为 `ORDER_COMPLETE(6)`
+  - `settlement_time`：为空则置当前时间；非空保持原值
+  - 金额字段默认策略（尽量沿用既有结算逻辑的语义）：
+    - `order_amount`：优先保留已有值；为空则使用 `pay_amount`，仍为空则置 0；若 `order_amount > pay_amount` 则以 `pay_amount` 为准
+    - `virtual_amount`：白名单支付场景置为 `order_amount`（不参与结算对账）
+    - `settle_amount` / `actual_received_amount`：置为 `order_amount - virtual_amount`（白名单场景为 0）
+    - `refund_amount`：为空则置为 `max(pay_amount - order_amount, 0)`
+  - `pay_status`：优先保留原值；为空则置 `OrderPayStatusEnum.pay_nothing(2)`
+- 副作用约束：补偿方法为 DB/缓存层修正，不应触发远程停机、拉交易记录、MQ 推送、解锁等额外链路（如需触发，应另起规则与验收）。
+- 审计日志：至少记录 `orderCode`、原状态、目标状态（必要时补充关键字段快照）。
+
 2. 代码定位与影响面梳理
    - 定位现有白名单异常订单批量处理入口：`jsowell-admin/src/main/java/com/jsowell/service/TempService.java` 的 `whiteListSettlement` 与 `jsowell-admin/src/main/java/com/jsowell/api/uniapp/customer/TempController.java` 的 `/whiteListSettlement`。
    - 查找订单状态被设置为异常/待结算的路径，确认修正应放在“状态写入点”还是“事后补偿点”。重点关注：