Struct KnowledgeArticle 

pub struct KnowledgeArticle {

    pub id: Uuid,
    pub number: u64,
    pub title: String,
    pub article_type: KnowledgeType,
    pub status: KnowledgeStatus,
    pub domain: Option<String>,
    pub domain_id: Option<Uuid>,
    pub workspace_id: Option<Uuid>,
    pub summary: String,
    pub content: String,
    pub authors: Vec<String>,
    pub reviewers: Vec<String>,
    pub last_reviewed: Option<DateTime<Utc>>,
    pub reviewed_at: Option<DateTime<Utc>>,
    pub published_at: Option<DateTime<Utc>>,
    pub archived_at: Option<DateTime<Utc>>,
    pub review_frequency: Option<ReviewFrequency>,
    pub audience: Vec<String>,
    pub skill_level: Option<SkillLevel>,
    pub linked_assets: Vec<AssetLink>,
    pub linked_decisions: Vec<Uuid>,
    pub related_decisions: Vec<Uuid>,
    pub related_articles: Vec<RelatedArticle>,
    pub prerequisites: Vec<Uuid>,
    pub see_also: Vec<Uuid>,
    pub tags: Vec<Tag>,
    pub notes: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Knowledge Base Article

Represents a knowledge article that can be categorized by domain, type, and audience.

Fields

id: Uuid

Unique identifier for the article

number: u64

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

title: String

Article title

article_type: KnowledgeType

Type of article

status: KnowledgeStatus

Publication status

domain: Option<String>

Domain this article belongs to (optional, string name)

domain_id: Option<Uuid>

Domain UUID reference (optional)

workspace_id: Option<Uuid>

Workspace UUID reference (optional)

summary: String

Brief summary of the article

content: String

Full article content in Markdown

authors: Vec<String>

Article authors (emails or names) - changed from single author to array

reviewers: Vec<String>

List of reviewers

last_reviewed: Option<DateTime<Utc>>

Date of last review (legacy field name)

reviewed_at: Option<DateTime<Utc>>

Last review timestamp (camelCase alias)

published_at: Option<DateTime<Utc>>

When the article was published

archived_at: Option<DateTime<Utc>>

When the article was archived

review_frequency: Option<ReviewFrequency>

How often the article should be reviewed

audience: Vec<String>

Target audience for the article

skill_level: Option<SkillLevel>

Required skill level

linked_assets: Vec<AssetLink>

Assets referenced by this article

linked_decisions: Vec<Uuid>

UUIDs of related decisions (legacy field)

related_decisions: Vec<Uuid>

IDs of related decision records

related_articles: Vec<RelatedArticle>

Related articles (detailed info)

prerequisites: Vec<Uuid>

IDs of prerequisite articles (must read first)

see_also: Vec<Uuid>

IDs of ‘See Also’ articles for further reading

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 KnowledgeArticle

pub fn new( number: u64, title: impl Into<String>, summary: impl Into<String>, content: impl Into<String>, author: impl Into<String>, ) -> Self

Create a new knowledge article with required fields

pub fn new_with_timestamp( title: impl Into<String>, summary: impl Into<String>, content: impl Into<String>, author: impl Into<String>, ) -> Self

Create a new knowledge article 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 article number in YYMMDDHHmm format

pub fn generate_id(number: u64) -> Uuid

Generate a deterministic UUID for an article based on its number

pub fn is_timestamp_number(&self) -> bool

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

pub fn formatted_number(&self) -> String

Format the article number for display Returns “KB-0001” for sequential or “KB-2601101234” for timestamp-based

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

Add an author

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_type(self, article_type: KnowledgeType) -> Self

Set the article type

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

Set the article status

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

Set the domain

pub fn add_reviewer(self, reviewer: impl Into<String>) -> Self

Add a reviewer

pub fn with_review_frequency(self, frequency: ReviewFrequency) -> Self

Set review frequency

pub fn add_audience(self, audience: impl Into<String>) -> Self

Add an audience

pub fn with_skill_level(self, level: SkillLevel) -> Self

Set skill level

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

Add an asset link

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

Link to a decision

pub fn add_related_article(self, article: RelatedArticle) -> Self

Add a related article

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

Add a related decision

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

Add a prerequisite article

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

Add a “see also” article reference

pub fn with_published_at(self, published_at: DateTime<Utc>) -> Self

Set the published timestamp

pub fn with_archived_at(self, archived_at: DateTime<Utc>) -> Self

Set the archived timestamp

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

Add a tag

pub fn mark_reviewed(&mut self)

Mark the article as reviewed

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

Generate the YAML filename for this article

pub fn markdown_filename(&self) -> String

Generate the Markdown filename for this article

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

Import from YAML

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

Export to YAML

Trait Implementations

impl Clone for KnowledgeArticle

fn clone(&self) -> KnowledgeArticle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KnowledgeArticle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KnowledgeArticle

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&KnowledgeArticle> for KnowledgeIndexEntry

fn from(article: &KnowledgeArticle) -> Self

Converts to this type from the input type.

impl PartialEq for KnowledgeArticle

fn eq(&self, other: &KnowledgeArticle) -> 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 KnowledgeArticle

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 KnowledgeArticle