> 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/non-communicable-diseases.md).

# Non-Communicable Diseases

## Feature Overview

SPICE supports the detection, treatment and follow-up of hypertension and diabetes across community and facility care. A person moves through the app in four stages.

| Stage                           | Who                                | What happens                                                                                                                                                                          |
| ------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1. NCD assessment               | Community health worker            | Measures blood pressure, blood glucose, weight and height, asks about symptoms and risk factors, and sees a risk result. A person with a concerning result is referred to a facility. |
| 2. Confirm diagnosis            | Nurse or clinician at a facility   | Registers the referred person, confirms the diagnosis and enrols them in treatment.                                                                                                   |
| 3. Medical review and treatment | Nurse or clinician, pharmacist     | Reviews the patient, prescribes medicines and orders tests. The pharmacist dispenses the medicines.                                                                                   |
| 4. Follow-up                    | Community health worker, clinician | Repeat assessments and reviews, with a next visit date after every contact.                                                                                                           |

## Stage 1: NCD assessment

### Feature overview

The NCD assessment is done for a household member, usually at the household. The app works offline, so you can complete it without a connection and it is sent when the device syncs (see [Working Offline & Sync](https://spice.docs.medtroniclabs.org/user-guide/offline-and-sync.md)).

### Workflow

1. Open the household member (for example from **Household** or **My Patients**) and choose the **NCD** assessment from the member's services.
2. Fill in the form. Its sections are described in [What the form asks](#what-the-form-asks).
3. Tap **Submit**. The app calculates the BMI, the average blood pressure and, where a risk chart is set up, the cardiovascular (CVD) risk, and works out whether the person should be referred.
4. Read the **result** on the summary screen (see [The result](#the-result)).
5. Tap **Done**.

Only a limited number of NCD assessments can be done for the same person on one day. The NCD service is not available again once two assessments have been recorded today, or if the last one was less than two hours ago.

### What the form asks

The form is set up by your organisation, so some questions may differ. The usual sections are:

* **Symptoms:** whether the person has any symptoms, which ones, and any new or worsening symptoms. From the second assessment, **Are you taking medication regularly?** is asked as well.
* **Biometric:** height in cm and weight in kg. The **BMI** is calculated automatically and shown with its category (underweight, normal weight, overweight, obese or extremely obese). When the person has been measured before, height and weight are filled in from the previous assessment.
* **Blood Pressure & Vitals:** one or more blood pressure readings, which the app averages, and whether the person smokes or uses tobacco. At the first assessment the form also asks whether the person was previously diagnosed with high blood pressure. The **CVD Risk** is shown when it can be calculated.
* **Blood Glucose:** the type of test, the value and its unit. At the first assessment the form also asks whether the person was previously diagnosed with diabetes.
* **Eye Care:** shown only for people aged 35 or over (see [Eye Care](https://spice.docs.medtroniclabs.org/user-guide/eye-care.md)).

### The result

The summary screen shows the person's **Patient Status** (for example **Referred**) and a coloured result banner:

* **No Referral / No Treatment Required** (green): nothing concerning was found.
* A **Referred** banner (it shows the type of facility to go to) when the person should be seen at a facility.

At the **first** assessment, a person is referred when any of these is true:

* they have symptoms;
* the average blood pressure is at or above 140 mmHg systolic or 90 mmHg diastolic;
* the blood glucose is at or above the diabetes limit for the test type.

From the **second** assessment, the app grades the result with four colours instead, using the average blood pressure, the blood glucose and whether symptoms are present. Blood pressure and blood glucose are graded separately and the more serious grade is shown.

| Colour | Meaning                                                                                                                                                   |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Red    | Urgent. For example, danger-range blood pressure together with symptoms, extremely high blood glucose, or symptoms together with a blood glucose reading. |
| Orange | Blood pressure in the danger range without symptoms, or very low or very high blood glucose.                                                              |
| Yellow | Moderately raised blood pressure or blood glucose, or symptoms present.                                                                                   |
| Green  | Readings within the normal range.                                                                                                                         |

Any result that is not green is a referral. The referral reason is recorded as symptoms, blood pressure, blood glucose, or a combination.

When the person is referred, the next follow-up date is set to five days later. The referred person then appears in the follow-up list (see [Follow-up & Referrals](https://spice.docs.medtroniclabs.org/user-guide/follow-up-and-referrals.md)).

## Stage 2: Confirm diagnosis

A nurse or clinician at a facility confirms the diagnosis of a person referred from the community, or registers a new person who walks in.

### Workflow

1. On the home screen, tap **Confirm Diagnosis**. The **Search Patient** screen opens.
2. Search for the person by name, ID or mobile number, or scan their QR code. The list is shown only after you search, and only people who are not yet enrolled are listed. If the person is already enrolled, the app says so and shows their Program ID.
3. Tap the person's card. The **Confirm Diagnosis** form opens, filled in with what is already known from the screening. Location details taken from the screening cannot be changed.
4. Check and complete the form (see [What the form asks](#what-the-confirm-diagnosis-form-asks)).
5. Tap **Submit**. If the person might already be registered, a **Duplicate Patient Found** window shows the matching record. Tap **Proceed** only if this is a different person. If the national ID belongs to another patient, the app shows **National ID is already assigned to another member** and you must correct it.
6. A **Summary** shows the registration details, the diagnoses and the health history. Then choose:
   * **Start Treatment** to begin the first medical review straight away (see [Medical Review](https://spice.docs.medtroniclabs.org/user-guide/medical-review.md));
   * **Done** to return to the home screen.

**If the person is not found:** the screen shows **No Patient found.** and, if your role can register patients, a **Register** button. Tap it, read and accept the **Terms & Conditions** (the health worker accepts them on behalf of the participant) and the **Confirm Diagnosis** form opens empty.

### What the confirm diagnosis form asks

The form is set up by your organisation. The usual sections are:

* **Bio Data:** name, mobile number, location, house details and an identity type and number.
* **Bio metrics:** gender, whether the patient is pregnant, date of birth, height, weight (the BMI is calculated) and tobacco use.
* **Health History:** heart attack, stroke, kidney disease and chronic lung disease.
* **Scan QR Code:** links a QR code to the patient so they can be found by scanning.

After enrolment the patient has a **Program ID**, shown on the summary and in later screens.

### Confirming or changing diagnoses later

During a medical review, **Edit Diagnoses** on the **Bio Data** card opens the **Confirm Diagnoses** window. Select one or more disease categories, add optional notes, and tap **Confirm**. At least one category must be chosen. Some options, such as a diabetes type linked to pregnancy, are offered only when they apply to the patient.

## Stage 3: Medical review and treatment

Once a patient is enrolled, the nurse or clinician reviews them at the facility:

* records blood pressure and blood glucose, and sets the diagnoses;
* prescribes medicines and orders tests, with results entered under **Investigation** (see [Lab Investigations](https://spice.docs.medtroniclabs.org/user-guide/lab-investigations.md));
* sets the next visit date.

The pharmacist then dispenses the medicines (see [Pharmacy & Dispense](https://spice.docs.medtroniclabs.org/user-guide/dispense.md)). The full review is described in [Medical Review](https://spice.docs.medtroniclabs.org/user-guide/medical-review.md).

## Stage 4: Follow-up

Follow-up for hypertension and diabetes uses several parts of the app.

* **Next visit date.** Every medical review ends with a next follow-up date (28 days ahead unless you change it). The date shows on the patient's **Bio Data** card at the next review as **Next visit date**.
* **Continuous review.** At every review after the first, the nurse or clinician records new or worsening symptoms and whether the patient takes the medicines regularly, and the card shows the **Last Visit Date**.
* **Controlled or Uncontrolled.** After each review the patient is marked **Controlled** or **Uncontrolled**, using readings from the past month and any new symptoms. This status is shown on the patient's **Bio Data** card and is used as a filter in follow-up lists. A **Controlled** patient can be referred to a facility nearer to home (see [Medical Review](https://spice.docs.medtroniclabs.org/user-guide/medical-review.md)).
* **Repeat community assessment.** The community health worker repeats the NCD assessment (stage 1). From the second assessment the colour-graded result described above is used.
* **Follow-up calls.** People who have been referred, or who miss their visits, appear in follow-up lists that can be worked by phone. Users with the follow-up role see tabs such as **Overdue**, **Missed Visit** and **LTF**. See [Follow-up & Referrals](https://spice.docs.medtroniclabs.org/user-guide/follow-up-and-referrals.md).

## Notes

* The **NCD** assessment, **Confirm Diagnosis**, **My Patients** and **Dispense** tiles only appear for roles that have those workflows enabled.
* Stages 2 and 3 need an internet connection. Stage 1 works offline.
