Governance Action Schema

Overview

The Governance Action Schema defines the structure for tracking all official governance actions by any of the governance houses, including meetings and decisions. It ensures that all actions are aligned with the community's goals and governance processes.

Schema Structure

Core Entities

{
  "governance_action": {
    "metadata": "GovernanceActionMetadata",
    "content": "GovernanceActionContent",
    "status": "GovernanceActionStatus",
    "relationships": "GovernanceActionRelationships",
    "outcome": "GovernanceDecisionOutcomes"
  }
}

Data Fields

1. GovernanceActionMetadata

Field	Type	Required	Description	Example
id	UUID	Yes	Unique governance action identifier	ga_2025_001
created_at	ISO 8601	Yes	Creation timestamp	2025-01-15T10:30:00Z
updated_at	ISO 8601	Yes	Last update timestamp	2025-01-15T14:45:00Z
version	String	Yes	Schema version	0.1
title	String	Yes	Governance action title	"Elders Council Meeting"
house	String	Yes	Governance house responsible for the action	elders_council

2. GovernanceActionContent

Field	Type	Required	Description	Example
description	Text	Yes	Detailed description	"Discussion on proposal PROP_2025_001..."
objectives	Array[String]	Yes	Objectives of the governance action	"Ensure cultural alignment"
expected_outcomes	Array[String]	Yes	Expected outcomes	"Approved proposal with clear governance path"
action_type	String	Yes	Type of action being taken	discussion
purpose	String	Yes	Purpose of the action	DP_2025_001_001
proposal	String	Yes	Proposal related to the action	PROP_2025_001
notes	String	Yes	Notes related to the action	GA_NOTES_2025_002_001

3. GovernanceActionStatus

Field	Type	Required	Description	Example
current_status	Enum	Yes	Current status	planned, in_progress, completed
status_history	Array[StatusChange]	Yes	Status change log	[{"status": "planned", "timestamp": "2025-01-15T10:30:00Z"}]

4. GovernanceActionRelationships

Field	Type	Required	Description	Example
related_decision_plans	Array[UUID]	No	Related decision plans	[]
governance_steward	UUID	Yes	Governance steward ID	steward_001

5. GovernanceDecisionOutcomes

Field	Type	Required	Description	Example
feedback	String	Yes	Feedback from the participants on the decision	[{ "id":"councillor_1", "response": "I want to emphasize the importance of cultural representation and accessibility"}]
veto_votes	Integer	Yes	Number of veto votes	1
no_veto_votes	Integer	Yes	Number of non-veto votes	5
total_vote_participants	Integer	Yes	Total number of participants in the vote	6
total_vote_tokens_for	Integer	Yes	Total number of tokens voted for the proposal	20
total_vote_tokens_against	Integer	Yes	Total number of tokens voted against the proposal	5
total_vote_power_for	Integer	Yes	Total voting power for the proposal	10
total_vote_power_against	Integer	Yes	Total voting power against the proposal	3
outcome	String	Yes	Final decision outcome	no_veto, veto, approved, rejected

Validation Rules

1. Data Integrity Rules

• Unique Identifiers: All governance action IDs must be globally unique
• Required Fields: All required fields must be present and non-null
• Data Types: All field values must match their defined types
• Timestamps: All timestamps must be valid ISO 8601 format

2. Business Logic Rules

• Status Transitions: Only valid status transitions are allowed
• Assignment Rules: Governance actions can only be assigned to open decision plans

Integration Points

1. Governance System Integration

The governance action schema integrates with the governance system to ensure seamless coordination between governance actions and decision-making processes:

• Governance Action Status Synchronization: When governance action statuses change, the system automatically updates associated decision plan statuses to maintain consistency across the governance workflow
• Action Tracking: All governance action-related activities are automatically recorded in the governance history, providing a complete audit trail of community decisions and their implementation

Conclusion

The Governance Action Schema provides a comprehensive foundation for managing governance actions within the DAO ecosystem. By integrating cultural values, governance processes, and technical requirements, this schema ensures:

• Cultural Alignment: Governance actions respect and advance community values
• Transparency: All governance action data is visible and auditable
• Scalability: Machine-readable data enables automation and growth
• Fairness: Clear rules and validation ensure equitable treatment
• Efficiency: Automated workflows reduce administrative overhead

The schema is designed to evolve with the community's needs while maintaining the core principles of decentralized governance and cultural preservation. Regular reviews and updates ensure it continues to serve the community effectively as the DAO grows and develops.