package approval

import (
	"context"

	"gorm.io/gorm"
)

// AuditChange 描述通用审批链路一次实际状态变化。
type AuditChange struct {
	EventID            string
	ActionCode         string
	Summary            string
	InstanceID         uint
	BusinessType       string
	BusinessID         uint
	SubmitterAccountID uint
	SubmitterSnapshot  []byte
	Provider           string
	BeforeExternalRef  string
	AfterExternalRef   string
	CorrelationID      string
	ParentEventID      string
	BeforeStatus       *int
	AfterStatus        *int
	ActorKind          string
	ActorID            string
	ActorName          string
	Source             string
	Result             string
	ErrorSummary       string
	Decision           string
	IntegrationIDs     []string
	OutboxEventID      string
}

// AuditWriter 在审批事实事务中追加统一 Audit Event。
type AuditWriter interface {
	WriteApproval(ctx context.Context, tx *gorm.DB, change AuditChange) error
}