This document defines the functional requirements for the TB Screening mobile application developed under the TB Mukt Janjati Abhiyan: A community-driven TB elimination initiative targeting tribal populations across India. The application is purpose-built for field use by community volunteers in tribal areas where connectivity, literacy, and device familiarity may be limited.
The application should be simple to use, comprehensive and must work in low/no-connectivity environments.
This application is developed to screen and maximize TB case detection in all age groups through active case finding, contact investigation, and community mobilization. This application helps in patient tracking throughout treatment cascade at community and facility level via Community Influencers and Nikshay Mitras. Ensure prompt referral and linkage of diagnosed individuals from community to health facilities for timely treatment initiation is the purpose of this application.
1. Volunteers- Community mobilization, screenings, camps etc.
2. Admin / Supervisory- Backend/Dashboard Access
| TB Screening modules | Enlisted in the PRD |
| NCD Screening modules | Enlisted in the PRD |
| Nikshay integration | External dependency |
| Integration of AI assessment tool (Cough) | External technical dependency |
| Lab testing device integration (sputum testing) | External technical dependency |
| Integration of AI enabled hand- held chest Xray (digital) | External technical dependency |
Dashboard indicators | Enlisted in the PRD. Can be added more as per the requirement. |
Pre Camp Work Plan Preparation Module | Subjected to requirement |

