Public Profile

Edit how patients see your clinic: details, specialties, tags, accreditations and credentials.

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

Purpose & Business Context

Public Profile is where the clinic curates the face patients see in the marketplace. A cross-border patient choosing a hospital abroad is buying trust, so this screen lets the clinic shape its name and location, its story, the specialties and capabilities it is known for, and the accreditations and credential documents that prove its quality.

Commercially the profile is the conversion surface of the clinic's marketplace listing. Verified accreditations and a clear about-section are what move a browsing patient to send an inquiry, which is why credentials are uploaded here for Global Clinic to verify.

Screen Overview

A two-column editor. The left column holds Clinic details (name, city, country, about), a Specialties card and a Capability tags card. The right column holds an Accreditations card and a Credential documents list with an upload flow. A footer offers Preview public page and Save changes.

All fields seed from the logged-in clinic (Apollo Hospitals, Chennai), and edits live in local state until Save changes fires a confirmation toast.

Controls & Components

• Clinic details card: text inputs for Clinic name, City and Country, plus an About textarea.
• Specialties card: read-only chips drawn from the clinic's verified procedure list (Cardiac Surgery, Orthopedics, Oncology).
• Capability tags card: removable pill tags (for example Arabic interpreters, Halal kitchen); each has an x to delete it.
• Accreditations card: a Badge per accreditation held, an Add button that opens a picker of accreditations you do not yet hold, and a note that they appear publicly only after verification.
• Credential documents card: a list of certificates and licences, each Verified or pending, with a per-row Upload action and a top Upload button.
• Upload modal: a three-phase tap-to-choose, encrypted upload, then verified flow that marks the next pending document verified.
• Footer: Preview public page and Save changes (which fires a 'Profile saved' toast).

Field Definitions

• Clinic name / City / Country: The clinic's public identity and location, editable text fields.
• About: The free-text description patients read on the public clinic card.
• Specialties: The clinical areas the clinic is known for, resolved from procedure keys to display names; read-only here because they follow the verified procedure list.
• Capability tags: Accommodation and capability highlights (for example interpreters or a halal kitchen) shown to patients; removable.
• Accreditation: A quality credential such as JCI or NABH. Shown on the public card only after Global Clinic verifies the certificate.
• Credential document: A certificate or licence file with a status of Verified or pending; pending items need an upload to verify.

User Actions & Workflows

1. Edit the clinic name, city, country and about text in the details card.
2. Trim capability tags that no longer apply with the x on each pill.
3. Open Add under Accreditations to add a credential you hold, then plan to upload its certificate.
4. Upload pending credential documents via the row Upload button or the top Upload button; watch the encrypted upload and the Verified result.
5. Press Save changes to confirm the edits (a toast confirms), or Preview public page to see the patient view.

Navigation & Relationships

Reached from: the sidebar Profile item and the dashboard's Edit public profile quick link.

Publishes to: the public marketplace clinic card. Profile fields, specialties, tags and verified accreditations are what patients see when browsing.

Relates to: Pricing (the procedure list that drives the specialty chips) and Settings (verification status), since both reflect the same underlying clinic record.

Business Rules & Constraints

• Clinic-only screen; gated by RequireAuth with role "clinic".
• Specialties are not directly editable here; they are derived from the clinic's verified procedure list.
• Accreditations appear on the public card only after Global Clinic verifies the uploaded certificate.
• All edits are local state in the prototype: Save changes confirms with a toast but does not persist to a backend.
• Credential uploads are accepted as PDF, JPG or PNG up to 10 MB (stated in the modal) and are described as encrypted end-to-end.

Data Dependencies

Seeds from myClinic() (name, city, country, blurb, tags, accreditations) and resolves specialty keys with specialtyByKey. The Add picker lists accreditations from lib/data minus those already held. Credential documents are a local seed list, not from the marketplace data.

• myClinic(): the editable profile seed
• specialtyByKey: maps specialty keys to display names
• accreditations: the catalogue the Add picker draws from
• useToast: save and upload confirmations

Error Handling & Edge Cases

• No tags: the tags card shows 'No tags yet.' instead of an empty row.
• All accreditations held: the Add picker shows 'You hold all available accreditations.'
• Upload modal: closing mid-upload via the scrim or X dismisses it; a completed verify persists the document as Verified.
• The upload flow marks the next pending document verified, so repeated uploads clear the pending queue in order.
• Mobile: the two columns stack and the cards remain full width.

User Roles & Permissions

• Clinic admin: Full control of the public profile: edit details, manage tags, add accreditations, upload credentials and save.
• Clinic staff: Can view and, in this prototype, edit the same fields. In production, profile and credential changes are typically an admin responsibility because they affect the public listing and verification.
• Patient / other roles: No access to the editor; patients only ever see the published public card.

Related Features & Functionalities

The public marketplace clinic card (the published output), the Pricing screen (whose verified procedures drive specialties), the Settings verification status, and the Onboarding wizard, which collects this same profile, accreditation and document information when a clinic first joins.

Flow & Screenshots

flowchart LR
  Profile[Public Profile] --> Details[Clinic details]
  Profile --> Specs[Specialties]
  Profile --> Tags[Capability tags]
  Profile --> Accred[Accreditations]
  Accred -->|Add| Pick[Accreditation picker]
  Profile --> Docs[Credential documents]
  Docs -->|Upload| Modal[Upload + verify]
  Profile -->|Save changes| Public[Public clinic card]

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. Public Profile ([data-tour="nav.profile"])

Curate how patients see your clinic in the marketplace. You are on the Profile tab now.

1. Clinic details ([data-tour="profile.details"])

Your name, location and the about text patients read first. Edit them here and they update your public card on save.

1. Specialties ([data-tour="profile.specialties"])

The areas you are known for. These follow your verified procedure list, so manage them on the Pricing screen.

1. Accreditations ([data-tour="profile.accreditations"])

Your quality credentials. Add one with the Add button; it appears publicly once Global Clinic verifies the certificate.

1. Credential documents ([data-tour="profile.documents"])

Upload certificates and licences for verification. Pending items show an Upload button; the flow is encrypted end to end.

1. Save your changes ([data-tour="profile.save"])

When everything looks right, save. Use Preview public page to see exactly what patients will see.