Travel & Stay

Plan flights, accommodation, transfers and concierge add-ons; the Travel Desk confirms.

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

Purpose & Business Context

Travel & Stay is where the logistics of a cross-border treatment become a concrete, bookable plan: flights for the patient and their attendant, a place to stay near the hospital, airport transfers, and the concierge add-ons that make a foreign hospital stay manageable (interpreter, companion care, halal meals). It exists so the patient never has to assemble this alone across airline sites, hotel apps and local taxi firms, in a city and language they do not know.

Commercially this is the Travel Desk's surface, the §7.6 logistics and §7.7 in-country layer made real. Keeping flights and accommodation on-platform protects that margin, and because nothing is charged here, the barrier to commit is low: the patient expresses a preference and a human confirms it, which converts far better than a cold booking form.

Screen Overview

A trip hero summarises the corridor, dates, travellers and nights, with a status that moves from Planning to Sent to Travel Desk. Below it, a two-column layout: the left column holds four choice cards (Flights, Where you will stay, Airport transfer, Concierge add-ons); the right column holds a sticky Your itinerary summary with a running indicative total and the Send to Travel Desk action, plus a Travel documents card.

For the demo patient this is Muscat to Chennai, 10 to 28 Jun, two travellers (Yusuf and his attendant Fatima), planned around the 12 Jun surgery date.

Controls & Components

• Trip hero: corridor, travel dates, travellers, nights and surgery date, with a status badge (Planning or Sent to Travel Desk).
• Flights card: a single-select list of flight options, each showing airline, flight number, times, duration, stops, cabin and an indicative round-trip fare per traveller; the Travel Desk's pick carries a Recommended badge.
• Accommodation card: a single-select list of stays near the hospital, each with distance, kind, rating, nightly rate, tags, and the computed nightly-times-nights total.
• Airport transfer card: a single-select list of ground-transport options (private car with Arabic-speaking driver, wheelchair-accessible van, or self-arranged).
• Concierge add-ons card: toggles for extras such as an Arabic interpreter, companion care, a local SIM, wheelchair assistance, a halal meal plan and held recovery nights; Included items cost nothing.
• Your itinerary summary: a running cart of the four sections with an indicative total, a Send to Travel Desk button, and (once sent) a confirmation, a Message Travel Desk button and an Edit my request link.
• Travel documents card: the Travel-type documents (such as travel insurance) with their status and an Upload shortcut to the Documents wallet.
• InfoTips: the small question-mark markers beside headings and fields open short, in-place explanations.

Field Definitions

• Travellers: The patient plus accompanying attendants (up to two blood relatives). Fares and rooms are sized for this count.
• Nights: Total nights of accommodation across the stay (here 18), covering the pre-op days, the procedure and recovery.
• Indicative fare / rate: A guide price, never a guaranteed quote. Flights are round-trip per traveller; stays are per night.
• Recommended: The option the Travel Desk suggests for this corridor, for example a direct flight with Arabic cabin crew, or the on-campus guest suite.
• Included add-on: An extra already covered by the care package (interpreter, companion care); it adds nothing to the total.
• Indicative total: The sum of the selected flights, stay, transfer and priced add-ons. An estimate for comparison, not a charge.
• Status: Planning while you choose; Sent to Travel Desk once you submit the request.

User Actions & Workflows

1. Review the trip hero to confirm the corridor, dates and who is travelling.
2. Pick a flight; the Recommended option is preselected, and the itinerary updates as you change it.
3. Choose where to stay; each option shows the nightly-times-nights total.
4. Select an airport transfer, then toggle the concierge add-ons you want (Included ones are free).
5. Check the indicative total in Your itinerary, then press Send to Travel Desk.
6. After sending, message the Travel Desk with any notes, or use Edit my request to change a selection.

Navigation & Relationships

Reached from: the sidebar Travel & Stay item, the Journey Concierge & stay card, and the Travel stage in the journey stage drawer.

Leads to: Messages (/portal/messages) via Message Travel Desk, and the Documents wallet (/portal/docs) from the Travel documents card.

Follows: the Visa screen (/portal/visa). The same corridor that sets your visa rules also frames these flights, stay and transfers, which is why Travel sits right after Visa in the journey.

