Struct Decision 

pub struct Decision {

    pub id: Uuid,
    pub number: u64,
    pub title: String,
    pub status: DecisionStatus,
    pub category: DecisionCategory,
    pub domain: Option<String>,
    pub domain_id: Option<Uuid>,
    pub workspace_id: Option<Uuid>,
    pub date: DateTime<Utc>,
    pub decided_at: Option<DateTime<Utc>>,
    pub authors: Vec<String>,
    pub deciders: Vec<String>,
    pub consulted: Vec<String>,
    pub informed: Vec<String>,
    pub context: String,
    pub drivers: Vec<DecisionDriver>,
    pub options: Vec<DecisionOption>,
    pub decision: String,
    pub consequences: Option<String>,
    pub linked_assets: Vec<AssetLink>,
    pub supersedes: Option<Uuid>,
    pub superseded_by: Option<Uuid>,
    pub related_decisions: Vec<Uuid>,
    pub related_knowledge: Vec<Uuid>,
    pub compliance: Option<ComplianceAssessment>,
    pub confirmation_date: Option<DateTime<Utc>>,
    pub confirmation_notes: Option<String>,
    pub tags: Vec<Tag>,
    pub notes: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

MADR-compliant Decision Record

Represents an architectural or data decision following the MADR template.

Fields

id: Uuid

Unique identifier for the decision

number: u64

Decision number - can be sequential (1, 2, 3) or timestamp-based (YYMMDDHHmm format) Timestamp format prevents merge conflicts in distributed Git workflows

title: String

Short title describing the decision

status: DecisionStatus

Current status of the decision

category: DecisionCategory

Category of the decision

domain: Option<String>

Domain this decision belongs to (optional, string name)

domain_id: Option<Uuid>

Domain UUID reference (optional)

workspace_id: Option<Uuid>

Workspace UUID reference (optional)

date: DateTime<Utc>

Date the decision was made

decided_at: Option<DateTime<Utc>>

When the decision was accepted/finalized

authors: Vec<String>

Authors of the decision record

deciders: Vec<String>

People or teams who made the decision (deciders)

consulted: Vec<String>

People or teams consulted during decision making (RACI - Consulted)

informed: Vec<String>

People or teams to be informed about the decision (RACI - Informed)

context: String

Problem statement and context for the decision

drivers: Vec<DecisionDriver>

Reasons driving this decision

options: Vec<DecisionOption>

Options that were considered

decision: String

The decision that was made

consequences: Option<String>

Positive and negative consequences of the decision

linked_assets: Vec<AssetLink>

Assets affected by this decision

supersedes: Option<Uuid>

ID of the decision this supersedes

superseded_by: Option<Uuid>

ID of the decision that superseded this

related_decisions: Vec<Uuid>

IDs of related decisions

related_knowledge: Vec<Uuid>

IDs of related knowledge articles

compliance: Option<ComplianceAssessment>

Compliance assessment

confirmation_date: Option<DateTime<Utc>>

Date the decision was confirmed/reviewed

confirmation_notes: Option<String>

Notes from confirmation review

tags: Vec<Tag>

Tags for categorization

notes: Option<String>

Additional notes

created_at: DateTime<Utc>

Creation timestamp

updated_at: DateTime<Utc>

Last modification timestamp

Implementations

impl Decision

pub fn new( number: u64, title: impl Into<String>, context: impl Into<String>, decision: impl Into<String>, ) -> Self

Create a new decision with required fields

pub fn new_with_timestamp( title: impl Into<String>, context: impl Into<String>, decision: impl Into<String>, ) -> Self

Create a new decision with a timestamp-based number (YYMMDDHHmm format) This format prevents merge conflicts in distributed Git workflows

pub fn generate_timestamp_number(dt: &DateTime<Utc>) -> u64

Generate a timestamp-based decision number in YYMMDDHHmm format

pub fn generate_id(number: u64) -> Uuid

Generate a deterministic UUID for a decision based on its number

pub fn add_author(self, author: impl Into<String>) -> Self

Add an author

pub fn add_consulted(self, consulted: impl Into<String>) -> Self

Set consulted parties (RACI - Consulted)

pub fn add_informed(self, informed: impl Into<String>) -> Self

Set informed parties (RACI - Informed)

pub fn add_related_decision(self, decision_id: Uuid) -> Self

Add a related decision

pub fn add_related_knowledge(self, article_id: Uuid) -> Self

Add a related knowledge article

pub fn with_decided_at(self, decided_at: DateTime<Utc>) -> Self

Set decided_at timestamp

pub fn with_domain_id(self, domain_id: Uuid) -> Self

Set the domain ID

pub fn with_workspace_id(self, workspace_id: Uuid) -> Self

Set the workspace ID

pub fn with_status(self, status: DecisionStatus) -> Self

Set the decision status

pub fn with_category(self, category: DecisionCategory) -> Self

Set the decision category

pub fn with_domain(self, domain: impl Into<String>) -> Self

Set the domain

pub fn add_decider(self, decider: impl Into<String>) -> Self

Add a decider

pub fn add_driver(self, driver: DecisionDriver) -> Self

Add a driver

pub fn add_option(self, option: DecisionOption) -> Self

Add an option

pub fn with_consequences(self, consequences: impl Into<String>) -> Self

Set consequences

pub fn add_asset_link(self, link: AssetLink) -> Self

Add an asset link

pub fn with_compliance(self, compliance: ComplianceAssessment) -> Self

Set compliance assessment

pub fn supersedes_decision(self, other_id: Uuid) -> Self

Mark this decision as superseding another

pub fn superseded_by_decision(&mut self, other_id: Uuid)

Mark this decision as superseded by another

pub fn add_tag(self, tag: Tag) -> Self

Add a tag

pub fn is_timestamp_number(&self) -> bool

Check if the decision number is timestamp-based (YYMMDDHHmm format - 10 digits)

pub fn formatted_number(&self) -> String

Format the decision number for display Returns “ADR-0001” for sequential or “ADR-2601101234” for timestamp-based

pub fn filename(&self, workspace_name: &str) -> String

Generate the YAML filename for this decision

pub fn markdown_filename(&self) -> String

Generate the Markdown filename for this decision

pub fn from_yaml(yaml_content: &str) -> Result<Self, Error>

Import from YAML

pub fn to_yaml(&self) -> Result<String, Error>

Export to YAML

pub fn to_yaml_pretty(&self) -> Result<String, Error>

Export to pretty YAML

Trait Implementations

impl Clone for Decision

fn clone(&self) -> Decision

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Decision

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Decision

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Decision> for DecisionIndexEntry

fn from(decision: &Decision) -> Self

Converts to this type from the input type.

impl PartialEq for Decision

fn eq(&self, other: &Decision) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Decision

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Decision