Care plans
Assign home programmes with exercises, diet instructions, speech drills, oral hygiene, medication routines, general instructions and reusable templates.
Who can do this: careplan.read views plans and templates; careplan.manage assigns, edits, completes, deletes and manages templates.
Where: care plans (/app/care-plans?patientId=:patientId&patientName=:name), templates (/app/care-plans/templates), portal (/patient/care-plan). Legacy /app/home-exercises and /patient/exercises use the same feature.

Before you start
- Open the patient first so
patientIdis present. - Prepare instructions and approved HTTPS media links.
- Use templates for common programmes.
Open a patient's care plans
- Open the patient and choose the care-plan action.
Result:
/app/care-plans?patientId=...opens. - If No patient selected appears, click Go to Patients. Result: You return to the patient list.
- Review existing cards. Result: Current and completed plans are visible.
Assign a care plan
- Click Assign new. Result: New: Care plan opens.
- Enter Title, Goals (one per line), Start date and optional End date. Result: Plan basics are ready.
- Add at least one activity with Type, Name, instructions, frequency, duration, sets, repetitions or media link. Result: The patient has actionable tasks.
- Add Notes for patient / family. Result: Precautions and motivation are included.
- Click Assign. Result: Assigned appears and the plan card is listed.
Start from a template
- Click Assign new. Result: Start from a template appears when templates exist.
- Choose a template and click Add activities. Result: Activities and goals are copied into the draft.
- Edit for the patient. Result: The plan is personalised.
- Click Assign. Result: The plan is saved.
Edit, complete or delete
- Click Edit on a card. Result: Edit: Care plan opens.
- Change fields and click Save changes. Result: Updated appears.
- Click Mark complete. Result: Marked as completed appears.
- Click Delete and confirm Delete this plan? only for mistakes. Result: The plan is deleted.
Manage templates
- Open Care plan templates. Result: Built-in and tenant templates appear.
- Filter by Specialty or All specialties. Result: The list narrows.
- Click New template. Result: Template form opens.
- Enter name, specialty, description, goals and activities. Result: A reusable activity set is ready.
- Click Save template. Result: Template saved appears.
- Click Save a copy on a built-in template to adapt it. Result: A tenant copy opens.
Patient portal
- Ask the patient to open
/patient/care-plan. Result: My care plan appears. - The patient reviews assigned plans, activities, notes and tips. Result: The family can follow the home programme.
- The patient opens media links. Result: Approved links are available; unapproved links are hidden.

Troubleshooting
| Problem / message | What it means | What to do |
|---|---|---|
| ?No patient selected? | Missing patientId. | Open the plan from a patient record. |
| ?Could not load: Care plan? | Load request failed. | Click Try again. |
VALIDATION_FAILED | Server rejected fields. | Fix highlighted title, dates or activities. |
| ?Add at least one activity with a name.? | No named activity. | Add activity name. |
VERSION_CONFLICT / ?Someone else changed this plan. The latest version has been loaded.? | Another user saved first. | Review latest and edit again. |
| ?Link hidden: not from an approved host.? | Media URL is not approved. | Use an approved HTTPS host. |
| ?You can view templates but not change them.? | Missing careplan.manage. | Ask a permitted user. |
| ?Could not load templates.? | Template request failed. | Retry or assign without template. |
| ?We could not load your care plan right now.? | Portal failed. | Ask patient to retry later. |