Care Plan

Your surgeon, treatment plan, teleconsult, vitals and hospital in one place.

<!-- GENERATED FILE. Do not edit by hand. Source: components/help/content/. Run npm run gen:docs. -->

Purpose & Business Context

The Care Plan is the clinical heart of the patient app. It answers the questions that matter most before travelling for surgery: who is operating on me, what happens and when, when is my next consult, and is my hospital trustworthy. Seeing a named surgeon, a phased plan and an upcoming teleconsult turns an abstract booking into a concrete, human plan of care.

Commercially, surfacing the surgeon's credentials and the vetted hospital reinforces trust at the highest-stakes moment, and the teleconsult is the touchpoint that keeps the patient engaged between booking and travel.

Screen Overview

A two-column layout. The left column holds the Surgeon card and the phased treatment plan. The right column holds the Upcoming teleconsult hero, Latest vitals, and the Your hospital card.

For the demo patient (Yusuf Al-Rashid, CABG at Apollo Chennai), the plan runs across Pre-op, Procedure and Recovery phases, with the current item highlighted.

Controls & Components

• Surgeon card: Dr. Anand Menon's name, title and experience, credential badges, a Join teleconsult button and a Message button.
• Treatment plan card: phases (Pre-op, Procedure, Recovery) with status dots; the active item carries a 'Now' badge.
• Upcoming teleconsult hero: the next call's title, date, time and interpreter, with Join call and Reschedule buttons.
• Latest vitals card: a grid of self-reported readings with a 'Self-reported · 2 days ago' note.
• Your hospital card: the vetted hospital with rating, accreditations and tags, plus a Compare alternatives link to Find Care.

Field Definitions

• Surgeon: The operating surgeon (Dr. Anand Menon, Sr. Cardiothoracic Surgeon, 22 yrs) with volume and rating badges.
• Treatment plan item: A step in the care pathway with a status: done (filled dot with check), active (amber ring, 'Now' badge) or upcoming (muted).
• Upcoming teleconsult: The next scheduled video review, e.g. Pre-op review with Dr. Menon, Thu 5 Jun, 4:00 PM (GST), with an Arabic interpreter.
• Vitals: Self-reported readings: Blood pressure (mmHg), Resting HR (bpm), SpO2 (%) and Weight (kg).
• Your hospital: The chosen vetted facility (Apollo Hospitals, Chennai) with verified rating, accreditations and capability tags.

User Actions & Workflows

1. Review your surgeon's credentials on the Surgeon card.
2. Read the treatment plan top to bottom; the 'Now' badge marks the step you are currently on.
3. Join the upcoming teleconsult with Join call (or Join teleconsult), or request a change with Reschedule.
4. Message your care team from the Surgeon card's Message button if you have questions.
5. Check your latest vitals, and use Compare alternatives on the hospital card if you want to reconsider the facility.

Navigation & Relationships

Reached from: the sidebar Care item, the Journey 'Surgery date' tile, and the Account 'View care plan' link.

Leads to: Messages (/portal/messages) from the surgeon's Message button, and Find Care (/portal/clinics) from the hospital card's Compare alternatives link.

Mirrored by: the Journey dashboard, whose surgery-date tile summarises this screen's procedure date and surgeon.

Business Rules & Constraints

• Patient-only screen within the portal.
• The plan and vitals are read-only here; clinical updates flow from the care team, not from patient edits.
• Vitals are explicitly labelled self-reported with a recency stamp, so they are never mistaken for clinically verified measurements.
• Join teleconsult opens at the scheduled time; outside that window the action shows an informational message.
• Reschedule sends a request to the coordinator rather than changing the calendar directly.

Data Dependencies

Reads patient (surgeon, name), carePlan (phases and items), vitals (readings) and chosenClinic() (the hospital card) from lib/data. The teleconsult details are presentational in the prototype.

• patient.surgeon: the operating surgeon
• carePlan: phased plan with statuses
• vitals: self-reported readings
• chosenClinic(): the vetted hospital

Error Handling & Edge Cases

• Join teleconsult before the scheduled time surfaces a toast ('Your teleconsult opens at the scheduled time') rather than failing.
• Reschedule and Join call confirm with a toast so the patient gets feedback even though this is a prototype.
• Upcoming items render muted and non-actionable until they become active.
• Mobile: the two columns stack vertically so the surgeon and teleconsult remain prominent.

User Roles & Permissions

• Patient: Can view the plan, join or request to reschedule the teleconsult, message the team, and view the hospital. Cannot edit the clinical plan.
• Care team (out of scope here): Updates the plan, vitals and consults from clinic-side tools; the patient sees the result.

Related Features & Functionalities

Messages (coordinator and care-team chat), Find Care (compare hospitals), the Journey surgery-date tile, and the Documents wallet, where medical opinions and estimates live. The teleconsult ties into the broader telehealth touchpoints.

Flow & Screenshots

flowchart LR
  Care[Care Plan] --> Surgeon[Surgeon card]
  Care --> Plan[Treatment plan]
  Care --> Consult[Teleconsult]
  Consult -->|Join call| Video[Teleconsult call]
  Consult -->|Reschedule| Coord[Coordinator request]
  Surgeon -->|Message| Msg[Messages]
  Care -->|Compare alternatives| Find[Find Care]

Guided Walkthrough Steps

The in-app walkthrough for this screen has 6 steps (auto-advances every 5 seconds; Prev / Pause / Next; click outside to exit):

1. Care Plan ([data-tour="nav.care"])

Everything clinical about your treatment lives here. You are on the Care tab now.

1. Your surgeon ([data-tour="care.surgeon"])

Meet the surgeon leading your case, with their experience and credentials. Join a teleconsult or message the team straight from here.

1. Your treatment plan ([data-tour="care.plan"])

Your care broken into phases, from pre-op to recovery. The step marked Now is where you currently are.

1. Upcoming teleconsult ([data-tour="care.consult"])

Your next video review, with the date, time and interpreter. Join the call, or request a different time with Reschedule.

1. Latest vitals ([data-tour="care.vitals"])

Your most recent self-reported readings. The note shows these are self-reported and when they were last updated.

1. Your hospital ([data-tour="care.hospital"])

Your vetted facility with its rating and accreditations. Use Compare alternatives if you ever want to reconsider.