# Key modules in the governance system · Chromia Docs (concept)

> This topic outlines the core components of the Governance Tool, detailing how citizens interact with proposals, voting, and the veto mechanism.

Source: https://docs.chromia.com/ecosystem/governance/getting-started/governance-structure/key-modules/

# Key modules in the governance system

On this page

* [Citizens](#citizens)
* [Proposals](#proposals)
* [Votes](#votes)
* [Veto mechanism](#veto-mechanism)

This topic outlines the core components of the Governance Tool, detailing how citizens interact with proposals, voting,
and the veto mechanism.

## Citizens

Citizens play an essential role in governance, engaging in key processes such as registration and role management.

* **Registration**: Citizens register using an external authentication mechanism, providing an authentication descriptor
  and a signature for account creation.
* **Role management**: Administrators assign and manage roles, defining responsibilities within the governance system.

## Proposals

Proposals form the backbone of the governance process and are structured into distinct phases.

* **Proposal creation**  
  Citizens draft and submit proposals to initiate governance decisions.

  + **Draft submission**: Eligible citizens create proposals by providing details such as title, category, and duration.
  + **Validation and authorization**: Only registered citizens can submit draft proposals.
  + **Cooldown enforcement**: A cooldown period may apply before a citizen can submit another proposal.
* **Draft verification**  
  Proposals undergo review before advancing.

  + **Councilor review**: A councilor evaluates each draft to ensure its readiness.
  + **Status update**: The system updates the draft’s status after review.
* **Voting**  
  Verified proposals move to the voting phase, allowing citizens to cast their votes.
* **Finalization**  
  The system processes and archives the final decision.

  + **Completion**: The system marks the proposal as finalized.
  + **Outcome storage**: Voting results and decisions are archived for future reference.

## Votes

The voting mechanism empowers citizens to shape governance outcomes.

* **Casting votes**: Citizens select from available options on a proposal.
* **Finalizing votes**: The system automatically concludes the voting phase once the deadline passes.

## Veto mechanism

The veto mechanism safeguards against potentially harmful proposals.

* **Veto period**: There is a specific timeframe, called the veto period, during which a veto can be initiated after
  voting has concluded. For example, if the veto period is set to 12 hours, a permissioned group of citizens can veto
  within 12 hours after voting has finished.
* **Initiating a veto**: Citizens can propose a veto against specific proposals or options.
* **Voting on a veto**: Citizens decide whether to approve or reject the veto.
* **Finalizing a veto**: If conditions are met, the system enforces the veto, preventing the proposal from proceeding.

[View this page on docs.chromia.com](https://docs.chromia.com/ecosystem/governance/getting-started/governance-structure/key-modules/)Content mirrored from the live docs
