Cairn Documentation

Entity Types 10

The data model primitives that make up every Cairn project.

Node

Core building block — system, subsystem, assembly, part, or external actor. Properties bag supports engineering params, evaluation status, narrative cache, and brief data.

idnametypedescriptionparentIdpropertiespositionsortOrdercreatedBy
Requirement

Functional, performance, interface, safety, environmental, or constraint requirement scoped to a node.

idnodeIdtitledescriptiontypepriorityrationaleacceptanceCriteriasortOrder
Interface

Connection between two nodes carrying typed signals with protocol, rate, and simulation metadata.

idnamesourceNodeIdtargetNodeIdsignalsprotocoldescription
State

Behavioral state in a node's state machine. Supports timing annotations for simulation.

idnametypedescriptionnodeIdpositiontypicalDurationdurationUnit
Transition

State transition with guard condition, action, and optional timing parameters.

idnodeIdsourceStateIdtargetStateIdtriggerguardactiontypicalDuration
Verification

Test, analysis, demonstration, or inspection record linked to a requirement.

idrequirementIdmethoddescriptionstatusresults
TraceLink

Traceability relationship: satisfies, implements, verifies, derives, depends_on, or custom.

idtypesourceIdtargetIdsourceKindtargetKindrationaleconfidencestatus
UseCase

Operational scenario with actors, preconditions, postconditions, and ordered steps.

idnodeIdtitledescriptionactorspreconditionspostconditionssteps
Property

Key-value engineering parameter with units, category, and source. Stored in node.properties.params[].

keylabelvalueunitIdcategorysourcedescription
Evaluation

Optional dendritic evaluation metadata on nodes for pruned alternatives tracking.

evaluationStatusdecisionTypepruneReasonfirstPrincipleevaluationPhasecrossDependencies