> For the complete documentation index, see [llms.txt](https://spice.docs.medtroniclabs.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spice.docs.medtroniclabs.org/user-guide/my-patients.md).

# My Patients

## Feature Overview

**My Patients** is the place to find the people you care for and open their records. What it shows depends on the user's role.

| Role                                   | What My Patients opens                                                                                                                            |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nurse or clinician at a facility       | A **Search Patient** screen with a list of patients. From a patient you start a medical review. Needs an internet connection.                     |
| Supervisor or community-level provider | A **My Patients** list of household members, from which you open a member's record and services. Works offline on the data already on the device. |
| Other community roles                  | The follow-up list (see [Follow-up & Referrals](https://spice.docs.medtroniclabs.org/user-guide/follow-up-and-referrals.md)).                     |

This page covers the first two.

## Facility clinician: find and open a patient

### Workflow

<figure><img src="https://2347658875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7inBQ0zjo0nwpqK5625P%2Fuploads%2FwiwqTjKsD1VgOuOwNNh4%2FUntitled%20(Instagram%20Post%20(Square))%20(3).gif?alt=media&amp;token=b62afed3-ecea-4472-ba26-b3d786a97745" alt="Finding and opening a patient in My Patients"><figcaption><p>Find and open a patient in My Patients</p></figcaption></figure>

1. Sign in, make sure the device is online, and tap **My Patients** on the home screen. The **Search Patient** screen opens.
2. The list shows the patients of your facility. The number of results is shown above the list, for example **12 Patients Found**.
3. To find a specific patient, type a name, ID or mobile number in **Enter Name / ID / Mobile Number** and tap the search icon. To scan a QR code, tap the QR icon. Clear the search box to return to the full list.
4. Tap **Filter** to narrow the list (see [Filters](#filters)).
5. Tap a patient's card. The card shows the patient's name, age and gender, national ID (when recorded) and Patient ID. A coloured border around the card shows the patient's risk level.
6. What opens next depends on the patient:
   * If the patient's diagnosis has already been confirmed, a visit is created and the **medical review** opens (see [Medical Review](https://spice.docs.medtroniclabs.org/user-guide/medical-review.md)).
   * If the diagnosis has not been confirmed yet, **Confirm Diagnosis** opens first (see [Non-Communicable Diseases](https://spice.docs.medtroniclabs.org/user-guide/non-communicable-diseases.md)). If the patient is already enrolled, the app says so instead.

If no patient matches, the screen shows **No Patient found.** If your role can register patients, a **Register** button is offered to add the person (see [Non-Communicable Diseases](https://spice.docs.medtroniclabs.org/user-guide/non-communicable-diseases.md)).

By default the list is ordered by cardiovascular risk. A **Sort** button is not offered to this role.

### Filters

Tap **Filter** to open the filter window. The filters are:

* **Registration Date**: **Today**, **Yesterday**, **This Week**, **This Month**, or **Customize** to pick a **From** and **To** date.
* **Health Condition**: **Hypertension**, **Diabetes** or **Both**.
* **Location**: an area and a village within it, chosen from your own coverage area.

Tap **Apply** to filter and **Reset** to clear the choices. When filters are active the button shows a count, for example **Filter (2)**.

### Editing a patient's details

Inside a medical review, **Edit** on the **Bio Data** card opens the patient's record so you can correct the patient's registration details. Tap **Submit** to save. The change needs an internet connection.

## Community provider: household members

### Workflow

1. Tap **My Patients** on the home screen. The **My Patients** screen opens with the household members you can see, and a count of members above the list.
2. Use the drop-down above the list to choose the type of list. Each option shows how many members it holds. The options include **All member list** and lists of members who have had a particular service, such as **NCD Services**, **Cataract Screening**, **Eye Screening** and **Communicable Diseases**.
3. Search by member name, identity number or phone number, or tap the QR icon to scan a member's QR code.
4. Tap **Filter** to narrow the list by location, and by community health worker where your role allows it. The button shows a count when filters are active.
5. Tap a member. The member's record opens, with:
   * **Bio Data**, with an edit option;
   * **Services**, the assessments and services available for this member;
   * **Service History**, the services already recorded with their dates.
6. To register someone who is not yet in your list, tap **Add New Member**.

Each member card shows the member's name, age and gender, Patient ID, most recent service and its date, and an identity number or the community health worker's name. A deceased member is marked as such, with the reason.

### Searching beyond the device

The list starts with the members already on your device. When you search while online, the app also looks for matching members on the server and shows them in the same list. Tapping a member who is only on the server downloads their details first, so that needs an internet connection. If you are offline, only the members already on the device are searched.

## Notes

* The nurse view always needs a connection. If you are offline when you tap **My Patients**, the app shows a connectivity message.
