Traditional Organizations          Community Pools (KhipuVault)
─────────────────────              ────────────────────────────
✗ Trust board members              ✓ Trust code (transparent)
✗ Opaque decision-making           ✓ All votes on-chain
✗ Can change rules arbitrarily     ✓ Rules enforced by contract
✗ Manual vote counting             ✓ Automatic execution

┌─────────────────────────────────────────┐
│         Governance Pyramid              │
├─────────────────────────────────────────┤
│                                         │
│  🔴 Critical Decisions                  │
│  ├─ Remove members                      │
│  ├─ Change voting rules                 │
│  ├─ Upgrade smart contract              │
│  └─ Threshold: 70-80% approval          │
│                                         │
│  🟡 Major Decisions                     │
│  ├─ Change pool parameters              │
│  ├─ Large fund allocations              │
│  ├─ Add new members (closed pools)      │
│  └─ Threshold: 60% approval             │
│                                         │
│  🟢 Minor Decisions                     │
│  ├─ Small treasury expenses             │
│  ├─ Update pool description             │
│  ├─ Schedule events                     │
│  └─ Threshold: 51% approval             │
│                                         │
│  ⚪ Automatic (No Vote)                 │
│  ├─ Yield distribution                  │
│  ├─ Individual withdrawals (within limit)│
│  ├─ Member deposits                     │
│  └─ Platform fee deductions             │
│                                         │
└─────────────────────────────────────────┘

// Each member gets exactly 1 vote
mapping(address => uint256) public votes;

function vote(uint256 proposalId, bool support) external {
    require(isMember(msg.sender), "Not a member");
    votes[proposalId][msg.sender] = support ? 1 : 0;
}

Proposal: "Distribute 1,000 MUSD to member emergency fund"

Member A (Balance: 5,000 MUSD) → Vote: YES (weight: 1)
Member B (Balance: 100 MUSD)   → Vote: YES (weight: 1)
Member C (Balance: 2,000 MUSD) → Vote: NO (weight: 1)

Result: 2 YES, 1 NO → Passes (67% approval)

// Vote weight proportional to deposit
function vote(uint256 proposalId, bool support) external {
    uint256 weight = memberBalance[msg.sender];
    votes[proposalId][msg.sender] = support ? weight : 0;
}

Proposal: "Invest 50% of pool in higher-risk strategy"

Member A (5,000 MUSD)  → Vote: YES (weight: 5,000)
Member B (100 MUSD)    → Vote: NO (weight: 100)
Member C (2,000 MUSD)  → Vote: NO (weight: 2,000)
Total Pool: 10,000 MUSD

YES: 5,000 MUSD (50%)
NO: 2,100 MUSD (21%)
Abstain: 2,900 MUSD (29%)

Result: Passes (50% > 49%)

Day 0, 14:00
├─ Member creates proposal
├─ Smart contract validates
├─ Proposal goes live
├─ Members notified
└─ Voting begins immediately

Days 0-3 (3-day voting period)
├─ Members review proposal
├─ Discussions happen
├─ Votes are cast
├─ Real-time results visible
└─ Reminder sent 24h before end

Day 3, 14:00
├─ Voting period ends
├─ No more votes accepted
├─ Final tally calculated
├─ Quorum checked
└─ Pass/fail determined

Proposal Passes IF:
✓ Quorum Met (enough participation)
    AND
✓ Approval Met (enough YES votes)

Example (Democratic, 51% quorum, 60% approval):
├─ Total Members: 45
├─ Votes Cast: 30 (67% participation) ✓ Quorum met (need 51%)
├─ YES Votes: 20 (67% of votes) ✓ Approval met (need 60%)
└─ Result: ✅ PASSED

Passed Proposals:
├─ Queued for execution
├─ Timelock delay (if configured): 24-48 hours
├─ Executed automatically or manually
├─ On-chain event emitted
└─ Members notified

Failed Proposals:
├─ Marked as rejected
├─ No action taken
├─ Can be re-proposed with changes
└─ Members notified

// Add Member - Executed Automatically
function executeAddMember(uint256 proposalId) internal {
    Proposal memory proposal = proposals[proposalId];
    address newMember = abi.decode(proposal.data, (address));

    members.push(newMember);
    memberStatus[newMember] = MemberStatus.ACTIVE;

    emit MemberAdded(newMember, block.timestamp);
}

// Distribute Yields - Executed Automatically
function executeDistributeYields(uint256 proposalId) internal {
    uint256 totalYields = accumulatedYields;

    for (uint i = 0; i < members.length; i++) {
        address member = members[i];
        uint256 share = calculateMemberShare(member, totalYields);
        MUSD.transfer(member, share);
    }

    emit YieldsDistributed(totalYields, block.timestamp);
}

After execution:
├─ Results published
├─ Impact measured
├─ Feedback collected
├─ Lessons learned
└─ Documentation updated

