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
| Name | Card. | Type | Description |
|---|---|---|---|
| defaults | 0..1 | object | Fields copied onto a new instance. Values given at creation win. |
| approval_required_for | 0..* | code | Extra states that need an Approval to enter. |
| assessment_type | 1..1 | code | questionnaire or calculator. |
| patient_reported | 1..1 | boolean | When true, the patient may complete it. |
| items | 0..* | object | param, text, options with label and points. Empty means free inputs. |
| kernel | 1..1 | code | weighted_point_sum, weight_banded_dose, eval_reference_equation, logistic_risk, exposure_integral, or boolean_gate. |
| reference_rows | 0..* | object | Reference data for equation kernels. |
| kernel_config | 0..1 | object | Bands, weights, and formula parameters. |
| observation_code | 0..1 | code | Score is written as this observation. |
| lower_is_better | 0..1 | boolean | How a trajectory should read the score. |
| inputs | 0..* | object | Input names, or objects with name, unit, min, max, required. |
| alert_bands | 0..* | code | Bands that raise an urgent review task. |
| flag_rules | 0..* | object | Rules 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" }] }