junhong_cmp_fiber/internal/application/approval/sync_decision.go

package approval

import (
	"context"
	"strconv"
	"time"

	"gorm.io/gorm"

	approvaldomain "github.com/break/junhong_cmp_fiber/internal/domain/approval"
	"github.com/break/junhong_cmp_fiber/pkg/constants"
	"github.com/break/junhong_cmp_fiber/pkg/errors"
)

// RepositoryProvider 为当前 GORM 事务提供纯领域 Repository。
type RepositoryProvider interface {
	ForDB(db *gorm.DB) approvaldomain.Repository
}

// TerminalDecisionEvent 是业务消费者接收的渠道无关标准决策事件。
type TerminalDecisionEvent struct {
	EventID            string    `json:"event_id"`
	InstanceID         uint      `json:"instance_id"`
	BusinessType       string    `json:"business_type"`
	BusinessID         uint      `json:"business_id"`
	SubmitterAccountID uint      `json:"submitter_account_id"`
	Decision           string    `json:"decision"`
	Source             string    `json:"source"`
	CorrelationID      string    `json:"correlation_id"`
	OccurredAt         time.Time `json:"occurred_at"`
}

// TerminalEventWriter 在审批状态事务中追加标准决策 Outbox。
type TerminalEventWriter interface {
	Append(ctx context.Context, tx *gorm.DB, event TerminalDecisionEvent) error
}

// DecisionDeliveryWriter 在审批状态事务中创建业务消费租约事实。
type DecisionDeliveryWriter interface {
	Create(ctx context.Context, tx *gorm.DB, event TerminalDecisionEvent) error
}

// SyncDecisionCommand 是回调、兜底轮询和受控人工同步共用的标准决策命令。
type SyncDecisionCommand struct {
	InstanceID       uint
	Decision         string
	DecisionSnapshot []byte
	Source           string
}

// SyncDecisionResult 返回本次是否首次记录该标准终态。
type SyncDecisionResult struct {
	Status        int
	FirstTerminal bool
}

// SyncDecisionService 统一处理各审批渠道回传的标准决策。
type SyncDecisionService struct {
	db             *gorm.DB
	repositories   RepositoryProvider
	eventWriter    TerminalEventWriter
	deliveryWriter DecisionDeliveryWriter
	now            func() time.Time
}

// NewSyncDecisionService 创建标准决策同步用例。
func NewSyncDecisionService(
	db *gorm.DB,
	repositories RepositoryProvider,
	eventWriter TerminalEventWriter,
	deliveryWriter DecisionDeliveryWriter,
	now func() time.Time,
) *SyncDecisionService {
	if now == nil {
		now = time.Now
	}
	return &SyncDecisionService{
		db: db, repositories: repositories, eventWriter: eventWriter, deliveryWriter: deliveryWriter, now: now,
	}
}

// Execute 将回调或轮询取得的权威渠道状态原子转换为通用审批终态和可靠业务事件。
func (s *SyncDecisionService) Execute(ctx context.Context, command SyncDecisionCommand) (*SyncDecisionResult, error) {
	if s == nil || s.db == nil || s.repositories == nil || s.eventWriter == nil || s.deliveryWriter == nil {
		return nil, errors.New(errors.CodeInternalError, "通用审批决策同步用例未完整配置")
	}
	if command.InstanceID == 0 || !isSupportedSyncSource(command.Source) {
		return nil, errors.New(errors.CodeInvalidParam)
	}
	result := &SyncDecisionResult{}
	err := s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
		repository := s.repositories.ForDB(tx)
		if repository == nil {
			return errors.New(errors.CodeInternalError, "通用审批 Repository 未配置")
		}
		instance, err := repository.GetForUpdate(ctx, command.InstanceID)
		if err != nil {
			return err
		}
		expectedStatus, expectedVersion := instance.Status, instance.Version
		changed, err := instance.ApplyDecision(command.Decision, command.DecisionSnapshot, s.now().UTC())
		if err != nil {
			return err
		}
		result.Status = instance.Status
		if !changed {
			return nil
		}
		saved, err := repository.SaveDecision(ctx, instance, expectedStatus, expectedVersion)
		if err != nil {
			return err
		}
		if !saved {
			return errors.New(errors.CodeConflict, "审批状态已被其他同步任务更新")
		}
		event := TerminalDecisionEvent{
			EventID:    terminalDecisionEventID(instance.ID, command.Decision),
			InstanceID: instance.ID, BusinessType: instance.BusinessType, BusinessID: instance.BusinessID,
			SubmitterAccountID: instance.SubmitterAccountID, Decision: command.Decision, Source: command.Source,
			CorrelationID: instance.CorrelationID, OccurredAt: instance.StatusChangedAt,
		}
		if err := s.deliveryWriter.Create(ctx, tx, event); err != nil {
			return err
		}
		if err := s.eventWriter.Append(ctx, tx, event); err != nil {
			return err
		}
		result.FirstTerminal = true
		return nil
	})
	if err != nil {
		return nil, err
	}
	return result, nil
}

func terminalDecisionEventID(instanceID uint, decision string) string {
	return "approval:" + strconv.FormatUint(uint64(instanceID), 10) + ":" + decision
}

func isSupportedSyncSource(source string) bool {
	return source == constants.ApprovalSyncSourceCallback ||
		source == constants.ApprovalSyncSourcePolling ||
		source == constants.ApprovalSyncSourceManual
}