vote

type Context struct {
	ID   string
	Type ObjectType
	// The percentage of OpinionGivers who liked this item on the last query.
	ProportionLiked float64
	// The number of voting rounds performed.
	Rounds int
	// Append-only list of opinions formed after each round.
	// the first opinion is the initial opinion when this vote context was created.
	Opinions []opinion.Opinion
	// Weights used for voting
	Weights VotingWeights
	// ConflictCreationTime points to time when the context has been created
	ConflictCreationTime time.Time
}

type DRNGRoundBasedVoter interface {
	Voter
	// Round starts a new round.
	Round(rand float64, delayedRoundStart ...time.Duration) error
}

type Events struct {
	// Fired when an Opinion has been finalized.
	Finalized *events.Event
	// Fired when an Opinion couldn't be finalized.
	Failed *events.Event
	// Fired when a DRNGRoundBasedVoter has executed a round.
	RoundExecuted *events.Event
	// Fired when internal errors occur.
	Error *events.Event
}

type ObjectType uint8

type OpinionEvent struct {
	// ID is the of the conflict.
	ID string
	// Opinion is an opinion about a conflict.
	Opinion opinion.Opinion
	// Ctx contains all relevant infos regarding the conflict.
	Ctx Context
}

type RoundStats struct {
	// The time it took to complete a round.
	Duration time.Duration `json:"duration"`
	// The rand number used during the round.
	RandUsed float64 `json:"rand_used"`
	// The vote contexts on which opinions were formed and queried.
	// This list does not include the vote contexts which were finalized/aborted
	// during the execution of the round.
	// Create a copy of this map if you need to modify any of its elements.
	ActiveVoteContexts map[string]*Context `json:"active_vote_contexts"`
	// The opinions which were queried during the round per opinion giver.
	QueriedOpinions []opinion.QueriedOpinions `json:"queried_opinions"`
}

type Voter interface {
	// Vote submits the given ID for voting with its initial Opinion.
	Vote(id string, objectType ObjectType, initOpn opinion.Opinion) error
	// IntermediateOpinion gets intermediate Opinion about the given ID.
	IntermediateOpinion(id string) (opinion.Opinion, error)
	// Events returns the Events instance of the given Voter.
	Events() Events
}

type VotingWeights struct {
	// Total base mana of opinion givers from the last query
	TotalWeights float64
	// Own mana from the last query
	OwnWeight float64
}