Plan: quote to travel
The Plan phase covers stages 4 to 7 of the 14-stage journey: Treatment Quote, Deposit and Escrow, Visa and Invitation, and Travel and Stay. These journeys describe how a patient who has accepted a quote gets funded, documented and routed for travel. The escrow and refund mechanics behind stage 5 are operational rules and live in Payment and refund processes.
Patient: in-portal journey to treatment [Live]
Once a case is funded, this is how the patient works the rest of the journey from inside the portal. From the dashboard they move through the visa checklist, the document wallet, travel and stay selection, their care plan, and messaging with the coordinator, and each screen's progress feeds the next.
flowchart LR J[Journey dashboard] --> VISA[Visa: complete checklist] VISA --> DOCS[Documents: upload to verify] DOCS --> VISA VISA --> TRV[Travel & Stay: select options] TRV --> CARE[Care Plan: review phases] CARE --> MSG[Messages: coordinator] J --> NOTE[Notifications]
The signature interaction: a pending visa checklist item links to a specific document. The patient taps Upload, lands in the Documents wallet, uploads the file, and on return the checklist item reads Verified and the Submit application gate moves closer to unlocking. This cross-screen state persists across navigation.
Visa assistance [Live]
The flagship journey, and the product's single biggest trust lever: a corridor-aware engine that tells the patient exactly which documents their visa needs and then tracks the application all the way to grant. The patient completes a checklist whose items are satisfied by verified documents in the wallet, and the Submit application gate unlocks only when every item clears. Built today as an illustrative engine; the corridor rules engine is Planned.
flowchart TD
A[Open Visa screen] --> B[See corridor-specific checklist]
B --> C{Item linked to a document?}
C -- Yes --> D[Status derived from document verification]
C -- No --> E[Static requirement]
D --> F[Upload pending documents in wallet]
F --> G[Document verified -> checklist item done]
G --> H{All items verified?}
H -- No --> B
H -- Yes --> I[Submit application enabled]
I --> J[Invitation letter generated]
J --> K[Application submitted to government / ops]
K --> L[Timeline tracks to e-Visa granted]Visa rules:
- Required documents, fee, processing window, validity and paper-vs-e-Visa routing come from the corridor Country Pack.
- Submit application unlocks only when every checklist item is verified.
- The e-Medical Attendant visa covers up to two accompanying family members.
- Where a government API is unavailable, a manual operations fallback drives the application; the patient still sees a single status and timeline.
Travel and accommodation booking [Live]
How a patient assembles their trip without ever transacting travel directly. They set their trip parameters, browse flights, attendant-friendly stays and transfers, select the options they prefer, and submit them to the Travel Desk, which confirms the bookings with providers and adds the itinerary to the Journey concierge card.
flowchart LR A[Trip parameters: corridor, dates, travellers] --> B[Browse flights] B --> C[Browse stays: attendant bed, halal kitchen] C --> D[Browse transfers + add-ons] D --> E[Select preferred options] E --> F[Submit to Travel Desk] F --> G[Travel Desk confirms via providers] G --> H[Itinerary added to Journey concierge card]
Travel rules:
- The patient selects preferences; the Travel Desk confirms bookings. The patient does not transact travel directly. This mirrors the escrow and coordinator-routed posture of the rest of the product.
- All travel prices are indicative, never a guaranteed quote.
- Accommodation is filtered for attendant-friendly and culturally appropriate options (for example an attendant bed, a halal kitchen, proximity to the treating hospital).
WF-5 Visa, attendants and FRRO [Planned]
Status: Planned (implementation workstream WS6). Extends the flagship visa engine with attendant flows, multi-corridor activation, and post-arrival immigration. Screen references (U4, N8, N12, N14) point to docs/implementation/01-screen-specs.md.
Personas. Patient, Attendant(s), Visa-ops, Admin (Country Pack).
Primary path.
- Visa (U4) resolves the visa type from the Country Pack (medical / medical-attendant / e-AYUSH / e-AYUSH-attendant).
- Patient adds up to two blood-relative attendants; each gets a co-terminus application + checklist.
- Checklist completes via verified documents (existing signature flow); submit when all resolve.
- On grant, the engine surfaces FRRO (N8): a 14-day registration countdown to the city's FRRO office; documents; status.
- For prolonged treatment, the patient requests a visa extension (hospital justification letter required); Visa-ops assists (N12).
flowchart LR VT[Visa type from Country Pack U4] --> AT[Add attendants <=2] AT --> CL[Checklists via verified docs] CL --> SUB[Submit when complete] SUB --> GR[Granted] GR --> FRRO[FRRO register <=14d N8] FRRO --> EXT[Visa extension if prolonged]
The post-arrival FRRO steps belong to the Treat phase; see FRRO registration (post-arrival).
Alternate paths. Solo patient (no attendants); corridor uses a paper visa (routing from Country Pack); AYUSH case uses the AYUSH visa.
Exception paths. FRRO deadline approaching or passed, amber/rose alert plus coordinator escalation; extension rejected, Visa-ops advises; corridor inactive, Admin activates via the Country-Pack editor (N14) before the patient can proceed.
Impact on existing flows. The visa engine gains type plus attendants; corridors become config-driven and activatable; the Journey surfaces FRRO and extension stages.
WF-6 Travel, airport and pre-travel guidance [Planned]
Status: Planned (implementation workstream WS7). Deepens the travel half of the journey with airport facilitation, packages and a guidance pack. Screen references (U5, N7) point to docs/implementation/01-screen-specs.md.
Personas. Patient, Travel Desk.
Primary path. Travel & Stay (U5): pick a package or assemble flight plus stay plus transfer; add airport facilitation (meet-greet, lounge, immigration assist); see connectivity for the corridor. Pre-travel guidance (N7) presents the "Know before you go" checklist (vaccinations, documents, currency, SIM, culture). The Travel Desk confirms bookings.
Alternate paths. Bundle via a Package (one-click); add recovery-window experiences (only recoverySafe during early recovery); guidance items deep-link to Documents, FRRO, or Insurance.
Exception paths. No direct flights (1-stop routing shown); experience flagged unsafe for recovery is hidden or greyed; guidance vaccination content always links to official sources (advisory only).
Impact on existing flows. Travel & Stay and Destinations gain new sections; concierge and journey reflect airport services.