Low Quorum (30-40%):
├─ Pros: Easier to pass proposals
├─ Cons: Small group can decide
└─ Best for: Large pools, routine decisions

Medium Quorum (51%):
├─ Pros: Balanced participation
├─ Cons: May be hard to reach
└─ Best for: Most pools, most decisions

High Quorum (60-75%):
├─ Pros: Strong mandate
├─ Cons: Very hard to reach
└─ Best for: Critical decisions only

Pool: 100 members
Quorum: 51%

Scenario A: 60 members vote (60% participation)
├─ Quorum: ✓ Met (60% > 51%)
├─ Proposal: Can pass if approval threshold met

Scenario B: 40 members vote (40% participation)
├─ Quorum: ✗ Not Met (40% < 51%)
├─ Proposal: Fails automatically, regardless of YES/NO ratio

Simple Majority (51%):
├─ 51% YES votes needed
├─ Standard for routine decisions
└─ Example: Small treasury expenses

Supermajority (60-67%):
├─ 60-67% YES votes needed
├─ For important decisions
└─ Example: Add/remove members, parameter changes

Supermajority (75-80%):
├─ 75-80% YES votes needed
├─ For critical decisions
└─ Example: Smart contract upgrades, dissolve pool

Votes Cast: 50
Approval Threshold: 60%

Scenario A:
├─ YES: 32 (64%)
├─ NO: 18 (36%)
└─ Result: ✓ Passes (64% > 60%)

Scenario B:
├─ YES: 28 (56%)
├─ NO: 22 (44%)
└─ Result: ✗ Fails (56% < 60%)

Pool Configuration:
├─ Total Members: 45
├─ Quorum: 51%
└─ Approval: 60%

Proposal Results:
├─ Votes Cast: 30 (67% participation)
├─ YES: 20
├─ NO: 10

Check 1: Quorum
├─ 30/45 = 67% participation
├─ Need: 51%
└─ ✓ Met

Check 2: Approval
├─ 20/30 = 67% YES votes
├─ Need: 60%
└─ ✓ Met

Final Result: ✅ PASSED

✅ Good Governance Pool:
├─ 60-80% average voter turnout
├─ 5-10 proposals per month
├─ 70-80% proposal pass rate
├─ Active discussions (comments)
├─ Respectful disagreements
├─ Quick quorum achievement
└─ Diverse proposal creators

⚠️ Warning Signs:
├─ less than 40% average turnout
├─ Same people always proposing
├─ Most proposals fail
├─ No discussion/comments
├─ Voting deadline extensions needed
└─ Member complaints about governance

Voting Rewards (Quarterly):

Tier 1 - Perfect Voter (100% participation)
└─ Reward: 20 MUSD bonus from treasury

Tier 2 - Active Voter (80-99%)
└─ Reward: 10 MUSD bonus

Tier 3 - Regular Voter (60-79%)
└─ Reward: 5 MUSD bonus

Cost: ~450 MUSD/quarter for 45 members
Benefit: 90%+ participation, better decisions

// Allow trusted member to vote on your behalf
delegate(delegateAddress: "0x742d...");

// Useful when:
// - You're traveling/busy
// - You trust another member's judgment
// - You want to consolidate voting power
// - You're inactive but want to participate

// You can reclaim anytime
undelegate();

Template: "Monthly Yield Distribution"
├─ Auto-fills common parameters
├─ Standard approval: 51%
├─ Standard quorum: 40%
├─ Voting period: 3 days
└─ Saves time for recurring proposals

Template: "Emergency Member Removal"
├─ Higher approval: 70%
├─ Higher quorum: 60%
├─ Longer period: 5 days
├─ Grace period: 7 days
└─ Ensures fairness

📊 Governance Dashboard

Participation Trends
├─ Last 30 days: 72% avg turnout ↑ +5%
├─ Last 90 days: 67% avg turnout
├─ All-time: 64% avg turnout
└─ Trend: Improving ✅

Proposal Statistics
├─ Total Proposals: 47
├─ Passed: 32 (68%)
├─ Failed: 12 (26%)
├─ Expired: 3 (6%)
└─ Average time to quorum: 1.8 days

Top Voters (Last 30 Days)
1. Maria Lopez - 8/8 votes (100%)
2. Juan Rodriguez - 8/8 votes (100%)
3. Ana Garcia - 7/8 votes (88%)
...

Top Proposers
1. Admin - 12 proposals
2. Maria Lopez - 8 proposals
3. Juan Rodriguez - 5 proposals
...

Original Proposal: "Increase minimum to 500 MUSD"
├─ Supporters: Want serious, committed members
├─ Opponents: Too exclusive, hurts accessibility
└─ Split: 48% YES, 52% NO

Compromise Proposal: "Increase to 150 MUSD, grandfather existing"
├─ New members: 150 MUSD minimum
├─ Existing members: Keep current balances
└─ Result: 78% YES ✓ Passed