Find Care

Browse, compare and match vetted clinics, then ask your coordinator to switch.

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

Purpose & Business Context

Find Care brings the public marketplace inside the signed-in app so a patient who has already chosen a clinic can still explore vetted alternatives with confidence. It exists for the patient who wants a second look, a lower price, or a different destination before committing further.

Commercially it keeps comparison shopping on-platform rather than off to a search engine. Because the card call to action routes to the coordinator rather than a cold quote form, every comparison becomes a warm conversation the platform can shape, protecting the relationship even when the patient is reconsidering.

Screen Overview

A reassurance banner at the top names your current choice (Apollo Hospitals, Chennai) and invites you to compare up to three alternatives. Below it sits the full marketplace engine, the same one the public /clinics page uses: a Find your match wizard, a filter toolbar, a results count, a responsive grid of clinic cards, and a sticky compare bar once you select clinics.

Selecting two or three clinics and pressing Compare opens a side-by-side comparison table covering rating, accreditations, price, savings, lead time and more.

Controls & Components

• Current-choice banner: a teal strip confirming your chosen clinic and the compare-then-switch flow.
• Find your match wizard: three quick selects (Treatment area, Destination, Budget) plus a Find matches button that pre-fills the filters below.
• Filter toolbar: free-text search, plus Specialty, Destination, Accreditation, Maximum price and Sort dropdowns.
• Results count: '<n> clinics · select up to 3 to compare'.
• Clinic cards: each shows the clinic name, location, verified-review stars, accreditation badges, specialties, an indicative 'From' price with savings percent, lead time, a Compare toggle and an Ask coordinator button.
• Compare bar: appears when one or more clinics are selected; shows pills, a Clear action and a Compare <n> button (enabled at two or more).
• Compare table: the modal that opens from Compare; closes by clicking the scrim or the X.

Field Definitions

• Treatment area / Specialty: The clinical specialty filter (e.g. Cardiac Surgery). The wizard's Treatment area applies the same Specialty filter on the toolbar.
• Destination: The country a clinic is in. Options are the distinct countries present in the vetted network, sorted alphabetically.
• Accreditation: Quality credential a clinic holds, e.g. JCI, NABH or ISO 9001. ISO badges are toned teal, others blue.
• Maximum price / Budget: An upper bound on a clinic's indicative 'From' price. Buckets are Any, under $2,000, $5,000, $10,000 and $20,000.
• Sort: Ordering of results: Top rated (default), Lowest price, Biggest savings, or Most reviewed.
• From (price): The clinic's indicative starting price in USD. Always indicative, never a guaranteed quote.
• Savings %: Approximate saving versus the clinic's reference home market, shown next to the price with a down-trend arrow.
• Lead time: The clinic's indicative wait before treatment can begin.
• Verified reviews: Blended star rating and total count, aggregated from verified-transaction sources (Trustpilot, Google).

User Actions & Workflows

1. Optionally use Find your match: pick a treatment area, destination and budget, then press Find matches to pre-fill the filters.
2. Refine using the toolbar: type a clinic, city or specialty, or adjust the Specialty, Destination, Accreditation, Maximum price and Sort dropdowns.
3. Press Compare on a card to add it to your selection (the button reads Added once selected). You can select up to three.
4. When two or three are selected, press Compare <n> in the sticky bar to open the side-by-side table.
5. Read the comparison, then close it and press Ask coordinator on your preferred clinic to start a switch conversation in Messages.

Navigation & Relationships

Reached from: the sidebar Find item, and from 'Compare alternatives' / 'Compare other clinics' links on the Care Plan and Payments screens.

Leads to: Messages (/portal/messages) via every card's Ask coordinator button, so a comparison can become a request to switch.

Shares its engine with: the public marketplace at /clinics. The portal variant differs only in the banner and the coordinator-routed call to action; filter, compare and match behaviour are identical.

Business Rules & Constraints

• Comparison is capped at three clinics; selecting a fourth is ignored until you remove one.
• The Compare button is disabled until at least two clinics are selected.
• All clinics shown are vetted partners; prices and savings are indicative and never a guaranteed quote.
• Filters combine with AND logic; an empty result set shows guidance to widen destination or budget.
• Patient-only screen, gated by the portal's patient role; the card action routes to the coordinator rather than booking directly.

Data Dependencies

Driven by the marketplace data in lib/data: clinics, specialties, clinicCountries, plus chosenClinic() for the banner. The card and table read each clinic's reviews, accreditations, pricing and savings fields from the Clinic schema.

• clinics: the vetted clinic catalogue
• specialties: specialty filter options
• clinicCountries: destination filter options
• chosenClinic(): your current selection for the banner

Error Handling & Edge Cases

• No matches: the grid is replaced by 'No clinics match those filters yet. Try widening your destination or budget.'
• Over-selection: attempting a fourth comparison clinic is silently capped at three.
• Compare disabled: with fewer than two selected, the Compare button is greyed and not clickable.
• Closing the comparison: clicking the dark scrim or the X dismisses the modal without losing your selection.
• Mobile: the toolbar dropdowns and the card grid reflow to a single column; the compare bar stays reachable at the bottom.

User Roles & Permissions

• Patient: Full access: search, filter, match, compare, and start an 'Ask coordinator' conversation about switching.
• Clinic / other roles: No access to the portal variant. Clinics manage their own marketplace presence from the clinic console.

Related Features & Functionalities

The public marketplace /clinics, the Care Plan's 'Your hospital' card (which links here), the Payments 'Your savings' comparison, and Messages (where switch requests land). The compare table mirrors the public comparison experience.

Flow & Screenshots

flowchart LR
  Find[Find Care] --> Match[Find your match]
  Match --> Filters[Filter toolbar]
  Find --> Filters
  Filters --> Cards[Clinic cards]
  Cards -->|Compare| Bar[Compare bar]
  Bar -->|Compare 2-3| Table[Comparison table]
  Cards -->|Ask coordinator| Msg[Messages]

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. Find Care ([data-tour="nav.find"])

Explore vetted clinics beyond your current choice. You are on the Find tab now.

1. Your current choice ([data-tour="find.banner"])

This banner confirms the clinic you have already chosen. Everything below lets you compare alternatives before deciding to switch.

1. Find your match ([data-tour="find.match"])

Tell us your treatment area, destination and budget, then press Find matches to instantly pre-fill the filters with best-fit clinics.

1. Search and filter ([data-tour="find.toolbar"])

Fine-tune with free-text search plus specialty, destination, accreditation, price and sort. Filters combine to narrow the list.

1. Pick up to three ([data-tour="find.results"])

Each card shows verified reviews, accreditations, an indicative price and savings. Press Compare on a card to add it; you can compare up to three.

1. Ask to switch ([data-tour="nav.msg"])

Found a better fit? The Ask coordinator button on any card opens Messages so your coordinator can arrange the switch.