Entity [Recommendation Instance]

Entity [Recommendation Instance]

Comment

Description: A ranked, child-specific delivery of guidance or an activity with recorded rationale. Usage: This core business record is used in the 07 Recommendations subject area as the authoritative representation of recommendation instance data. It owns or classifies Recommendation has Decision Factors, Recommendation has Parent Feedback, Recommendation may lead to Activity Sessions, Recommendation creates Notification Intents; is referenced through Recommendation Run has Instances, Guidance Item is delivered as Recommendations, Activity is delivered as Recommendations. A recommendation normally delivers either one Guidance Item or one Activity; populate both only when the product explicitly treats the guidance as a wrapper for the launched activity.


Name

Comment

Recommendation Instance ID

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

Rank

Description: Ordering value used to sort or prioritize Recommendation Instance records. Usage: Used by evaluation, ranking, threshold, explanation, and quality-control logic; it must not be presented as clinical certainty unless explicitly validated. Required for every record.

Reason Code

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

Parent Facing Explanation

Description: Explanation shown to the parent describing why the recommendation was selected. 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.

Guidance Content Version

Description: Exact guidance content version presented in the recommendation. Usage: Used to reproduce historical decisions, invalidate derived projections when logic changes, and support controlled migration. Optional and recorded only when known or applicable.

Eligibility Score

Description: Normalized numeric measure representing eligibility score. 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.

Priority Score

Description: Normalized numeric measure representing priority score. 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.

Confidence18

Description: Normalized numeric measure representing confidence. 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.

Status18

Description: Lifecycle or workflow status of the Recommendation Instance record. Usage: Used to gate workflow transitions, exclude inactive or incomplete records, support operations dashboards, and preserve processing history. Required for every record.

Generated At

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

Delivered At

Description: Timestamp recording when the delivered event occurred. Usage: Used for scheduling, recency rules, effective dating, audit history, and chronological reporting. Optional and recorded only when known or applicable.

Opened At

Description: Timestamp recording when the opened event occurred. Usage: Used for scheduling, recency rules, effective dating, audit history, and chronological reporting. Optional and recorded only when known or applicable.

Acted On At

Description: Timestamp recording when the acted on event occurred. Usage: Used for scheduling, recency rules, effective dating, audit history, and chronological reporting. Optional and recorded only when known or applicable.

Dismissed At

Description: Timestamp recording when the dismissed event occurred. Usage: Used for scheduling, recency rules, effective dating, audit history, and chronological reporting. Optional and recorded only when known or applicable.

Dismissal Reason

Description: Business value storing dismissal reason for the Recommendation Instance record. Usage: Used by services, rules, search, reporting, or audit processing that operates on Recommendation Instance records. Optional and recorded only when known or applicable.