Clinical Intelligence StandardsVersion 0.2

Functional standard / Definition kinds / Constrains Assessment

assessment

A questionnaire or calculator: items, kernel, and the observation code for the score.

Runtime

The named kernel scores the answers. The client cannot send the score. Finalize writes the observation and, on a safety flag, an urgent task.

Elements

NameCard.TypeDescription
defaults0..1objectFields copied onto a new instance. Values given at creation win.
approval_required_for0..*codeExtra states that need an Approval to enter.
assessment_type1..1codequestionnaire or calculator.
patient_reported1..1booleanWhen true, the patient may complete it.
items0..*objectparam, text, options with label and points. Empty means free inputs.
kernel1..1codeweighted_point_sum, weight_banded_dose, eval_reference_equation, logistic_risk, exposure_integral, or boolean_gate.
reference_rows0..*objectReference data for equation kernels.
kernel_config0..1objectBands, weights, and formula parameters.
observation_code0..1codeScore is written as this observation.
lower_is_better0..1booleanHow a trajectory should read the score.
inputs0..*objectInput names, or objects with name, unit, min, max, required.
alert_bands0..*codeBands that raise an urgent review task.
flag_rules0..*objectRules whose expression is evaluated over the inputs and the computed value.

Example

{ "assessment_type": "questionnaire", "kernel": "weighted_point_sum", "observation_code": "phq9_score", "items": [{ "param": "item_1", "text": "Little interest" }] }