Struct Annotation 

pub struct Annotation {
    pub id: AnnotationId,
    pub parent_id: Option<AnnotationId>,
    pub paper_id: PaperId,
    pub question_id: Option<QuestionId>,
    pub anchor: Anchor,
    pub note: String,
    pub color: Option<String>,
    pub tags: Vec<String>,
    pub author: String,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub deleted_at: Option<DateTime<Utc>>,
}

One annotation. May be a root (with an anchor) or a reply (parent_id set, anchor empty; the root’s anchor is the canonical one for rendering).

Fields

id: AnnotationId

parent_id: Option<AnnotationId>

None = root (carries the anchor). Some = reply to that ID.

paper_id: PaperId

question_id: Option<QuestionId>

anchor: Anchor

note: String

color: Option<String>

tags: Vec<String>

author: String

Identity string — $USER for TUI writes, required for MCP writes.

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

deleted_at: Option<DateTime<Utc>>

Soft-delete tombstone. None = live.

Implementations

impl Annotation

pub fn new_root( paper_id: PaperId, author: String, note: String, anchor: Anchor, ) -> Self

Build a new root-level annotation with the given anchor.

pub fn new_reply(parent: &Annotation, author: String, note: String) -> Self

Build a new reply whose anchor is empty (inherits from root).

pub fn is_reply(&self) -> bool

True if this is a reply to another annotation.

pub fn is_deleted(&self) -> bool

True if this annotation has been soft-deleted.

Trait Implementations

impl Clone for Annotation

fn clone(&self) -> Annotation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Annotation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Annotation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Annotation

impl PartialEq for Annotation

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

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 Annotation