PTPlanOfCare
<co-pt-plan-of-care>PTPlanOfCare shows a therapy plan of care: diagnosis and certification, visits used against the authorization, functional outcome scores against their minimal important change, and short and long term goals.
import { PTPlanOfCare } from 'health-components';
Examples
Authorization Nearly Used
Usage
<PTPlanOfCare auth={{ used: 9, authorized: 12, payer: "Aetna" }} scores={[{ name: "LEFS", k: "pts", baseline: 32, current: 51, mcid: 9, higherBetter: true }]} goals={[]} />
When to use
- Physical, occupational and speech therapy evaluations, progress notes and recertifications.
When not to use
- A single visit note: the daily note template.
- Authorization requests: PriorAuthCard.
Variants and states
| Variant | What it is |
|---|---|
| authorization meter | Primary under 80%, warning from 80%, danger at 100%; two visits or fewer left asks for more now. |
| progress note due | Warning badge at 10 visits since the last progress note. |
| scores | Each measure with baseline, current, signed change and MCID: Change beyond MCID (success), better but under MCID (info), no improvement (danger). |
| goals | Short and long term goals with baseline, current and target values and status Met, Progressing, Not met or New. |
| readOnly | Hides actions. |
Clinical values
Every number goes through the shared clinical value rules (CareOS.fmt and ClinicalValue from the clinical-values card): tabular digits, the unit always shown, a fixed precision per measure, the reference range in the tooltip, and H, L or critical flags. Medication amounts follow the ISMP dose style through fmt.doseNumber: rounded to the stated precision, then shown with no trailing zero (5 mg, never 5.0 mg) and a leading zero (0.5 mL). The specialty measures this card adds sit in CareOS.specialty.MEAS with their precision: scores whole points or percent, range of motion whole degrees, pain whole numbers out of 10. Ranges in the previews are sample values for the design system, not clinical guidance; a real deployment passes its own.
Accessibility
- The authorization meter has a value text in words.
- Change is signed and the meaning is a word badge.
- Goals and scores are tables with captions.
Do and don't
- Do: Show MCID next to every change.
- Do: Warn before the last authorized visit, not after it.
- Don't: Call a change an improvement when it is under MCID.
- Don't: Count unsigned notes as used visits.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
diagnosis | string | 'Not recorded' | Diagnosis with code |
cert | string | 'Not recorded' | Certification period |
frequency | string | 'Not recorded' | Visit frequency |
referring | string | 'Not recorded' | Referring provider |
auth * | PTAuthorization | — | {used, authorized, payer, expires}; required |
visitsSinceProgressNote | number | 0 | Visits since the last progress note |
progressNoteDue | boolean | false (due at 10 visits) | Forces the Progress note due badge |
scores | ReadonlyArray<PTScore> | [] | Functional outcome scores |
goals | ReadonlyArray<PTGoal> | [] | Goals |
title | string | 'Physical therapy plan of care' | Card title |
subtitle | string | none | Line under the title |
readOnly | boolean | false | Hides Progress Note and Send for Certification |
onProgressNote | () => void | none | Progress Note action |
onSendForCertification | () => void | none | Send for Certification action |
rangeContext | RangeContextId | the global context, else 'outpatient' | Which shared reference range flags use; the lab range on a result still wins |
Also accepts native attributes, including defaultChecked, defaultValue, autoFocus, plus className and event handlers on the root element.
Angular, Vue and HTML
Register the elements once (Angular guide), then use <co-pt-plan-of-care>. Attributes take strings; arrays and objects are set as properties (Angular [prop], Vue :prop) or as JSON attributes. Callbacks are DOM events with the value in event.detail.
<co-pt-plan-of-care diagnosis="…" cert="…" [auth]="auth" (co-progress-note)="onProgressNote($event.detail)"></co-pt-plan-of-care>
| Kind | Name | Description |
|---|---|---|
| attribute | diagnosis | Diagnosis with code; default 'Not recorded' |
| attribute | cert | Certification period; default 'Not recorded' |
| attribute | frequency | Visit frequency; default 'Not recorded' |
| attribute | referring | Referring provider; default 'Not recorded' |
| property / JSON attribute | auth | {used, authorized, payer, expires}; required |
| attribute | visits-since-progress-note / visitsSinceProgressNote | Visits since the last progress note; default 0 |
| attribute | progress-note-due / progressNoteDue | Forces the Progress note due badge; default false (due at 10 visits) |
| property / JSON attribute | scores | Functional outcome scores; default [] |
| property / JSON attribute | goals | Goals; default [] |
| attribute | title | Card title; default 'Physical therapy plan of care' |
| attribute | subtitle | Line under the title; default none |
| attribute | read-only / readOnly | Hides Progress Note and Send for Certification; default false |
| attribute | range-context / rangeContext | Which shared reference range flags use; the lab range on a result still wins; default the global context, else 'outpatient' |
| attribute | default-checked / defaultChecked | |
| property / JSON attribute | default-value / defaultValue | |
| attribute | auto-focus / autoFocus | |
| event | co-progress-note | Progress Note action; default none (React: onProgressNote) |
| event | co-send-for-certification | Send for Certification action; default none (React: onSendForCertification) |