Concepts
Pragmatic.Notes is the internal-annotation trait.
Mental Model
Section titled “Mental Model”Use notes when staff or operators need private annotations on a domain entity:
- reservation handling notes
- fraud review remarks
- internal billing comments
Notes are intentionally simpler than comments:
- no threading
- no anonymous authors
- no public visibility model
Generated Shape
Section titled “Generated Shape”From [HasNotes], the consuming project gets:
- a typed
{Parent}Noteentity - EF configuration and FK
- actions for add, get-by-id, update, and delete
- note endpoints under the parent resource
- a
Notesnavigation on the parent