Feeds: the Journey dashboard, whose Concierge & stay card mirrors your current selections and request status because the booking lives in shared portal state.

Business Rules & Constraints

• Nothing is charged on this screen. Send to Travel Desk submits a request; the desk confirms availability and final price, and eligible costs settle through escrow.
• Flights, stay and transfer are single-select; add-ons are multi-select.
• Prices are indicative and never a guaranteed quote.
• Included add-ons (interpreter, companion care) are part of the care package and never change the total.
• Travel insurance must be on file before the desk can ticket flights; the Travel documents card surfaces it.
• Patient-only screen within the portal; the Travel Desk acts on the request server-side.

Data Dependencies

Reads the trip parameters and option catalogues from lib/data (trip, flightOptions, stayOptions, transferOptions, travelAddons), and the live selections plus request flag from PortalProvider. The Travel documents card reads the shared docs state, so uploading travel insurance on the Documents screen updates it here.

• trip: corridor, dates, travellers, nights
• flightOptions / stayOptions / transferOptions / travelAddons: the choosable options
• travelFlight / travelStay / travelTransfer / travelAddons (PortalProvider): your selections
• travelRequested (PortalProvider): flips the hero, the summary and the Journey badge

Error Handling & Edge Cases

• Sending shows a success toast and replaces the button with a confirmation; Edit my request reopens it for changes.
• Self-arranged transfer shows No cost and contributes nothing to the total.
• Add-ons priced per day or per airport are multiplied accordingly; Included and pay-only-if-used items count as zero.
• If travel insurance is still pending, the Travel documents card shows an amber count and an Upload shortcut rather than blocking the screen.
• Mobile: the two columns stack, so the choices come first and the itinerary summary follows.

User Roles & Permissions

• Patient: Can choose flights, stay, transfer and add-ons, see the indicative total, and send the request to the Travel Desk.
• Travel Desk (out of scope here): Confirms availability, then books and prices the trip server-side; the patient sees the status move to Sent to Travel Desk and follows up in Messages.

Related Features & Functionalities

The Visa screen (the corridor this trip rides on), the Journey Concierge & stay card (a mirror of these selections), the Documents wallet (travel insurance), Payments & Escrow (where confirmed travel costs settle), and the Messages Travel Desk thread. The Travel stage in the journey strip opens this screen.

Flow & Screenshots

flowchart LR
  Travel[Travel & Stay] --> Flights[Choose flights]
  Travel --> Stay[Choose accommodation]
  Travel --> Transfer[Airport transfer]
  Travel --> Addons[Concierge add-ons]
  Flights --> Cart[Your itinerary]
  Stay --> Cart
  Transfer --> Cart
  Addons --> Cart
  Cart -->|Send to Travel Desk| Sent[Request sent]
  Sent -->|Message Travel Desk| Msg[Messages]
  Travel -->|travel insurance| Docs[Documents wallet]

Guided Walkthrough Steps

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

1. Travel & Stay ([data-tour="nav.travel"])

Plan your flights, accommodation, transfers and concierge add-ons in one place. You are on the Travel tab now.

1. Your trip at a glance ([data-tour="travel.hero"])

Your corridor, dates, travellers and nights, built around your surgery date. The badge shows whether your plan is still Planning or already Sent to the Travel Desk.

1. Choose your flights ([data-tour="travel.flights"])

Pick from options for your corridor; the Recommended one is preselected. Fares are indicative round-trip per traveller and are not booked until you send the request.

1. Where you will stay ([data-tour="travel.stay"])

Compare stays near the hospital by distance, rating and nightly rate. The on-campus guest suite keeps you within walking distance.

1. Concierge add-ons ([data-tour="travel.addons"])

Toggle extras like an Arabic interpreter or companion care. Items marked Included are part of your care package and cost nothing.

1. Your itinerary ([data-tour="travel.summary"])

A running estimate of your choices. It is for comparison only, not a charge; the Travel Desk confirms the final price.

1. Send to the Travel Desk ([data-tour="travel.submit"])

When you are happy, send your request. Nothing is charged now: the desk confirms your flights and stay, usually within 24 hours.