Entity [Observation]

Entity [Observation]

Comment

Description: Append-only dated evidence reported or observed about a child. Usage: This core business record is used in the 05 Collection and Evidence subject area as the authoritative representation of observation data. It owns or classifies Observation has Evidence Mappings, Observation contributes Evaluation Links; is referenced through Child has Observations, Household Membership records Observations, Activity Outcome proposes Observations, Questionnaire Session has Drilldown Observations.


Name

Comment

Observation ID

Description: Stable system identifier for a Observation record. Usage: Used as the conceptual primary identifier and as the stable reference from relationships to Observation. Required for every record.

Observed At

Description: Timestamp recording when the observed event occurred. Usage: Used for scheduling, recency rules, effective dating, audit history, and chronological reporting. Required for every record.

Recorded At2

Description: Timestamp recording when the recorded event occurred. Usage: Used for scheduling, recency rules, effective dating, audit history, and chronological reporting. Required for every record.

Observation Type

Description: Controlled classification value for observation type. Usage: Used to select business rules, validate compatible relationships, group records, filter queries, and drive user-interface behavior. Required for every record.

Raw Text

Description: Original parent- or caregiver-entered observation text preserved without AI rewriting. Usage: Used by authoring, localization, parent-facing presentation, explainability, or reviewer workflows according to the entity context. Optional and recorded only when known or applicable.

Structured Behavior

Description: Normalized description of the observed behavior extracted or confirmed from the raw observation. Usage: Used by services, rules, search, reporting, or audit processing that operates on Observation records. Optional and recorded only when known or applicable.

Assistance Level3

Description: Controlled classification value for assistance level. Usage: Used to select business rules, validate compatible relationships, group records, filter queries, and drive user-interface behavior. Optional and recorded only when known or applicable.

Frequency

Description: Numeric measurement for frequency. Usage: Used by services, rules, search, reporting, or audit processing that operates on Observation records. Optional and recorded only when known or applicable.

Consistency

Description: Normalized numeric measure representing consistency. Usage: Used by evaluation, ranking, threshold, explanation, and quality-control logic; it must not be presented as clinical certainty unless explicitly validated. Optional and recorded only when known or applicable.

Parent Confidence2

Description: Caregiver-reported certainty that the observation or answer accurately reflects the child. Usage: Used by evaluation, ranking, threshold, explanation, and quality-control logic; it must not be presented as clinical certainty unless explicitly validated. Optional and recorded only when known or applicable.

Evidence Quality

Description: Quality classification based on source, recency, context, and observation detail. Usage: Used by services, rules, search, reporting, or audit processing that operates on Observation records. Optional and recorded only when known or applicable.

Source6

Description: Controlled classification value for source. Usage: Used to select business rules, validate compatible relationships, group records, filter queries, and drive user-interface behavior. Required for every record.

Context JSON2

Description: Flexible structured context captured with the record for later interpretation and audit. Usage: Used for extensible PoC data and asynchronous processing while stable, frequently queried concepts remain modeled as first-class attributes and relationships. Optional and recorded only when known or applicable.