Struct Sketch 

pub struct Sketch {

    pub id: Uuid,
    pub number: u64,
    pub title: String,
    pub sketch_type: SketchType,
    pub status: SketchStatus,
    pub domain: Option<String>,
    pub domain_id: Option<Uuid>,
    pub workspace_id: Option<Uuid>,
    pub description: Option<String>,
    pub excalidraw_data: String,
    pub thumbnail_path: Option<String>,
    pub authors: Vec<String>,
    pub linked_assets: Vec<AssetLink>,
    pub linked_decisions: Vec<Uuid>,
    pub linked_knowledge: Vec<Uuid>,
    pub related_sketches: Vec<Uuid>,
    pub tags: Vec<Tag>,
    pub notes: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Excalidraw Sketch

Represents an Excalidraw sketch that can be categorized by domain, type, and linked to other assets.

Fields

id: Uuid

Unique identifier for the sketch

number: u64

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

title: String

Sketch title

sketch_type: SketchType

Type of sketch

status: SketchStatus

Publication status

domain: Option<String>

Domain this sketch belongs to (optional, string name)

domain_id: Option<Uuid>

Domain UUID reference (optional)

workspace_id: Option<Uuid>

Workspace UUID reference (optional)

description: Option<String>

Brief description of the sketch

excalidraw_data: String

Excalidraw scene data as JSON string

thumbnail_path: Option<String>

Optional path to PNG thumbnail (relative path, e.g., “thumbnails/sketch-0001.png”)

authors: Vec<String>

Sketch authors (emails or names)

linked_assets: Vec<AssetLink>

Assets referenced by this sketch

linked_decisions: Vec<Uuid>

UUIDs of related decisions

linked_knowledge: Vec<Uuid>

UUIDs of related knowledge articles

related_sketches: Vec<Uuid>

UUIDs of related sketches

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 Sketch

pub fn new( number: u64, title: impl Into<String>, excalidraw_data: impl Into<String>, ) -> Sketch

Create a new sketch with required fields

pub fn new_with_timestamp( title: impl Into<String>, excalidraw_data: impl Into<String>, ) -> Sketch

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

pub fn generate_id(number: u64) -> Uuid

Generate a deterministic UUID for a sketch based on its number

pub fn is_timestamp_number(&self) -> bool

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

pub fn formatted_number(&self) -> String

Format the sketch number for display Returns “SKETCH-0001” for sequential or “SKETCH-2601101234” for timestamp-based

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

Generate the YAML filename for this sketch

pub fn thumbnail_filename(&self) -> String

Generate the thumbnail filename for this sketch

pub fn with_type(self, sketch_type: SketchType) -> Sketch

Set the sketch type

pub fn with_status(self, status: SketchStatus) -> Sketch

Set the sketch status

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

Set the domain

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

Set the domain ID

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

Set the workspace ID

pub fn with_description(self, description: impl Into<String>) -> Sketch

Set the description

pub fn with_thumbnail(self, thumbnail_path: impl Into<String>) -> Sketch

Set the thumbnail path

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

Add an author

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

Add an asset link

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

Link to a decision

pub fn link_knowledge(self, knowledge_id: Uuid) -> Sketch

Link to a knowledge article

pub fn add_related_sketch(self, sketch_id: Uuid) -> Sketch

Add a related sketch

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

Add a tag

pub fn with_notes(self, notes: impl Into<String>) -> Sketch

Set notes

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

Import from YAML

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

Export to YAML

Trait Implementations

impl Clone for Sketch

fn clone(&self) -> Sketch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sketch

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Sketch

fn deserialize<__D>( __deserializer: __D, ) -> Result<Sketch, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Sketch> for SketchIndexEntry

fn from(sketch: &Sketch) -> SketchIndexEntry

Converts to this type from the input type.

impl PartialEq for Sketch

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Sketch