...

specs/models_older/governance/proposal.v

@@ -0,0 +1,62 @@
+module governance
+
+import base
+import freeflowuniverse.herolib.data.ourtime
+// ProposalStatus enum is used from governance_enums.v in the same module
+
+// Proposal represents a governance proposal that can be voted upon.
+// It now incorporates the voting mechanism from biz/vote.v.
+pub struct Proposal {
+	base.Base // Provides Proposal's own ID, created_at, updated_at
+pub mut:
+	// Fields from original Proposal struct
+	creator_id       string // User ID of the proposal creator
+	title            string // Title of the proposal
+	description      string // Detailed description of the proposal
+	status           ProposalStatus // Status of the proposal lifecycle (draft, active, approved etc.)
+
+	// Fields from biz/vote.v's Vote struct (representing the voting event aspects of the proposal)
+	vote_start_date    ourtime.OurTime // When voting on this proposal starts
+	vote_end_date      ourtime.OurTime // When voting on this proposal ends
+	vote_status        VoteEventStatus // Status of the voting event (open, closed, cancelled)
+	options            []VoteOption    // The choices users can vote for
+	ballots            []Ballot        // The cast votes by users
+	private_group      []u32           // Optional: list of user IDs who are eligible to vote
+}
+
+// ProposalStatus defines the lifecycle status of a governance proposal itself
+pub enum ProposalStatus {
+	draft    // Proposal is being prepared
+	active   // Proposal is active (might be pre-voting, during voting, or post-voting but not yet finalized)
+	approved // Proposal has been formally approved
+	rejected // Proposal has been formally rejected
+	cancelled// Proposal was cancelled
+}
+
+// -- Structures from biz/vote.v, adapted for integration --
+
+// VoteEventStatus represents the status of the voting process for a proposal
+// Renamed from VoteStatus in biz/vote.v to avoid confusion with ProposalStatus
+pub enum VoteEventStatus {
+	open      // Voting is currently open
+	closed    // Voting has finished
+	cancelled // The voting event was cancelled
+}
+
+// VoteOption represents a specific choice that can be voted on within a proposal's voting event
+pub struct VoteOption {
+pub mut:
+	id        u8     // Simple identifier for this option within this proposal's vote (e.g., 1, 2, 3)
+	text      string // The descriptive text of the option (e.g., "Option A: Approve budget")
+	count     int    // How many votes this option has received
+	min_valid int    // Optional: minimum votes needed for this option to be considered valid
+}
+
+// Ballot represents an individual vote cast by a user for a specific proposal
+pub struct Ballot {
+	base.Base // Provides Ballot's own ID, created_at, updated_at
+pub mut:
+	user_id        u32    // The ID of the user who cast this ballot
+	vote_option_id u8     // The 'id' of the VoteOption chosen by the user
+	shares_count   int    // Number of shares/tokens/voting power used for this ballot
+}