judgment

type DeliberatorInterface interface {
	Deliberate(tally *PollTally) (result *PollResult, err error)
}

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

type PollResult struct {
	Proposals       ProposalsResults `json:"proposals"`       // matches the order of the input proposals' tallies
	ProposalsSorted ProposalsResults `json:"proposalsSorted"` // same Results, but sorted by Rank this time
}

type PollTally struct {
	AmountOfJudges uint64           `json:"amountOfJudges"` // Helps balancing tallies using default judgments.
	Proposals      []*ProposalTally `json:"proposals"`      // Tallies of each proposal.  Its order is preserved in the result.
}

type ProposalAnalysis struct {
	TotalSize              uint64 `json:"totalSize"`         // total amount of judges|judgments across all grades
	MedianGrade            uint8  `json:"medianGrade"`       // 0 == "worst" grade, goes up to the amount of grades - 1
	MedianGroupSize        uint64 `json:"medianGroupSize"`   // in judges|judgments
	SecondMedianGrade      uint8  `json:"secondMedianGrade"` // used in Majority Judgment deliberation
	SecondGroupSize        uint64 `json:"secondGroupSize"`   // either adhesion or contestation, whichever is bigger
	SecondGroupSign        int    `json:"secondGroupSign"`   // -1 for contestation group, +1 for adhesion group
	AdhesionGroupGrade     uint8  `json:"adhesionGroupGrade"`
	AdhesionGroupSize      uint64 `json:"adhesionGroupSize"`
	ContestationGroupGrade uint8  `json:"contestationGroupGrade"`
	ContestationGroupSize  uint64 `json:"contestationGroupSize"`
}

type ProposalResult struct {
	Index    int               `json:"index"` // Index of the proposal in the input proposals' tallies.  Useful with ProposalSorted.
	Rank     int               `json:"rank"`  // Rank starts at 1 (best) and goes upwards.  Equal Proposals share the same rank.
	Score    string            `json:"score"` // Higher Score lexicographically → better Rank.
	Analysis *ProposalAnalysis `json:"analysis"`
	Tally    *ProposalTally    `json:"tally"` // The tally of grades that generated this result.
}

type ProposalTally struct {
	Tally []uint64 `json:"tally"` // Amount of judgments received for each grade, from "worst" grade to "best" grade.
}

type ProposalsResults []*ProposalResult