content-notes — IMP FORGE

Notes and tagging for any model via generic foreign keys

Tier	content
Role	unclassified (baselined)
Path	`crates/content/notes`
Edition	2021
Targets	content_notes
Public items	93 across 6 modules
Tests	69

What it is for

# content-notes

Notes and tagging library crates for any model via generic foreign keys.

Core Concepts

Generic FK pattern: Attach notes and tags to any model using target_type + target_id
Three-tier visibility: Public, Internal (default), or Private notes
Reusable tags: Define tags with colors, apply to any object
Soft delete: Preserve notes and tags for audit trail

Example

use content_notes::{Note, Tag, ObjectTag, Visibility, colors};
use uuid::Uuid;

// Create a note attached to a patient
let note = Note::builder()
.target("patients.Patient", "patient-123")
.content("Follow-up scheduled for next week")
.author(Uuid::new_v4())
.visibility(Visibility::Internal)
.build();

// Create a reusable tag
let urgent_tag = Tag::builder()
.name("Urgent")
.red()
.description("Requires immediate attention")
.build();

// Apply tag to a project
let object_tag = ObjectTag::builder()
.target("projects.Project", "project-456")
.tag(urgent_tag.id)
.tagged_by(Uuid::new_v4())
.build();

Capabilities

`colors (other)`

Standard tag colors.

Item
`pub const RED: & str`
`pub const ORANGE: & str`
`pub const YELLOW: & str`
`pub const GREEN: & str`
`pub const BLUE: & str`
`pub const PURPLE: & str`
`pub const GRAY: & str`
`pub const DEFAULT: & str`
`fn is_valid_hex(color : & str) -> bool`
`fn normalize(color : & str) -> String`

`NotesError`

Error types for the notes crate.

Item
`pub enum NotesError`
`NotesError :: fn note_not_found(id : Uuid) -> Self`
`NotesError :: fn tag_not_found(slug : impl Into <String>) -> Self`
`NotesError :: fn tag_not_found_by_id(id : Uuid) -> Self`
`NotesError :: fn object_tag_not_found(id : Uuid) -> Self`
`NotesError :: fn duplicate_slug(slug : impl Into <String>) -> Self`
`NotesError :: fn tag_already_applied(tag_slug : impl Into <String>, target_type : impl Into <String>, target_id : impl Into <String>,) -> Self`
`NotesError :: fn invalid_color(color : impl Into <String>) -> Self`

`Note:Note`

Note model for attaching comments to any target.

Item
`pub struct Note`

`Note:builder`

Note model for attaching comments to any target.

Item
`Note :: fn builder() -> NoteBuilder`

`Note:can`

Note model for attaching comments to any target.

Item
`Note :: fn can_view(& self, user_id : Option <Uuid>, is_staff : bool) -> bool`

`Note:created`

Note model for attaching comments to any target.

Item
`Note :: fn created_at(& self) -> DateTime <Utc>`

`Note:deleted`

Note model for attaching comments to any target.

Item
`Note :: fn deleted_at(& self) -> Option <DateTime <Utc>>`

`Note:id`

Note model for attaching comments to any target.

Item
`Note :: fn id(& self) -> Uuid`

`Note:is`

Note model for attaching comments to any target.

Item
`Note :: fn is_for(& self, target_type : & str, target_id : & str) -> bool`
`Note :: fn is_by(& self, author_id : Uuid) -> bool`
`Note :: fn is_system_note(& self) -> bool`

`Note:preview`

Note model for attaching comments to any target.

Item
`Note :: fn preview(& self, max_chars : usize) -> & str`

`Note:restore`

Note model for attaching comments to any target.

Item
`Note :: fn restore(& mut self)`

`Note:soft`

Note model for attaching comments to any target.

Item
`Note :: fn soft_delete(& mut self)`

`Note:updated`

Note model for attaching comments to any target.

Item
`Note :: fn updated_at(& self) -> DateTime <Utc>`

`NoteBuilder`

Note model for attaching comments to any target.

Item
`pub struct NoteBuilder`
`NoteBuilder :: fn new() -> Self`
`NoteBuilder :: fn target(mut self, target_type : impl Into <String>, target_id : impl Into <String>) -> Self`
`NoteBuilder :: fn content(mut self, content : impl Into <String>) -> Self`
`NoteBuilder :: fn author(mut self, author_id : Uuid) -> Self`
`NoteBuilder :: fn visibility(mut self, visibility : Visibility) -> Self`
`NoteBuilder :: fn public(self) -> Self`
`NoteBuilder :: fn internal(self) -> Self`
`NoteBuilder :: fn private(self) -> Self`
`NoteBuilder :: fn metadata(mut self, metadata : JsonValue) -> Self`
`NoteBuilder :: fn build(self) -> Note`

`ObjectTag:ObjectTag`

ObjectTag model for linking tags to any target.

Item
`pub struct ObjectTag`

`ObjectTag:builder`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn builder() -> ObjectTagBuilder`

`ObjectTag:created`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn created_at(& self) -> DateTime <Utc>`

`ObjectTag:deleted`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn deleted_at(& self) -> Option <DateTime <Utc>>`

`ObjectTag:id`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn id(& self) -> Uuid`

`ObjectTag:is`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn is_for(& self, target_type : & str, target_id : & str) -> bool`
`ObjectTag :: fn is_tag(& self, tag_id : Uuid) -> bool`
`ObjectTag :: fn is_by(& self, user_id : Uuid) -> bool`
`ObjectTag :: fn is_system_tag(& self) -> bool`

`ObjectTag:matches`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn matches(& self, target_type : & str, target_id : & str, tag_id : Uuid) -> bool`

`ObjectTag:restore`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn restore(& mut self)`

`ObjectTag:soft`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn soft_delete(& mut self)`

`ObjectTag:updated`

ObjectTag model for linking tags to any target.

Item
`ObjectTag :: fn updated_at(& self) -> DateTime <Utc>`