hfb_sys/backend/internal/modules/distribution/lifecycle.go

package distribution

import (
	"errors"
	"sync"
	"time"

	"hfb_sys/backend/internal/model"

	"gorm.io/gorm"
)

// distributionTablesPresent 探测分销财务表是否存在，仅首次访问查询 information_schema，
// 兼容尚未执行分销迁移的旧环境，避免每次支付/退款事务都做系统表查询。
var (
	distributionTablePresent   bool
	distributionTableCheckOnce sync.Once
)

func distributionTablesPresent(tx *gorm.DB) bool {
	distributionTableCheckOnce.Do(func() {
		distributionTablePresent = tx.Migrator().HasTable(&model.DistributionOrderFinancial{})
	})
	return distributionTablePresent
}

// ResolveOrderSourceTx 校验站点、账号展示关系和生效规则，供正常订单创建事务写入快照引用。
// 第一期仅启用 two_party_distributor_receive 模式，其他模式规则不会命中（见设计文档实施顺序）。
func ResolveOrderSourceTx(tx *gorm.DB, siteCode string, listingID, accountID uint64, at time.Time) (*model.DistributionSite, *model.DistributionRuleVersion, error) {
	if siteCode == "" {
		return nil, nil, nil
	}
	var site model.DistributionSite
	if err := tx.Where("site_code = ? AND status = 'active' AND display_account_enabled = ?", siteCode, true).First(&site).Error; err != nil {
		return nil, nil, ErrSiteNotFound
	}
	var relation model.DistributionSiteAccount
	if err := tx.Where("site_id = ? AND listing_id = ? AND account_id = ? AND display_status = 'enabled'", site.ID, listingID, accountID).First(&relation).Error; err != nil {
		return nil, nil, ErrAccountDisplayNotFound
	}
	var rule model.DistributionRuleVersion
	query := tx.Where("mode = ? AND status = 'active' AND effective_from <= ? AND (effective_to IS NULL OR effective_to > ?)", ModeTwoPartyDistributorReceive, at, at).
		Where("site_id = ? OR site_id IS NULL", site.ID).
		Order("CASE WHEN site_id IS NULL THEN 1 ELSE 0 END, effective_from DESC, id DESC")
	if err := query.First(&rule).Error; err != nil {
		return nil, nil, ErrRuleNotFound
	}
	return &site, &rule, nil
}

// calculateForRule 按规则快照计算手续费、服务费和分成基数。
func calculateForRule(rule model.DistributionRuleVersion, input SettlementInput) (SettlementResult, error) {
	return CalculateSettlement(Rule{
		Mode: rule.Mode, ServiceFeeValue: rule.ServiceFeeValue, ServiceFeeUnit: rule.ServiceFeeUnit,
		PaymentFeeBPS: rule.PaymentFeeBPS, TaxEnabled: rule.TaxEnabled, TaxRateBPS: rule.TaxRateBPS,
	}, input)
}

