> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prvaha.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating and Managing Patient Records in Prvaha

> Learn how to create, search, and update patient profiles in Prvaha, including personal details, vitals, appointment history, and linked family members.

Patient records are the foundation of care in Prvaha. Every patient in your clinic has a dedicated profile that brings together their personal information, appointment history, and vitals in one place. As a doctor, nurse, or administrator, you can access and update any patient record from the **Patients** section of the dashboard sidebar.

## Finding a patient

Use the search bar at the top of the **Patients** list to locate any existing record quickly. You can search by:

* **Full name or partial name** — for example, "Amara" will match "Amara Osei"
* **Phone number** — type the patient's mobile number to surface their record instantly

The results list updates in real time as you type. Click any result row to open the full patient profile.

## Creating a new patient

<Steps>
  <Step title="Open the New Patient form">
    In the sidebar, navigate to **Patients**, then click **New** (or the **+** button) in the top-right corner of the patients list.
  </Step>

  <Step title="Fill in the required fields">
    Complete at minimum the patient's **Name**. You can also fill in the following fields at registration:

    | Field             | Notes                                |
    | ----------------- | ------------------------------------ |
    | **Name**          | Patient's full legal name (required) |
    | **Date of Birth** | Used to calculate age automatically  |
    | **Gender**        | Male, Female, or Other               |
    | **Address**       | Physical address for correspondence  |
  </Step>

  <Step title="Save the record">
    Click **Save** to create the patient profile. The new record appears immediately in the Patients list and is ready to use for appointments, prescriptions, and lab orders.
  </Step>
</Steps>

<Note>
  Each patient profile is identified by a unique ID generated by Prvaha. This ID links appointments, vitals, and investigation records to the correct person across the platform.
</Note>

## Patient profile

Opening a patient record takes you to their full profile page. The left panel shows the patient's personal details — name, age, gender, date of birth, phone, email, and address — with an **Edit** button to update them. The right panel contains three tabs:

<CardGroup cols={3}>
  <Card title="Vitals" icon="heart-pulse">
    Shows all recorded vitals entries for this patient in reverse chronological order. Click **Record New** to log a new vitals reading. Only Admins, Doctors, and Nurses can record vitals.
  </Card>

  <Card title="Trends" icon="chart-line">
    Displays a historical chart of the patient's vitals over time, letting you spot patterns such as rising blood pressure or fluctuating weight across visits.
  </Card>

  <Card title="Appointments" icon="calendar">
    Lists all past and upcoming appointments for this patient, with upcoming appointments at the top. Click any appointment card to open its full detail view, including the consultation workflow, prescriptions, and lab investigations.
  </Card>
</CardGroup>

## Recording vitals

You can record a new set of vitals at any time from within the patient profile. Click **Record New** on the **Vitals** tab to open the vitals form. The following measurements are available:

| Field                 | Unit                             |
| --------------------- | -------------------------------- |
| **Blood Type**        | A+, A−, B+, B−, O+, O−, AB+, AB− |
| **Height**            | cm                               |
| **Weight**            | kg                               |
| **Blood Pressure**    | e.g. 120/80                      |
| **Heart Rate**        | bpm                              |
| **Temperature**       | °F                               |
| **Oxygen Saturation** | % (0–100)                        |
| **Allergy**           | Free text                        |

Fill in whichever measurements you have, then click **Save**. The entry is added to the top of the Vitals list and immediately reflected in the Trends chart.

## Linking family members

Patients can add family members to their own account so that a single login can manage appointments for an entire household. Clinic staff do not add family members on behalf of a patient — the patient manages this themselves from their own profile.

<Steps>
  <Step title="Navigate to the Family section">
    After logging in as a patient, go to the **Family** section from the dashboard sidebar. Any existing family members are listed here.
  </Step>

  <Step title="Add a family member">
    Click **Add Family Member** (or **New Member** if members already exist) to open the form. Fill in the required details:

    | Field             | Notes                                                        |
    | ----------------- | ------------------------------------------------------------ |
    | **Full Name**     | Required                                                     |
    | **Relationship**  | Father, Mother, Son, Daughter, Brother, Sister, or Other     |
    | **Gender**        | Male, Female, or Other                                       |
    | **Date of Birth** | Or enter an age — the form calculates the date automatically |
    | **Phone Number**  | Optional                                                     |
    | **Email Address** | Optional                                                     |

    Click **Create Member** to save.
  </Step>

  <Step title="Book appointments for the family member">
    When creating a new appointment, you can select the relevant family member from the **Book for** dropdown during the service selection step. The appointment and all resulting records are stored under that family member's profile, keeping records cleanly separated.
  </Step>
</Steps>

<Warning>
  You cannot create a second **Self** record for an existing account. Each user account has exactly one primary patient profile. Additional people are always added with a specified relationship — such as Father, Son, or Other.
</Warning>
