package distributionwithdrawal import ( "context" "time" "gorm.io/gorm" "gorm.io/gorm/clause" approvalapp "github.com/break/junhong_cmp_fiber/internal/application/approval" "github.com/break/junhong_cmp_fiber/internal/model" "github.com/break/junhong_cmp_fiber/pkg/auditcontext" "github.com/break/junhong_cmp_fiber/pkg/constants" "github.com/break/junhong_cmp_fiber/pkg/errors" ) // WithdrawalApprovalHandler 将渠道无关企业微信终态应用到提现申请。 // 通过时仅一次从冻结余额扣减并保持 WithdrawalStatusApproved=2,同时写入到账时间; // 驳回、撤销与删除仅一次释放本次尝试的冻结余额并记录释放时间; // 通过后撤销不回滚、不重新冻结、不自动重提,只写入正交异常标记与原因。 type WithdrawalApprovalHandler struct { db *gorm.DB audit AuditWriter } // NewWithdrawalApprovalHandler 创建佣金提现审批终态消费者。 func NewWithdrawalApprovalHandler(db *gorm.DB, audit AuditWriter) *WithdrawalApprovalHandler { return &WithdrawalApprovalHandler{db: db, audit: audit} } // Handle 幂等消费标准审批终态。 // 业务标识为提现审批尝试记录主键;先锁定尝试记录并校验审批实例一致,再按条件更新推进状态。 func (h *WithdrawalApprovalHandler) Handle(ctx context.Context, event approvalapp.TerminalDecisionEvent) error { if h == nil || h.db == nil || h.audit == nil { return errors.New(errors.CodeInternalError, "佣金提现审批终态能力未配置") } if event.BusinessType != constants.ApprovalBusinessTypeCommissionWithdrawal || event.BusinessID == 0 || event.InstanceID == 0 { return errors.New(errors.CodeInvalidParam, "佣金提现审批终态参数无效") } ctx = auditcontext.With(ctx, auditcontext.Context{ CorrelationID: event.CorrelationID, ParentEventID: event.EventID, }) return h.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error { // 全库统一加锁顺序:申请行 → 尝试行 → 钱包行(钱包永远最后)。 // 因此先用不加锁读取得 request_id,再按序加锁,避免与退款回扣路径形成死锁环。 var lookup model.CommissionWithdrawalRequestAttempt if err := tx.WithContext(ctx).Select("id", "request_id"). First(&lookup, event.BusinessID).Error; err != nil { if err == gorm.ErrRecordNotFound { return errors.New(errors.CodeNotFound, "提现审批尝试记录不存在") } return errors.Wrap(errors.CodeDatabaseError, err, "查询提现审批尝试记录失败") } request, err := lockWithdrawalRequest(ctx, tx, lookup.RequestID) if err != nil { return err } var attempt model.CommissionWithdrawalRequestAttempt if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}). First(&attempt, event.BusinessID).Error; err != nil { if err == gorm.ErrRecordNotFound { return errors.New(errors.CodeNotFound, "提现审批尝试记录不存在") } return errors.Wrap(errors.CodeDatabaseError, err, "锁定提现审批尝试记录失败") } if attempt.ApprovalInstanceID == nil || *attempt.ApprovalInstanceID != event.InstanceID { return errors.New(errors.CodeConflict, "提现审批尝试记录关联的审批实例不一致") } if attempt.RequestID != request.ID { return errors.New(errors.CodeConflict, "提现审批尝试记录归属已变化") } if request.LatestAttemptID != attempt.ID { // 已被更新尝试取代的历史尝试终态不再改变申请事实。 return nil } switch event.Decision { case constants.ApprovalDecisionApproved: return h.applyApproved(ctx, tx, request, &attempt, event) case constants.ApprovalDecisionRejected, constants.ApprovalDecisionCancelled, constants.ApprovalDecisionDeleted: return h.applyClosed(ctx, tx, request, &attempt, event) case constants.ApprovalDecisionRevokedAfterApproved: return h.applyRevoked(ctx, tx, request, &attempt, event) default: return errors.New(errors.CodeInvalidParam, "不支持的提现申请审批终态") } }) } // applyApproved 仅一次从冻结余额扣减,保持已通过状态并写入到账时间。 // 幂等守卫为「申请仍待审核 + paid_at 为空 + 尝试未释放」的条件更新且影响行数为 1。 func (h *WithdrawalApprovalHandler) applyApproved( ctx context.Context, tx *gorm.DB, request *model.CommissionWithdrawalRequest, attempt *model.CommissionWithdrawalRequestAttempt, event approvalapp.TerminalDecisionEvent, ) error { wallet, err := lockCommissionWallet(ctx, tx, request.ShopID) if err != nil { return err } now := time.Now().UTC() if attempt.ReleasedAt != nil { // 已结算的尝试不再扣减,避免重复扣款。 return nil } if wallet.FrozenBalance < attempt.Amount { return errors.New(errors.CodeConflict, "冻结余额不足以完成提现扣减,请人工核对") } // 通过即视为已到账:先以 released_at IS NULL 条件更新标记本次冻结已结算,保证重复回调不重复扣减。 settled, err := markAttemptReleased(ctx, tx, attempt, now) if err != nil { return err } if !settled { return nil } // 通过时保持状态 2 并写入到账时间,禁止使用已到账状态值 4。 result := tx.WithContext(ctx).Model(&model.CommissionWithdrawalRequest{}). Where("id = ? AND status = ? AND paid_at IS NULL", request.ID, constants.WithdrawalStatusPending). Updates(map[string]any{ "status": constants.WithdrawalStatusApproved, "paid_at": now, "processed_at": now, "updater": 0, }) if result.Error != nil { return errors.Wrap(errors.CodeDatabaseError, result.Error, "标记提现申请已通过失败") } if result.RowsAffected != 1 { return errors.New(errors.CodeConflict, "提现申请状态已变化") } if err := deductFrozenBalance(ctx, tx, wallet, attempt.Amount); err != nil { return err } transaction, err := recordWithdrawalDeductTransaction(ctx, tx, wallet, request, attempt) if err != nil { return err } attempt.ReleasedAt = &now before := map[string]any{"status": constants.WithdrawalStatusPending, "paid_at": nil, "frozen_balance": wallet.FrozenBalance + attempt.Amount} request.Status = constants.WithdrawalStatusApproved request.PaidAt = &now request.ProcessedAt = &now return h.audit.WriteDistributionWithdrawal(ctx, tx, AuditChange{ EventID: "commission-withdrawal:" + uintText(request.ID) + ":attempt:" + intText(attempt.AttemptNo) + ":approved", ActionCode: constants.AuditActionCommissionWithdrawalAttemptApproved, Summary: "企业微信通过佣金提现,已从冻结余额扣减并记录到账时间", CorrelationID: event.CorrelationID, Withdrawal: request, Attempt: attempt, Wallet: wallet, Transaction: transaction, BeforeData: before, AfterData: withdrawalAuditSnapshot(request, attempt, wallet), }) } // applyClosed 处理最终驳回、撤销与删除:仅一次释放本次尝试冻结并记录释放时间。 // 幂等守卫为「尝试已结算时间仍为空」的条件更新且影响行数为 1。 func (h *WithdrawalApprovalHandler) applyClosed( ctx context.Context, tx *gorm.DB, request *model.CommissionWithdrawalRequest, attempt *model.CommissionWithdrawalRequestAttempt, event approvalapp.TerminalDecisionEvent, ) error { if attempt.ReleasedAt != nil { return nil } wallet, err := lockCommissionWallet(ctx, tx, request.ShopID) if err != nil { return err } now := time.Now().UTC() released, err := markAttemptReleased(ctx, tx, attempt, now) if err != nil { return err } if !released { return nil } ok, err := releaseCommissionBalance(ctx, tx, wallet.ID, attempt.Amount) if err != nil { return err } if !ok { return errors.New(errors.CodeConflict, "提现冻结余额与尝试记录不一致,请人工核对") } reason := rejectionReason(event.Decision) result := tx.WithContext(ctx).Model(&model.CommissionWithdrawalRequest{}). Where("id = ? AND status = ?", request.ID, constants.WithdrawalStatusPending). Updates(map[string]any{ "status": constants.WithdrawalStatusRejected, "processed_at": now, "reject_reason": reason, "updater": 0, }) if result.Error != nil { return errors.Wrap(errors.CodeDatabaseError, result.Error, "标记提现申请已驳回失败") } if result.RowsAffected != 1 { return errors.New(errors.CodeConflict, "提现申请状态已变化") } frozenBefore := wallet.FrozenBalance + attempt.Amount wallet.FrozenBalance = frozenBefore - attempt.Amount transaction, err := recordWithdrawalReleaseTransaction(ctx, tx, wallet, request, attempt, frozenBefore) if err != nil { return err } attempt.ReleasedAt = &now before := map[string]any{"status": constants.WithdrawalStatusPending, "frozen_balance": frozenBefore} request.Status = constants.WithdrawalStatusRejected request.ProcessedAt = &now request.RejectReason = reason return h.audit.WriteDistributionWithdrawal(ctx, tx, AuditChange{ EventID: "commission-withdrawal:" + uintText(request.ID) + ":attempt:" + intText(attempt.AttemptNo) + ":closed", ActionCode: constants.AuditActionCommissionWithdrawalAttemptClosed, Summary: "企业微信未通过佣金提现,已释放本次尝试冻结余额", CorrelationID: event.CorrelationID, Withdrawal: request, Attempt: attempt, Wallet: wallet, Transaction: transaction, BeforeData: before, AfterData: withdrawalAuditSnapshot(request, attempt, wallet), }) } // applyRevoked 处理通过后撤销。 // 已通过:不回滚已到账金额、不重新冻结、不自动重提,只写正交异常标记与原因。 // 仍在待审核(渠道乱序投递):按驳回同等处理,释放本次尝试冻结并转驳回状态。 func (h *WithdrawalApprovalHandler) applyRevoked( ctx context.Context, tx *gorm.DB, request *model.CommissionWithdrawalRequest, attempt *model.CommissionWithdrawalRequestAttempt, event approvalapp.TerminalDecisionEvent, ) error { if request.Status == constants.WithdrawalStatusPending { return h.applyClosed(ctx, tx, request, attempt, event) } if request.Status != constants.WithdrawalStatusApproved { // 已驳回等终态不再改变事实。 return nil } if request.AnomalyFlag == constants.WithdrawalAnomalyFlagRevokedAfterApproved { return nil } now := time.Now().UTC() reason := "企业微信通过后撤销:" + rejectionReason(event.Decision) result := tx.WithContext(ctx).Model(&model.CommissionWithdrawalRequest{}). Where("id = ? AND status = ? AND anomaly_flag = ?", request.ID, constants.WithdrawalStatusApproved, constants.WithdrawalAnomalyFlagNone). Updates(map[string]any{ "anomaly_flag": constants.WithdrawalAnomalyFlagRevokedAfterApproved, "anomaly_reason": reason, "updater": 0, }) if result.Error != nil { return errors.Wrap(errors.CodeDatabaseError, result.Error, "写入提现异常标记失败") } if result.RowsAffected != 1 { return errors.New(errors.CodeConflict, "提现申请异常标记已变化") } before := map[string]any{ "status": request.Status, "anomaly_flag": constants.WithdrawalAnomalyFlagNone, "paid_at": request.PaidAt, "amount": attempt.Amount, } request.AnomalyFlag = constants.WithdrawalAnomalyFlagRevokedAfterApproved request.AnomalyReason = reason request.UpdatedAt = now return h.audit.WriteDistributionWithdrawal(ctx, tx, AuditChange{ EventID: "commission-withdrawal:" + uintText(request.ID) + ":attempt:" + intText(attempt.AttemptNo) + ":anomaly", ActionCode: constants.AuditActionCommissionWithdrawalAnomalyFlagged, Summary: "企业微信通过后撤销,已到账金额不回滚、不重新冻结,仅写入异常标记", CorrelationID: event.CorrelationID, Withdrawal: request, Attempt: attempt, BeforeData: before, AfterData: withdrawalAuditSnapshot(request, attempt, nil), }) } // markAttemptReleased 以未释放条件更新写入尝试释放时间,返回是否本次完成释放。 func markAttemptReleased( ctx context.Context, tx *gorm.DB, attempt *model.CommissionWithdrawalRequestAttempt, now time.Time, ) (bool, error) { result := tx.WithContext(ctx).Model(&model.CommissionWithdrawalRequestAttempt{}). Where("id = ? AND released_at IS NULL", attempt.ID). Update("released_at", now) if result.Error != nil { return false, errors.Wrap(errors.CodeDatabaseError, result.Error, "写入提现尝试释放时间失败") } return result.RowsAffected == 1, nil } // deductFrozenBalance 以冻结余额充足条件更新同时扣减余额与冻结余额。 func deductFrozenBalance(ctx context.Context, tx *gorm.DB, wallet *model.AgentWallet, amount int64) error { result := tx.WithContext(ctx).Model(&model.AgentWallet{}). Where("id = ? AND wallet_type = ? AND frozen_balance >= ?", wallet.ID, constants.AgentWalletTypeCommission, amount). Updates(map[string]any{ "balance": gorm.Expr("balance - ?", amount), "frozen_balance": gorm.Expr("frozen_balance - ?", amount), "updated_at": time.Now(), }) if result.Error != nil { return errors.Wrap(errors.CodeDatabaseError, result.Error, "从冻结余额扣减提现金额失败") } if result.RowsAffected != 1 { return errors.New(errors.CodeConflict, "冻结余额不足或已被并发处理") } wallet.Balance -= amount wallet.FrozenBalance -= amount return nil } // recordWithdrawalDeductTransaction 写入通过时的钱包流水,余额与冻结余额同时减少。 func recordWithdrawalDeductTransaction( ctx context.Context, tx *gorm.DB, wallet *model.AgentWallet, request *model.CommissionWithdrawalRequest, attempt *model.CommissionWithdrawalRequestAttempt, ) (*model.AgentWalletTransaction, error) { remark := "企业微信终审通过,提现到账,单号:" + request.WithdrawalNo refType := constants.ReferenceTypeWithdrawal refID := request.ID transaction := &model.AgentWalletTransaction{ AgentWalletID: wallet.ID, ShopID: request.ShopID, UserID: request.ApplicantID, TransactionType: constants.AgentTransactionTypeWithdrawal, Amount: -attempt.Amount, BalanceBefore: wallet.Balance + attempt.Amount, BalanceAfter: wallet.Balance, Status: constants.TransactionStatusSuccess, ReferenceType: &refType, ReferenceID: &refID, Remark: &remark, Creator: request.ApplicantID, ShopIDTag: request.ShopID, } if err := tx.WithContext(ctx).Create(transaction).Error; err != nil { return nil, errors.Wrap(errors.CodeDatabaseError, err, "创建提现到账钱包流水失败") } return transaction, nil } // recordWithdrawalReleaseTransaction 写入驳回时的钱包流水,仅冻结余额减少。 func recordWithdrawalReleaseTransaction( ctx context.Context, tx *gorm.DB, wallet *model.AgentWallet, request *model.CommissionWithdrawalRequest, attempt *model.CommissionWithdrawalRequestAttempt, frozenBefore int64, ) (*model.AgentWalletTransaction, error) { remark := "企业微信未通过,释放提现冻结,单号:" + request.WithdrawalNo refType := constants.ReferenceTypeWithdrawal refID := request.ID transaction := &model.AgentWalletTransaction{ AgentWalletID: wallet.ID, ShopID: request.ShopID, UserID: request.ApplicantID, TransactionType: constants.AgentTransactionTypeRefund, Amount: attempt.Amount, BalanceBefore: wallet.Balance, BalanceAfter: wallet.Balance, Status: constants.TransactionStatusSuccess, ReferenceType: &refType, ReferenceID: &refID, Remark: &remark, Creator: request.ApplicantID, ShopIDTag: request.ShopID, } if err := tx.WithContext(ctx).Create(transaction).Error; err != nil { return nil, errors.Wrap(errors.CodeDatabaseError, err, "创建提现释放钱包流水失败") } _ = frozenBefore return transaction, nil }