UI Field Name | Field Type | Options | Validations |
"NikshayMitra Application" Logo | <Placeholder> |
| |
Please Select your Language | Radio Button |
|
|
Username | Textbox | ||
Password | Textbox | ||
Remember Me | Checkbox |
|
|
Powered by Piramal Foundation | Text |
|
|
Photo of the beneficiary | Name | Beneficiary ID |
Age (Years) | Village Name- | |
Phone Number | ABHA ID (ABHA registration)- Clickable |
Field Name | Field Type | Value/ Options | Validation/ Logic |
Date of registration | Should be auto selected and updated when the volunteer logs in the application to do the screening. | ||
Photo | Camera | Optional |
|
First Name | Text |
| |
Last Name |
| ||
Beneficiary Status | Radio Button | · Alive · Death | · Enable only in the “Edit” Beneficiary screen · Auto-populate, if ‘Death’ is reported from any module (eg: Tuberculosis) · Default value is “Alive” · If “Death” is selected, enable below four fields and mark it mandatory- 1. Date of Death 2. Time of Death 3. Reason for Death 4. Place of Death or Other Place of Death |
Date of Death | Date picker | · Enable if “Beneficiary status”= “Death” · Mandatory if enabled · By default, date is null · Not greater than Today’s Date · Accept ‘Date of Death’ after date of registration · Auto-populate, if ‘Death’ is reported from any module (eg: Tuberculosis) | |
Time of Death | Time picker | · Show only if above value is “Death” · Optional | |
Reason for Death (Type of Death) | · Maternal Death · Natural Death · Accident · Infectious Disease · Animal Bite Death · Suicide · Undetermined | · Enable if “Beneficiary status”= “Death” · Mandatory if enabled
| |
Place of Death |
| · Enable if “Beneficiary status”= “Death” · Mandatory if enabled
| |
Other Place of Death | Textbox |
| |
Age | Number (Years) |
| |
Date of Birth | Date Picker |
| |
Gender | Dropdown |
|
|
Mobile Number | Number |
| |
Village/ Hamlet | dropdown | ||
Marital Status | radio button |
|
|
Husband's/ Wife's Name | Textbox |
| |
Father's Name | Textbox |
| |
Mother's Name | Textbox |
| |
Community | radio button |
|
|
Religion | radio button |
|
|
Economic Status | radio button |
|
|
Type of Residential area | radio button |
|
|
Other Type of Residential area | Textbox |
| |
Occupation | free text |
| |
Cancel | Button |
|
|
Capture Geolocation |
| ||
Submit |
|
Lists Sections
Different types of lists are created based on the beneficiary registrations. These are defined in the following data fields: "Age" and "CBAC Score".
2.2.2.a TB Screening
In this section show all beneficiaries irrespective of any age group and gender.
TB Screening |
|
|
|
* If "Yes" is selected for any one of the questions below with "*" auto select "yes" for "Referral Required." Show these beneficiaries to 'Suspected TB cases' section Show these beneficiaries to 'Referral list module in the Home' section as per the test selected ("AI Cough Assessment", "Digital Chest X-ray", "Sputum Collection", "NAAT") |
|
|
|
** If "Yes" is selected for any one of the questions below with "**" auto select "yes" for "Referral Required." Show these beneficiaries to 'Suspected TB cases' section Show these beneficiaries to 'Referral list module in the Home' section as per the test selected ("AI Cough Assessment", "Digital Chest X-ray", "Sputum Collection", "NAAT") Screen all the family members and contacts of the beneficiary |
|
|
|
Date | Calendar | Is Mandatory |
|
Symptomatic Screening |
| ||
Coughing More than 2 weeks * | radio button |
|
|
Blood in Sputum * | radio button |
|
|
Fever > 2 weeks * | radio button |
|
|
Rise of fever in evening* | radio button |
|
|
Loss of Appetite* | radio button |
|
|
Loss of Weight * | radio button |
|
|
Night Sweats * | radio button |
|
|
History of TB * | radio button |
|
|
Are you currently taking Anti TB drugs ** | radio button |
|
|
Anyone in Family Currently Suffering from TB ** | radio button |
|
|
Asymptomatic Screening |
|
|
|
Age more than 60 | radio button |
|
|
Diabetic | radio button |
|
|
Tobacco user | radio button |
|
|
Contact with TB patient on treatment | radio button |
|
|
Referral Required | radio button |
|
|
Referral for |
|
| |
Capture Geolocation |
| ||
Submit | Button |
|
|
2.2.2.b Suspected TB cases
This section should contain all beneficiaries If "referral required "= "Yes"
Name of data Field | Field Type | Value/ Options | Validation/ Logic/ Condition |
Date | Calendar | Mandatory |
|
Name | Textbox |
| Auto fill from Beneficiary details |
Age | Textbox |
| Auto fill from Beneficiary details |
Gender | Textbox |
| Auto fill from Beneficiary details |
Is Sputum sample collected? | radio button |
|
|
Sputum sample submitted at | radio button |
|
|
Sputum Test result | radio button |
|
|
Is Digital Chest X-ray conducted |
|
|
|
Digital Chest X-Ray Test Result |
|
|
|
AI Cough Assessment conducted |
|
|
|
AI Cough Assessment result |
|
|
|
NAAT conducted |
|
|
|
NAAT result |
|
|
|
Nikshay ID | Textbox |
|
|
Type of suspected TB case | Radio button |
|
|
Reason for suspected TB case | Dropdown |
|
|
Other | textbox |
| |
Has the diagnosis of DR-TB been confirmed? | Radio button |
|
|
Capture Geolocation |
| ||
Submit | Button |
|
|
2.2.2.c Confirmed TB cases
Treatment and follow up of TB confirmed cases.
Name of Data Field | Field Type | Value/ Options | Validation/ Logic/ Condition |
Regimen Type | Radio button |
| Open module 2.2.2.d (TPT- TB Prevention treatment) module if “DS-TB (6 Months)” is selected Alert to Volunteer to screen all household members/ Contacts if DS-TB case is selected.
|
Treatment Start Date | Date picker
| Mandatory |
|
Expected Treatment Completion Date | Label | Read only | Auto calculate this date based on below condition form ‘Treatment Start Date’: 1. If ‘Regimen Type’ is “1”, “4”, “5” then add 6 months 2. If ‘Regimen Type’ is “2”, then, Treatment duration is 9–12 months (show 9–12 range dates) 3. If ‘Regimen Type’ is “3”, then, Treatment duration is 18–24 months (show 18–24 range dates) |
Follow-up & Adherence | |||
Follow up Date | Date picker
| Mandatory |
|
Monthly follow up done | Label | Month-1 to Month-24 |
|
Adherence to Medicines | Radio button |
|
|
Any discomfort | Radio button |
|
|
Treatment Completion | |||
Did the patient complete the full course of treatment? | Radio button |
| Enable these below filed based on below conditions: 1. If ‘Regimen Type’ is “1”, “4”, “5” then enable after 5 Monthly follow up visits 2. If ‘Regimen Type’ is “2”, then enable after 9 Monthly follow up visits 3. If ‘Regimen Type’ is “3”, then enable after 18 Monthly follow up visits |
Actual Treatment Completion Date | Date picker |
|
|
TB Treatment outcomes | Dropdown |
| If "Death" is selected, update 'Beneficiary Status' = "Death" in the Beneficiary record, with “Date of Death”, "Place of Death" and "Reason for Death” in the next fields. |
Date of Death | Date picker |
|
|
Place of Death | Dropdown |
| Enable only if "TB Treatment outcomes" = “Death” |
Reason for Death | Label Read only | Tuberculosis | Enable only if "TB Treatment outcomes" = “Death” |
Reason for non completion of treatment | Textbox |
| Enable this field if “No” selected for “Did the patient complete full treatment?” |
Capture Geolocation |
| ||
Submit | button |
|
|
Follow up visit history | Table |
| Maintain a Follow up visit history of Visit |
Tuberculosis Preventive Treatment (TPT)
Household Contact Line listing Screen-
Name of data field | Field Type | Value/ Options | Validation/ logic/ condition |
Name of the contact | Text Box |
| |
Age of the contact |
| ||
Gender | Dropdown |
|
|
Mobile Number | Number |
| |
TPT (TB Preventive Treatment) Screening Status |
|
|
|
Referral Facility for screening |
|
|
|
Screening done at the referral facility |
|
|
|
Is it confirmed TB case |
|
|
|
Are you advised to take (TPT) |
|
|
|
TPT initiated |
|
|
|
TPT start date | Date picker | =<Today’s date |
|
Treatment duration of TPT |
|
|
|
Expected completion date | date |
|
|
Follow up visit number | Numeric |
|
|
Follow up visit date | Date picker | =<Today’s date |
|
TPT completion status |
|
|
|
Other | Free text | ||
Date of completion | Date picker | =<Today’s date |
|
Date of death | Date picker |
|
|
Cause of death | Free text |
|
|
Capture Geolocation |
| ||
Submit |
|
|
|
Note: The common questions in CBAC Part B1 and TB screening form, if either of the form is filled and submitted first, then responses in the other form should be automatically selected.
Community Based Assessment Checklist (CBAC) Form
NCD (Non-Communicable Diseases) Eligible List:
Show all Beneficiary both Male and Female whose age > = 30 years and excluding Pregnant Women.
And this CBAC Form is applicable to screen these Beneficiaries.
This CBAC Form, assessment check should be done yearly once, Maintain the history of submitted CBAC Form for viewing, year wise
Name of Data Field | Field Type | Value/ Options | Validation/ Logic/ Condition |
CBAC Form |
|
|
|
Date | Calendar |
|
|
Name | Textbox |
| Auto fill from Beneficiary details |
Age | Textbox |
| Auto fill from Beneficiary details |
Sex | Textbox |
| Auto fill from Beneficiary details |
Part A: Risk Assessment |
|
|
|
What is your Age? (in Age) | radio button | Is Mandatory
| Auto-populate Age from 'Beneficiary' registration: |
Do you smoke or consume smokeless products such as gutka or khaini | radio button | Is Mandatory
| Score Logic: |
Do you consume alcohol daily | radio button | Is Mandatory
| Score Logic: |
Measurement of Waist (in cm) | radio button | Is Mandatory
| Score Logic: |
Do you under take any physical activity for minimum of 150 minutes in a week | radio button | Is Mandatory
| Score Logic: |
Do you have any family history (any one of your parents or siblings) of high BP / Diabetes / Heart Disease | radio button | Is Mandatory
| Score Logic: |
Total Score | Label |
| Total Score Formula: |
Part B1: Early Detection |
|
|
|
If "Yes" is selected below then display a pop-up message, "Suspected NCD case, please visit nearest HWC or call 104." |
|
|
|
* If "Yes" is selected for any one of the questions below with "*" then show a pop-up message "Refer to MO and collect the Sputum sample" |
|
|
|
** If "Yes" is selected for any one of the questions below with "**" then show a pop-up message "Refer to MO or inform ANM/MPW to tracing of all family members" |
|
|
|
Shortness of Breath | radio button | Is Mandatory
|
|
Coughing More than 2 weeks * | radio button | Is Mandatory
|
|
Blood in Sputum * | radio button | Is Mandatory
|
|
Fever > 2 weeks * | radio button | Is Mandatory
|
|
Loss of Weight * | radio button | Is Mandatory
|
|
Night Sweats * | radio button | Is Mandatory
|
|
Are you currently taking Anti TB drugs ** | radio button | Is Mandatory
|
|
Anyone in Family Currently Suffering from TB ** | radio button | Is Mandatory
|
|
History of TB * | radio button | Is Mandatory
|
|
Recurrent of ulceration on Palm or Sole | radio button | Is Mandatory
|
|
Recurrent of tingling on Palm or Sole | radio button | Is Mandatory
|
|
Cloudy or Blurred Vision | radio button | Is Mandatory
|
|
Difficulty in reading | radio button | Is Mandatory
|
|
Pain in eyes lasting for more than weeks | radio button | Is Mandatory
|
|
Redness in eyes for more than weeks | radio button | Is Mandatory
|
|
Difficulty in Hearing | radio button | Is Mandatory
|
|
History of Fits | radio button | Is Mandatory
|
|
Difficulty in Opening Mouth | radio button | Is Mandatory
|
|
Ulcers in Mouth Not Healed in 2 weeks | radio button | Is Mandatory
|
|
Growth in Mouth Not Healed in 2 weeks | radio button | Is Mandatory |
|
Any white or red Patch in Mouth Not Healed in 2 weeks | radio button | Is Mandatory
|
|
Pain while chewing | radio button | Is Mandatory
|
|
Any change in Tone of Voice | radio button | Is Mandatory
|
|
Any hypo pigmented patches or discolour lesions with loss of sensation | radio button | Is Mandatory
|
|
Any thickened skin | radio button | Is Mandatory
|
|
Any nodules skin | radio button | Is Mandatory
|
|
Any Patch or Discoloration on Skin | radio button | Is Mandatory
|
|
Recurrent numbness on palm or sole | radio button | Is Mandatory
|
|
Clawing of fingers in hand or feet | radio button | Is Mandatory
|
|
Tingling and numbness in hand / or feet | radio button | Is Mandatory
|
|
Inability to close eye lid | radio button | Is Mandatory
|
|
Difficulty in Holding Objects in hands or Fingers | radio button | Is Mandatory
|
|
Weakness in feet that cause difficulty in walking | radio button | Is Mandatory
|
|
Part B2: Women Only |
|
|
|
Lump in the Breast | radio button | Is Mandatory
|
|
Bleeding after Menopause | radio button | Is Mandatory
| If option selected is "Yes" then display "Inform ASHA Facilitator." |
Blood Stained Discharge from the Nipple | radio button | Is Mandatory
|
|
Bleeding after intercourse | radio button | Is Mandatory
|
|
Part B3: Elderly Specific |
|
|
|
Feeling unsteady while standing or walking | radio button | Is Mandatory
| If option selected is "Yes" then display "Send the patient to MOIC of nearest health center for treatment " |
Suffering from any physical disability that restrict movement | radio button | Is Mandatory
| If option selected is "Yes" then display "Send the patient to MOIC of nearest health center for treatment " |
Needing help from others to perform every day activities such as eating, getting dressed, grooming, bathing, walking, or using the toilets | radio button | Is Mandatory
| If option selected is "Yes" then display "Send the patient to MOIC of nearest health center for treatment " |
Forgetting names of yours, near ones or your own home address | radio button | Is Mandatory
| If option selected is "Yes" then display "Send the patient to MOIC of nearest health center for treatment " |
Part C: Risk factor for COPD |
|
|
|
Type of Fuel Used for Cooking | radio button | Choose: |
|
Occupational Exposure | radio button | Choose: |
|
Part D: PHQ2 |
|
|
|
Over the last two weeks bothered by the following problem? |
|
|
|
Little interest or pleasure in doing things? | radio button | Choose:
| Score Logic: |
Feeling down, depressed or hopeless? | radio button | Choose:
| Score Logic: |
Total Score | Label |
| Total Score formula: Sum of all the above score |
Capture Geolocation |
| ||
Submit |
|
|
|
This module should contain the list of names/ cases referred to health facilities.
Field Name | Field Type | Options | Validation |
Filter/ Selection option | Dropdown | The Dropdown Values are
| If this filter is selected, then show all the values of the dashboard indicators pertaining to the time period selected. |
Filter/ Selection option | Dropdown | Village/ Hamlet names to be put here | If this filter is selected, then show all the values of the dashboard indicators pertaining to the particular village selected. |
Total TB screenings | Card must be yellow in colour | It must auto populate based on the filter selected. | |
Total TB suspected cases | Card must be yellow in colour | It must auto populate based on the filter selected. | |
Total TB confirmed cases | Card must be yellow in colour | It must auto populate based on the filter selected. | |
NIKSHAY IDs | Card must be yellow in colour | Total number of NIKSHAY IDs made in the selected time period or Village | |
ABHA IDs | Card must be yellow in colour | Total number of ABHA IDs made in the selected time period or Village |