feat(v2): 对账主体——周期查单收敛 + 已付订单抽查 + 退款修复扫描/卡滞告警 + main 装配 reconcile Runner

Task 5(债务 #6):两条腿收敛对账——① SyncPendingTask 调度 P2 gateway.SyncPendingAttempts 逐 pending attempt 查单收敛(防掉单);② PaidSpotCheckTask 对近期已付 attempt 反查渠道核对金额/币种,漂移(渠道侧已退款/拒付而本地仍 paid)只告警不改状态。追加两条 P4 T3 opus review 义务(该 review 产出时本 worktree 已分叉,P4 退款主体在主 checkout;这里对本 worktree 已有的 store.RefundStore/OrderStore 接口——P4 T2,在 base 里——建自愈扫描,设计为可在合并 P4 后继续工作): - RefundApplyTask:退款修复扫描,重算 succeeded 退款之和,自愈「退款成功但订单卡 paid」的崩溃窗口(MarkRefundStatus 翻 succeeded 后、ApplyRefundToOrder 调用前崩溃)。候选订单 =有 succeeded 退款的订单 ∪ 当前处于 refunding/partially_refunded 态的订单;走既有 ApplyRefundToOrder 条件 UPDATE,目标态与当前态一致时跳过,天然幂等。 - RefundStuckAlertTask:卡滞 processing/manual_pending 退款超阈值(默认 30min)打 WARN, 只观测不改状态;渠道退款查询 API 面留待后续。 main 装配前 4 job(order-expire/usage-refresh/sync-pending/paid-spotcheck)+ 上述两个退款 job 挂上 reconcile.Runner;acctPicker 的 limit_aware 用量源改用 reconcile.NewUsageSource 替 NopUsage。crypto 冷启动 Warm/孤儿扫描(AddCryptoJobs)留给 Task 6 追加。 config.go 新增 ReconcileConfig(含 Task 6 预留的 orphan_* 字段)+ 默认值;crypto.go 补 SetReservationLoader 构造后注入 setter(Task 6 依赖)。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u
2026-07-10 17:45:01 +08:00
parent 4ac4e6ca9f
commit 04c3f4f31a
11 changed files with 678 additions and 2 deletions
@@ -0,0 +1,119 @@
+package reconcile
+
+import (
+	"context"
+	"log"
+	"time"
+
+	"github.com/wangjia/pay/internal/model"
+	"github.com/wangjia/pay/internal/store"
+)
+
+// RefundApplyTask 是「RefundApply 修复扫描」:P4 T3 opus review 追加的义务(P4 退款
+// 代码本体在主 checkout,未落到本 worktree;此处只对本 worktree 已有的
+// store.RefundStore/OrderStore 接口(P4 T2,在 base 里)建自愈扫描,设计为能在合并
+// P4 后继续工作)。
+//
+// 动机:退款成功的崩溃窗口 —— RefundStore.MarkRefundStatus 把某笔退款翻成
+// succeeded 后,调用方在再调 OrderStore.ApplyRefundToOrder 前进程崩溃/网络抖动,
+// 订单状态卡在 paid(或旧的 partially_refunded),与「已实际退款成功」的事实脱节。
+// 本任务周期重算每个候选订单的 succeeded 退款之和,按既有 ApplyRefundToOrder 的
+// 条件 UPDATE 语义重新 apply 一次 —— 状态已一致时 UPDATE 影响 0 行,天然幂等。
+//
+// 候选订单 = distinct(有 succeeded 退款的订单) ∪ (当前处于 refunding/partially_refunded
+// 态的订单):前者直接命中"退款成功但订单未跟上"的崩溃窗口;后者兜住"已在退款流程
+// 中、但后续又有退款 succeeded 未被重算"的情形。
+func RefundApplyTask(orders *store.OrderStore, refunds *store.RefundStore, limit int) func(ctx context.Context) error {
+	return func(ctx context.Context) error {
+		succeededNos, err := refunds.ListDistinctOutTradeNosByStatus(model.RefundSucceeded, limit)
+		if err != nil {
+			return err
+		}
+		refundingOrders, err := orders.ListOrdersByStatus(
+			[]model.OrderStatusV2{model.OrderRefundingV2, model.OrderPartRefundedV2}, limit)
+		if err != nil {
+			return err
+		}
+
+		seen := make(map[string]bool, len(succeededNos)+len(refundingOrders))
+		candidates := make([]string, 0, len(succeededNos)+len(refundingOrders))
+		for _, no := range succeededNos {
+			if !seen[no] {
+				seen[no] = true
+				candidates = append(candidates, no)
+			}
+		}
+		for i := range refundingOrders {
+			no := refundingOrders[i].OutTradeNo
+			if !seen[no] {
+				seen[no] = true
+				candidates = append(candidates, no)
+			}
+		}
+
+		for _, no := range candidates {
+			if err := reapplyRefundState(orders, refunds, no); err != nil {
+				log.Printf("[reconcile] 退款修复扫描 out_trade_no=%s: %v", no, err)
+			}
+		}
+		return nil
+	}
+}
+
+// reapplyRefundState 对单个订单重算 succeeded 退款之和并按需重新 apply 状态转移。
+// 只有目标态与当前态不同才真正调用 ApplyRefundToOrder(避免每轮扫描都打"翻转"日志噪声);
+// 没有 succeeded 退款(sum==0)的订单跳过 —— 它不属于本扫描要修的窗口。
+func reapplyRefundState(orders *store.OrderStore, refunds *store.RefundStore, outTradeNo string) error {
+	succ, err := refunds.RefundSum(outTradeNo, model.RefundSucceeded)
+	if err != nil {
+		return err
+	}
+	if succ <= 0 {
+		return nil
+	}
+	o, err := orders.GetOrder(outTradeNo)
+	if err != nil {
+		return err
+	}
+
+	fully := succ >= o.AmountMinor
+	next := model.OrderPartRefundedV2
+	if fully {
+		next = model.OrderRefundedV2
+	}
+	if o.Status == next {
+		return nil // 已一致,无需自愈
+	}
+
+	flipped, err := orders.ApplyRefundToOrder(outTradeNo, fully)
+	if err != nil {
+		return err
+	}
+	if flipped {
+		log.Printf("[reconcile][退款自愈] out_trade_no=%s 本地曾卡于 %s,succeeded 退款 %d/%d → 重新 apply 为 %s",
+			outTradeNo, o.Status, succ, o.AmountMinor, next)
+	}
+	return nil
+}
+
+// RefundStuckAlertTask 是「卡滞 processing/manual_pending 退款告警」义务:同 sweep
+// 家族的姊妹任务,只读观测 —— 只打 WARN,绝不改状态(状态机翻转是
+// RefundApplyTask/业务方的事)。渠道退款查询 API 面(主动向渠道问退款进度)留待后续;
+// 这里先用「本地卡滞时长」兜底可见性。
+func RefundStuckAlertTask(refunds *store.RefundStore, threshold time.Duration, now func() time.Time) func(ctx context.Context) error {
+	return func(ctx context.Context) error {
+		cutoff := now().Add(-threshold)
+		stuck, err := refunds.ListStuckRefunds(
+			[]model.RefundStatus{model.RefundProcessing, model.RefundManualPending}, cutoff, 200)
+		if err != nil {
+			return err
+		}
+		for i := range stuck {
+			r := &stuck[i]
+			log.Printf("[reconcile][WARN][退款卡滞] refund_id=%s out_trade_no=%s status=%s 已卡滞 %s(阈值 %s)——"+
+				"仅观测告警不改状态;渠道退款查询 API 面留待后续",
+				r.RefundID, r.OutTradeNo, r.Status, now().Sub(r.UpdatedAt).Round(time.Minute), threshold)
+		}
+		return nil
+	}
+}