Skip to main content

PTPlanOfCare

ComplexSpecialty<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​

Storybook

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​

VariantWhat it is
authorization meterPrimary under 80%, warning from 80%, danger at 100%; two visits or fewer left asks for more now.
progress note dueWarning badge at 10 visits since the last progress note.
scoresEach measure with baseline, current, signed change and MCID: Change beyond MCID (success), better but under MCID (info), no improvement (danger).
goalsShort and long term goals with baseline, current and target values and status Met, Progressing, Not met or New.
readOnlyHides 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​

PropTypeDefaultDescription
diagnosisstring'Not recorded'Diagnosis with code
certstring'Not recorded'Certification period
frequencystring'Not recorded'Visit frequency
referringstring'Not recorded'Referring provider
auth *PTAuthorization—{used, authorized, payer, expires}; required
visitsSinceProgressNotenumber0Visits since the last progress note
progressNoteDuebooleanfalse (due at 10 visits)Forces the Progress note due badge
scoresReadonlyArray<PTScore>[]Functional outcome scores
goalsReadonlyArray<PTGoal>[]Goals
titlestring'Physical therapy plan of care'Card title
subtitlestringnoneLine under the title
readOnlybooleanfalseHides Progress Note and Send for Certification
onProgressNote() => voidnoneProgress Note action
onSendForCertification() => voidnoneSend for Certification action
rangeContextRangeContextIdthe 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.

Angular template
<co-pt-plan-of-care diagnosis="…" cert="…" [auth]="auth" (co-progress-note)="onProgressNote($event.detail)"></co-pt-plan-of-care>
KindNameDescription
attributediagnosisDiagnosis with code; default 'Not recorded'
attributecertCertification period; default 'Not recorded'
attributefrequencyVisit frequency; default 'Not recorded'
attributereferringReferring provider; default 'Not recorded'
property / JSON attributeauth{used, authorized, payer, expires}; required
attributevisits-since-progress-note / visitsSinceProgressNoteVisits since the last progress note; default 0
attributeprogress-note-due / progressNoteDueForces the Progress note due badge; default false (due at 10 visits)
property / JSON attributescoresFunctional outcome scores; default []
property / JSON attributegoalsGoals; default []
attributetitleCard title; default 'Physical therapy plan of care'
attributesubtitleLine under the title; default none
attributeread-only / readOnlyHides Progress Note and Send for Certification; default false
attributerange-context / rangeContextWhich shared reference range flags use; the lab range on a result still wins; default the global context, else 'outpatient'
attributedefault-checked / defaultChecked
property / JSON attributedefault-value / defaultValue
attributeauto-focus / autoFocus
eventco-progress-noteProgress Note action; default none (React: onProgressNote)
eventco-send-for-certificationSend for Certification action; default none (React: onSendForCertification)