// SnapshotPaidOrderTx 在支付确认事务内幂等写入财务和参与方快照。
// 参与方金额按规则比例对分成基数拆分，剩余（含尾差）记入 RoundingAdjustmentCent 归平台。
func SnapshotPaidOrderTx(tx *gorm.DB, orderID uint64, grossPaidCent int64) error {
	if !distributionTablesPresent(tx) {
		return nil
	}
	var order model.RentalOrder
	if err := tx.First(&order, orderID).Error; err != nil {
		return err
	}
	if order.DistributionSiteID == nil || order.DistributionRuleVersionID == nil {
		return nil
	}
	var rule model.DistributionRuleVersion
	if err := tx.First(&rule, *order.DistributionRuleVersionID).Error; err != nil {
		return err
	}
	markup := order.PlatformFeeCent
	result, err := calculateForRule(rule, SettlementInput{GrossPaidAmountCent: grossPaidCent, MarkupAmountCent: markup})
	if err != nil {
		return err
	}
	splits := SplitSettlement(Rule{Mode: rule.Mode}, result.SplitBaseAmountCent, markup)
	financial := model.DistributionOrderFinancial{OrderID: order.ID, SiteID: *order.DistributionSiteID, RuleVersionID: rule.ID, GrossPaidAmountCent: grossPaidCent, NetPaidAmountCent: result.NetPaidAmountCent, PaymentFeeBPS: rule.PaymentFeeBPS, PaymentFeeCent: result.PaymentFeeCent, ServiceFeeValue: rule.ServiceFeeValue, ServiceFeeUnit: rule.ServiceFeeUnit, ServiceFeeCent: result.ServiceFeeCent, MarkupAmountCent: markup, TaxEnabled: rule.TaxEnabled, TaxRateBPS: rule.TaxRateBPS, TaxAmountCent: result.TaxAmountCent, SplitBaseAmountCent: result.SplitBaseAmountCent, RoundingAdjustmentCent: SplitRemainderCent(result.SplitBaseAmountCent, splits), SettlementStatus: "pending"}
	if err := tx.Where("order_id = ?", order.ID).Assign(financial).FirstOrCreate(&financial).Error; err != nil {
		return err
	}
	var count int64
	if err := tx.Model(&model.DistributionOrderParty{}).Where("order_id = ?", order.ID).Count(&count).Error; err != nil {
		return err
	}
	if count > 0 {
		return nil
	}
	parties := make([]model.DistributionOrderParty, 0, len(splits))
	for _, split := range splits {
		partyType := "site"
		if split.PartyRole == "platform_sell" || split.PartyRole == "platform_receive" {
			partyType = "platform"
		}
		partyID := *order.DistributionSiteID
		if partyType == "platform" {
			partyID = 0
		}
		parties = append(parties, model.DistributionOrderParty{OrderID: order.ID, SiteID: *order.DistributionSiteID, PartyRole: split.PartyRole, PartyType: partyType, PartyID: partyID, Ratio: split.Ratio, IncomeAmountCent: split.AmountCent, ProfitAmountCent: split.AmountCent})
	}
	if len(parties) == 0 {
		return nil
	}
	return tx.Create(&parties).Error
}

// ApplyRefundTx 按累计成功退款金额重算手续费、分成基数和各方分成，不覆盖订单创建时的规则版本。
func ApplyRefundTx(tx *gorm.DB, orderID uint64, refundAmountCent int64) error {
	if !distributionTablesPresent(tx) {
		return nil
	}
	var financial model.DistributionOrderFinancial
	if err := tx.Where("order_id = ?", orderID).First(&financial).Error; err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			return nil
		}
		return err
	}
	if refundAmountCent < 0 || refundAmountCent > financial.GrossPaidAmountCent {
		return ErrInvalidAmount
	}
	var rule model.DistributionRuleVersion
	if err := tx.First(&rule, financial.RuleVersionID).Error; err != nil {
		return err
	}
	result, err := calculateForRule(rule, SettlementInput{GrossPaidAmountCent: financial.GrossPaidAmountCent, RefundAmountCent: refundAmountCent, MarkupAmountCent: financial.MarkupAmountCent})
	if err != nil {
		return err
	}
	splits := SplitSettlement(Rule{Mode: rule.Mode}, result.SplitBaseAmountCent, financial.MarkupAmountCent)
	if err := tx.Model(&financial).Updates(map[string]any{"refund_amount_cent": refundAmountCent, "net_paid_amount_cent": result.NetPaidAmountCent, "payment_fee_cent": result.PaymentFeeCent, "service_fee_cent": result.ServiceFeeCent, "split_base_amount_cent": result.SplitBaseAmountCent, "rounding_adjustment_cent": SplitRemainderCent(result.SplitBaseAmountCent, splits), "settlement_status": "pending"}).Error; err != nil {
		return err
	}
	for _, split := range splits {
		if err := tx.Model(&model.DistributionOrderParty{}).
			Where("order_id = ? AND party_role = ?", orderID, split.PartyRole).
			Updates(map[string]any{"income_amount_cent": split.AmountCent, "profit_amount_cent": split.AmountCent}).Error; err != nil {
			return err
		}
	}
	return nil
}