Document Revision History
Date | Version Number | Author | Approved By | Document change reference |
|
| Dr Vanshika | Madhav | Initial draft |
|
| Dr Vanshika | Madhav | Beneficiary Registration, TB screening, Vitals after feedback and several updates |
| 22.4.2026 |
| Dr Vanshika | Madhav | Mock ups and flow diagram |
|
| Dr Vanshika | Madhav | TPT screening module in progress |
1. Document Overview
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.
...
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. |
Beneficiary ID (AMRIT ID) | | | Unique ID auto generated by the system |
Photo | Camera | Optional | - Should have face detection/ Facial recognition
- Camera should identify & capture human face but not any objects
- Show an Alert if Photo is not captured, just as reminder but Not Mandatory
- Alert: "Do you like to Take Photo", Yes or No If "Yes", open Camera; If "No", go to next
|
First Name | Text |
| - Mandatory
- Speech to text feature
|
Last Name |
|
| - Optional
- Speech to text feature
|
Beneficiary Status | Radio Button | · Alive · Death | · Enable only in the “Edit” Beneficiary screen · Auto-populate, if ‘Death’ is reported from any module · 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 - Show only above value is “Death” and it is Mandatory
- If Gender is Female, and Age is 15-49 Years, show “Maternal Death” in dropdown list otherwise hide
|
Place of Death |
| - Home
- Subcenter
- PHC
- CHC
- District Hospital
- Medical College Hospital
- Private Hospital
- In Transit
- Other Place of Death
| · Enable if “Beneficiary status”= “Death” · Mandatory if enabled - If ‘Place of Death’ is selected as “Other Place of Death” then enable below field “Other Place of Death” and is mandatory.
|
Other Place of Death | Textbox |
| - Enable if “Beneficiary status”= “Death”
- Mandatory if enabled
|
Age | Number (Years) |
| - Mandatory
- If DOB unknown, approximate age allowed
|
Date of Birth | Date Picker |
| - Populate automatically if entered
|
Gender | Dropdown | - Male
- Female
- Transgender
- Prefer not to say
| |
Mobile Number | Number |
| - Mandatory
- Speech to text feature
|
Whose mobile number | dropdown |
| |
Marital Status | dropdown | - Unmarried
- Married
- Divorced
- Separated
- Widow
- Widower
| - Mandatory and single selection allowed
- Not Applicable for Newborn/ Child/ Adolescent (Age 0 to less than 15 Years)
- editable
- optional
- Based on the 'Gender' values in this dropdown list should change as follows:
- In case of 'Gender' = "Female" show "Widow" and hide "Widower"
- In case of 'Gender' = "Male" show "Widower" and hide "Widow"
|
Are you pregnant | radio button | | - Should be enabled if "age" is 15 years and above, "gender" = "female" and if "Marital status"= "Married"
- Mandatory if enabled
- If ""Are you pregnant"= "Yes", then referral to TrueNAT and not digital chest x-ray.
|
Husband's/ Wife's Name | Textbox |
| - Input method: Speech to Text feature
- Optional
- Should be enabled if "Marital status"= Married
- Based on the Gender show label name as: 'Husband's' or 'Wife's Name'
- Accept alphabets only
- Character limit 50
- All letter should be in caps
|
Father's Name | Textbox |
| - Input method: Speech to Text feature
- Optional
- Accept alphabets only
- Character limit 50
- All letter should be in caps
|
Mother's Name | Textbox |
| - Input method: Speech to Text feature
- Optional
- Accept alphabets only
- Character limit 50
- All letter should be in caps
|
Community | radio button | - General
- SC
- ST
- OBC
- OC
- Not Given
|
- should be editable
- optional
|
Religion | radio button | - Hindu
- Muslim
- Christian
- Sikhism
- Buddhism
- Jainism
- Parsi
- Other
- Not disclosed
|
- should be editable
- optional
|
Economic Status | radio button | | |
Type of Residential area | radio button | - Rural
- Urban
- Tribal
- Tea Garden
- Other
| |
Other Type of Residential area | Textbox |
| - Enable if other is selected above
- Allow Alphanumeric Character and special Characters
- Character limit 100
|
Occupation | free text |
| - Default value is unknown
- Optional
|
Village/ Hamlet | dropdown |
| - Single selection allowed
- This must auto fetch the dropdown values (Villages) with which the user is aligned.
|
Sub Centre | dropdown | | |
Capture Geolocation |
|
| - Capture current location details (latitude, longitude, address)
|
Cancel | Button | | - If cancel is selected, a pop up message "Are you Sure?" with options "Yes" and "No" will come.
- If selected "yes" navigate back to home page
- If selected "no" then do not erase the patient health data and let the page remain open so it can be submitted by volunteer as sometime by mistake cancel button is clicked.
|
Submit |
|
| - On clicking this, it must display the Pop up msg "Patient Registered successfully"
- This must store the data of the patient and display the required fields over the Beneficiary card.
- Continue next to "TB Screening" Screen
|
2.22.2.2 Module- Tuberculosis
2.2.2.a TB Screening
...
This module should open in continuation after beneficiary registration.
TB Screening | | | |
* If "Yes" is selected for any one of the questions below with "*" ; "Refer for "digital chest x-ray" or "Collecting the sputum sample". |
** If "Yes" is selected for any one of the questions below with "**" ; "Advise tracing and screening of all family members". |
Date | Calendar Date Picker | Is Mandatory | - Default value Today's Date
- Not greater than Today's Date
- Accept date greater or equal to Date of beneficiary registration
- should not allow to update in edit or once submitted
|
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 | | |
Submit | Button | | Continue next to "Anthropometric and Vitals" Screen |
Fields | Validation |
Anthropometric (Optional) | |
Weight (Kgs) | - |
Height (cms) | - |
BMI=Weight/(Height/100) ² | Should be auto calculated if height and weight details are entered |
Vitals (Optional) | |
Temperature (Degree Fahrenheit) | - Also give free textbox for manual entry.
- Give predefined options (Normal range= 97-99 F)
a) 97.5 b) 98.5 c) 99.5 d)>= 100 If option d)>= 100 is chosen, show alert "Refer to Health and Wellness Centre" and show such beneficiaries in "Referral" card in Home |
Pulse Rate (beats per minute) | - Also give free textbox for manual entry.
Give predefined options (Normal range= 60-90 BPM) a) less than 60 b) 60-70 c) 70-80 d) More than 90 If "less than 60" or "more than 90" option is chosen, show alert "Refer to Health and Wellness Centre" and show such beneficiaries in "Referral" card in Home |
Systolic Blood Pressure | |
Diastolic Blood Pressure | |
Random Blood sugar | |
Skip Button | |
Submit Button | | Continue next to "Diagnostics" Screen |
Diagnostics Diagnostics (Next Screen) |
|
|
|
Is Digital chest x-ray conducted |
| | - To be enabled for everyone except age =< 5 years and "Are you pregnant" = "Yes"
|
Digital Chest X-Ray Test Result | | | - Enable only if "Digital Chest X-ray conducted"=“Yes”
- If "Positive" is selected, move this case to Confirmed TB cases module and also enable sputum test fields for further testing.
|
Is Sputum sample collected |
| | - To be enabled in the following conditions-
- If "History of TB" = "Yes"
- If "Age=< 5 years"
- If "Are you pregnant= yes"
- If "Are you currently taking Anti TB drugs" = "yes"
|
Is True NAT conducted |
| | - To be enabled if "Age"=< 5 years or "Are you pregnant= yes"
|
True NAT test result | radio button | | - Enable only if "Is True NAT conducted"=“Yes”
- Option to edit/ select after submission of the form
- If "Positive" is selected, move this case to Confirmed TB cases module.
|
Is liquid culture conducted |
| | - To be enabled only if "History of TB" = "Yes", "Currently on Anti-TB drugs" = "Yes"
|
Liquid Culture test result | radio button | | - If "Positive" is selected, move this case to Confirmed TB cases module.
- Option to edit/ select after submission of the form
|
...
Name of data Field | Field Type | Value/ Options | Validation/ Logic/ Condition |
Date | Calendar Date Picker | Mandatory | - Default value Today's Date
- Not greater than Today's Date
- Accept date greater or equal to Date of beneficiary registration
- should not allow to update in edit or once submitted
|
Name | Textbox | | Auto fill from Beneficiary details Show: First Name + Last Name Read only |
Age | Textbox | | Auto fill from Beneficiary details Read only |
Gender | Textbox | | Auto fill from Beneficiary details Read only |
Nikshay ID | Textbox | | - Enable if "Yes" is selected for 'Is Sputum sample collected.
- Enable if "Yes" is selected for "Digital Chest X-ray conducted"
- Enable if "Yes" is selected for "NAAT conducted"
|
Is Digital Chest X-ray conducted | | | - To be auto selected "Yes" if "Is Digital chest x-ray conducted = yes"
|
Digital Chest X-Ray Test Result | | | - Enable only if "Digital Chest X-ray conducted"=“Yes”
- If "Positive" is selected, move this case to Confirmed TB cases module and also enable sputum test fields for further testing.
- Auto select the result if "Digital Chest X-Ray Test Result" if result is already captured in the diagnostics screen.
- Also give option to do manual selection
|
Sputum Test | | | - To be enabled in the following conditions-
a) If "Digital Chest X-Ray Test Result"= "Positive" b) If "History of TB" = "Yes" c) If "Age=< 5 years" d) If "Are you pregnant= yes" e) If "Are you currently taking Anti TB drugs" = "yes" |
Is Sputum sample collected? | radio button | | - To be auto selected "Yes" if "Is Sputum sample collected= yes"
|
Sputum Sample submitted at | dropdown | | |
Is True NAT conducted | radio button | | - To be auto selected "Yes" if "Is True NAT conducted = yes" and "Sputum Sample Collected" = "Yes" or if "Digital Chest X-Ray Test Result" = "Positive"
|
True NAT test result | radio button | | - Enable only if "Is True NAT conducted"=“Yes”
- Option to edit/ select after submission of the form
- If "Positive" is selected, move this case to Confirmed TB cases module.
|
Is Liquid culture conducted | radio button | | - To be auto selected "Yes" if "Is liquid culture conducted = yes" and "Sputum Sample Collected" = "Yes"
- To be enabled only if "History of TB" = "Yes", "Currently on Anti-TB drugs" = "Yes"
|
Liquid Culture test result | radio button | | - If "Positive" is selected, move this case to Confirmed TB cases module.
- Option to edit/ select after submission of the form
|
Capture Geolocation |
|
| - Capture current location details (latitude, longitude, address)
|
Submit | Button | | |
...