referral

type Recorder struct {
	// contains filtered or unexported fields
}

type Referral struct {
	ReferralID        string     `json:"referral_id"`
	ReferrerAccountID string     `json:"referrer_account_id"`
	ReferredEmail     string     `json:"referred_email"`
	ReferredAccountID string     `json:"referred_account_id,omitempty"`
	Status            string     `json:"status"` // pending | completed
	CreatedAt         time.Time  `json:"created_at"`
	CompletedAt       *time.Time `json:"completed_at,omitempty"`
}

type Repository interface {
	// Create inserts a new pending referral. Duplicate (referrer, email) pairs
	// are silently ignored (idempotent).
	Create(ctx context.Context, r *Referral) error
	// Complete marks referrals for the given email as completed, linking them
	// to the referred account. Returns count of rows updated.
	Complete(ctx context.Context, referredEmail, referredAccountID string) (int, error)
	// ListByReferrer returns all referrals created by a given account.
	ListByReferrer(ctx context.Context, referrerAccountID string) ([]*Referral, error)
}