> 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/follow-up-and-referrals.md).

# Follow-up & Referrals

## Feature Overview

When a person is referred to a health facility after a screening or assessment, the app adds them to a follow-up list. The list helps you phone each referred person, find out whether they have visited the facility, and record the result of the call.

The follow-up list:

* works offline, using the data already on your device;
* shows each referred person with the reason for referral, the screening date, the last call and how many call attempts remain;
* lets you search, filter and sort the list;
* lets you call directly from the app and record the outcome of each call.

> **Who sees this list:** the follow-up list appears on the home screen for users whose role includes follow-up calls. The menu item is called **My Patients** or **Tele Support**, depending on the user's role, and opens the same list.

## How the list is filled

You do not add people to the list by hand.

1. A person is referred during a screening or assessment.
2. The record is synchronised to the server (see [Working Offline & Sync](https://spice.docs.medtroniclabs.org/user-guide/offline-and-sync.md)).
3. The next time your device downloads data, the referred person appears in your list, based on the villages assigned to you.
4. Entries leave the list when the follow-up is completed (see [When a follow-up closes](#when-a-follow-up-closes)). Completed entries are removed from the device at the next data download.

## What each entry shows

| Item                 | Meaning                                                                     |
| -------------------- | --------------------------------------------------------------------------- |
| Name, age and gender | The referred person.                                                        |
| Service              | The service during which the referral was made.                             |
| Service date         | The date of the screening or assessment.                                    |
| Reason               | The reason for the referral.                                                |
| Patient status       | The person's current status, for example on treatment.                      |
| Called at            | Date and time of the most recent call. Shows `--` if no call has been made. |
| Remaining attempts   | How many more call attempts are allowed.                                    |
| Due information      | Number of days since the referral became due, shown in red.                 |

## Workflow: call a referred person

1. On the home screen, tap **My Patients** or **Tele Support**.
2. Find the person. Use the search box (name or phone number), or use **Filter** and **Sort**.
3. To review details first, tap the person's card. A details window shows the phone number, address, referral reason, screening date, who screened them, current status and earlier call results.
4. Tap the call button. Your phone's dialler opens with the number filled in.
5. Make the call and end it. The app returns to the **Call Result** window.
6. Choose **Successful** or **Unsuccessful**.
   * **Successful:** answer **Willing to visit?** with **Yes** or **No**.
   * **Unsuccessful:** choose a reason from the list: **Wrong Number** or **Unreachable**.
7. Tap **Submit**.

The result is saved on the device straight away and uploaded in the background when you have a connection. You do not need to be online to record a call.

> **Note:** The call button is disabled when the person has no phone number, or when an earlier call was marked **Wrong Number**.

> **Note:** The **Submit** button stays disabled until all required answers are given. The window cannot be closed without submitting.

## Search, filter and sort

**Search:** type part of a name or phone number in the search box.

**Filter:** tap **Filter** and choose one or more options, then **Apply**. The button shows the number of active filters, for example **Filter (2)**.

| Filter               | Options                                                         |
| -------------------- | --------------------------------------------------------------- |
| Area and Village     | Choose an area first, then the villages within it.              |
| Reason               | High BP, High BG or Both.                                       |
| Referred To          | The type of facility the person was referred to.                |
| Remaining Attempts   | Number of call attempts left.                                   |
| Call Status          | **Successful** or **Unsuccessful** (result of the latest call). |
| CVD Risk             | Risk bands from 0 to under 5% up to 30% and above.              |
| Risk Status          | **Crisis**, **Low** or **Normal**.                              |
| Days since last call | Less than, equal to, or more than 10 days.                      |

**Sort:** tap **Sort** and choose **Latest Screening Date** or **Oldest Screening Date**. The button shows **Sort (1)** while a sort is active. To go back to the default order, reset the sort and tap **Done**.

Without a sort chosen, the list is ordered so that people you have not yet called today come first, then people with the most attempts remaining, then the oldest screening date.

## When a follow-up closes

A person leaves your list when either of these happens:

* the number of call attempts reaches the allowed limit (3 unless the programme sets a different number); or
* you record a call as **Unsuccessful** with the reason **Wrong Number**.

Each submitted call counts as one attempt, whether it was successful or not.

## Tips

* Check your list at the start of each day. People you have already called today move to the bottom.
* Record the call result straight after each call so it is not forgotten.
* If someone is missing from the list, check that your device has synchronised recently (see [Working Offline & Sync](https://spice.docs.medtroniclabs.org/user-guide/offline-and-sync.md)).
