Procedures & Pricing

Manage the indicative prices that appear in the marketplace, benchmarked against the reference.

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

Purpose & Business Context

Procedures & Pricing is where the clinic sets the indicative 'from' prices that power its marketplace listing and comparisons. Price is one of the strongest reasons a patient travels abroad, so the screen lets the clinic list the procedures it offers, set a price for each, and see instantly how that price compares to the marketplace reference.

Commercially it is the competitiveness surface. The savings-vs-reference badge tells the clinic at a glance whether each price is attractive, and the disclaimer keeps prices honestly framed as indicative estimates, never a guaranteed quote.

Screen Overview

A single table card lists each procedure as a row with the procedure name and specialty, an editable price input, the typical stay, and the marketplace reference price with a savings badge. A header shows the count of listed procedures and an Add procedure button. A disclaimer line and a Publish prices button sit below.

Rows seed from the clinic's current procedure list (for Apollo: CABG, Heart Valve, Knee Replacement and an Oncology package). Editing a price recalculates its savings badge live.

Controls & Components

• Listed-count header: '<n> listed procedures' plus an Add procedure button (disabled when every procedure is already listed).
• Column headers: Procedure, Your price (USD), Stay, Marketplace ref. and an actions column.
• Procedure rows: the procedure name and specialty, a numeric price input prefixed with $, the typical stay, the reference price and a savings Badge.
• Savings badge: green '<n>% under ref.' when your price beats the reference, or amber '<n>% over ref.' when it exceeds it.
• Remove (trash) button: deletes a row from the list (with a toast).
• Add-procedure picker: a modal of procedures not yet listed, each showing the marketplace reference and stay; picking one adds a pre-filled row.
• Disclaimer + Publish prices: a note that prices are indicative 'from' estimates, and a Publish prices button that fires a toast.

Field Definitions

• Procedure: The treatment being priced, resolved from its key to a display name and parent specialty (for example Coronary Artery Bypass under Cardiac Surgery).
• Your price (USD): The clinic's indicative all-in 'from' price for this procedure, edited inline.
• Stay: The typical hospital stay for the procedure, for example '5 nights'.
• Marketplace ref.: The reference 'from' price for the procedure across the marketplace, used as the benchmark.
• Savings vs reference: How far your price sits under (green) or over (amber) the marketplace reference, as a percentage.

User Actions & Workflows

1. Review the listed procedures and their current prices against the marketplace reference.
2. Edit a price in the input; the savings badge updates instantly to show under or over reference.
3. Remove a procedure you no longer offer with the trash button.
4. Press Add procedure and pick from the modal to list a new procedure with a pre-filled reference price.
5. Press Publish prices to push your indicative prices live (a toast confirms).

Navigation & Relationships

Reached from: the sidebar Pricing item and the dashboard's Update pricing quick link.

Publishes to: the public marketplace, where these indicative prices appear on the clinic card and in price comparisons.

Drives: the Profile screen's specialty chips (specialties follow the verified procedure list) and informs the quotes a clinic sends from the Inquiries inbox.

Business Rules & Constraints

• Clinic-only screen; gated by RequireAuth with role "clinic".
• Prices are explicitly indicative 'from' estimates; patients always receive an itemised quote before booking.
• Add procedure is disabled once every available procedure is already listed.
• Savings is computed against the procedure's marketplace reference; a price above reference shows an amber 'over ref.' badge.
• All edits live in local state in the prototype: Publish prices confirms with a toast but does not persist to a backend.

Data Dependencies

Seeds rows from myClinic().procedures, resolves each with procedureByKey for name, specialty and reference price, and computes the badge with savingsPct. The Add picker lists procedures from lib/data minus those already listed.

• myClinic().procedures: the seeded price list
• procedureByKey: procedure name, specialty and reference price
• savingsPct(reference, yourPrice): the under/over-reference percentage
• procedures: the catalogue the Add picker draws from

Error Handling & Edge Cases

• Empty list: with no procedures the table shows 'No procedures listed yet. Add one to appear in the marketplace.'
• No reference: if a procedure has no marketplace reference the ref cell shows a dash and no savings badge.
• Price above reference: the badge flips to amber and reports the percentage over reference rather than hiding it.
• Closing the Add modal via the scrim or X cancels without adding a row.
• Mobile: the table grid reflows so each row's cells stack readably.

User Roles & Permissions

• Clinic admin: Full pricing control: add, edit and remove procedures and publish prices.
• Clinic staff: Can view and, in this prototype, edit prices. Because pricing is commercially sensitive, in production it is usually an admin-only responsibility.
• Patient / other roles: No access to the editor; patients only ever see the published indicative prices on the public card.

Related Features & Functionalities

The public marketplace card and price comparisons (the published output), the Profile screen (whose specialties follow this procedure list), the Inquiries inbox (where quotes are built from these prices) and the Onboarding wizard, which collects an initial procedure-and-price list.

Flow & Screenshots

flowchart LR
  Pricing[Procedures & Pricing] --> Table[Procedure table]
  Table -->|edit price| Savings[Savings vs reference]
  Table -->|Add procedure| Pick[Procedure picker]
  Pick --> Table
  Table -->|trash| Remove[Row removed]
  Pricing -->|Publish prices| Market[Marketplace listing]

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. Procedures & Pricing ([data-tour="nav.pricing"])

Set the indicative prices that power your marketplace listing. You are on the Pricing tab now.

1. Your price list ([data-tour="pricing.table"])

Each row is a procedure with an editable price, the typical stay and the marketplace reference. Edit a price and the savings badge updates live.

1. Add a procedure ([data-tour="pricing.add"])

List a new procedure from the picker. It comes pre-filled with the marketplace reference price so you can adjust from there.

1. Publish your prices ([data-tour="pricing.publish"])

When your prices are ready, publish them. Remember they are indicative 'from' estimates; patients always get an itemised quote.

1. Prices shape your profile ([data-tour="nav.profile"])

Your verified procedures here drive the specialties shown on your public profile.

1. Help is always here ([data-tour="topbar.help"])

Open Help on any console screen for documentation, or press Play to replay this walkthrough.