...
2. Architecture Overview & Sync Model
2.1
...
Sync Architecture
S.No. | Component | Role |
1. | STOP TB Mobile / Tablet Application (Offline/Online) | Primary data entry device for all roles; operates in full offline mode or direct online mode |
2. | Local Server (Offline Staging Endpoint) | Receives data from all devices on the same local Wi-Fi/LAN when no internet is available; forwards accumulated data to central server on connectivity restore |
. When this server comes online, it pushes the data to central server. | ||
3. | Central Server — AMRIT (National Data Store) | Authoritative data store; receives data directly from devices when online, or batched from local server when offline connectivity is restored |
2.2 Operational Mode Requirements
...
- It must capture the State and District/Block/Village Submit the Data to Navigate to "Landing" Page
- .
- Only selection of the village is needed at the frontend. State/ District/Block/ TU/ Health facility can be automatically pre selected at the backend.
UI Field Name | Field Type | Options | Validations |
State | Drop Down | · Auto-Populate | · This must be configurable and must allow to add different states in Future) · · (One Time Activity)- User must be registered with the State that he selected while enrolling himself for the first time under "Settings" |
District | Drop Down | · Auto-Populate | · (This must be configurable and must allow to add different District/Town/City in Future) · · (One Time Activity)- User must be registered with the district that he selected while enrolling himself for the first time under "Settings" |
Block | Drop Down | · Auto-Populate | · (This must be configurable and must allow to add different Taluk/Tehsil in Future) · (One Time Activity)- User must be registered with the block that he selected while enrolling himself for the first time under "Settings" |
TU | Drop Down | · Auto-Populate | · (This must be configurable and must allow to add different TUs in Future) · (One Time Activity)- User must be registered with the block that he selected while enrolling himself for the first time under "Settings" |
Health Facility | Drop Down | · Auto-Populate | · (This must be configurable and must allow to add different health facilities in Future) · (One Time Activity)- User must be registered with the block that he selected while enrolling himself for the first time under "Settings" |
Village | Drop Down | · Auto-Populate | · (This must be configurable and must allow to add different Taluk/Tehsil in Future) · (One Time Activity)- User must be registered with the Block |
Submit | Button | · On clicking Submit Button it must navigate to HWC Page |
...
- Editable on clicking "Edit" option.
Field Name | Input Type | Options / Values | Logic & Validations |
Date of Registration |
| ||
Beneficiary ID (AMRIT ID) |
| ||
Photo | Camera | Optional |
|
I want to add a person from* | Radio | · Public Sector
| This field is not visible in the form/ screen. Will be handled in the backend. Mandatory · Single select
|
Type of Case Finding* | Radio | · Passive (Routine programme)
| ·This field is not visible in the form/ screen. Will be handled in the backend. Mandatory · Single select
|
| |||
First Name* | Text Input | · Free text | · Mandatory · Only English letters
|
Middle & Last Name* | Text Input |
| · Mandatory · Only English letters
|
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
|
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
| |
Time of Death | Time picker | · Show only if above value is “Death”
| |
Reason for Death (Type of 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 Input | 1–99 | · Required. · Numeric. Min 1 Max 99 in years
|
Date of Birth | Date Picker |
| |
Gender* | Radio | · Male · Female · Transgender | · Mandatory
|
Mobile number not available | Checkbox |
| |
Primary Phone* | Number |
| |
Whose mobile number | dropdown | · Self · Husband · Mother · Father · Family Head
|
|
Address* | Text |
|
| State* | Dropdown |
| District*Block* | Dropdown |
|
Dropdown |
| ||
Village* | Dropdown |
| TU* | Dropdown |
| Health Facility* | Dropdown |
Caste* | Radio | · SC · ST · Other | · Mandatory
|
Religion | radio button |
|
|
Area* | Radio | · Tribal-NPVTG · Tribal-PVTG · Rural · Urban · Urban Slum · Unknown | · Mandatory Default Unknown. |
Marital Status* | Radio | · Single · Married · Unknown | · Mandatory · Default Unknown. |
Are you Pregnant* | radio button |
|
|
Husband's/ Wife's Name | Textbox | · Optional
All letter should be in caps | |
Father's Name | Textbox | · |
|
Mother's Name | Textbox | · |
|
Occupation* | Dropdown | · Unknown · Student · Unemployed · Homemaker · Farmer · Laborer / Daily Wage Worker · Self-employed / Business · Government Employee · Private Employee · Health Care Worker · Retired / Pensioner · Other | · Mandatory · Default Unknown. |
Socioeconomic Status* | Radio | · APL · BPL · Unknown | · Mandatory
|
Cancel | Button |
· No |
· 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 |
Continue next to "Anthropometry" Screen |
Acceptance Criteria — Registration
...
Field Name | Input Type | Options / Values | Logic & Validations |
Pulse Rate (beats per minute) | Free textbox | Numeric (BPM) | · Free textbox for manual entry. · If value < 60 or > 90 BPM → show alert 'Refer to Health and Wellness Centre' and flag in Referral card on Home. Auto-sets 'Referral to HWC needed' = Yes. |
Systolic Blood Pressure (mmHg) | Free textbox | Numeric (mmHg) | · SBP and DBP fields placed side by side with their units. · Free textbox for manual entry. · If >= 140 mmHg (High) or < 90 mmHg (Low) → alert 'Refer to Health and Wellness Centre'. Auto-sets 'Referral to HWC needed' = Yes. |
Diastolic Blood Pressure (mmHg) | Free textbox | Numeric (mmHg) | · SBP and DBP placed side by side. · Free textbox for manual entry. · If >= 90 mmHg (High) or < 60 mmHg (Low) → alert 'Refer to Health and Wellness Centre'. Auto-sets 'Referral to HWC needed' = Yes. |
Random Blood Sugar (mg/dl) | Free textbox | Numeric (mg/dl) | · Free textbox for manual entry. · If >= 100 mg/dl → alert 'Refer to Health and Wellness Centre'. Auto-sets 'Referral to HWC needed' = Yes. |
Pallor | Radio Button | Present | Absent | · Optional. |
Icterus | Radio Button | Present | Absent | · Optional. |
Cyanosis | Radio Button | Present | Absent | · Optional. |
Clubbing | Radio Button | Present | Absent | · Optional. |
Lymphadenopathy | Radio Button | Present | Absent | · Optional. |
Oedema | Radio Button | Present | Absent | · Optional. |
Key Population / Risk Factors* | Checkbox (multi-select) | Pregnancy Lactating mother Anti-TNF treatment Bronchial Asthma Cancer Cardiovascular Disorder Contact of Known TB Patients COPD COVID recovered patients Diabetes Dialysis Health Care Worker Hypertensive Liver Impairment Migrant Miner Palliative Care Patient on immunosuppressants Prison Illegal Immigrant Renal Impairment Transplantation Urban Slum H/o Adult BCG Vaccination Undernourished / Malnourished (BMI <18.5 kg/m²) Elderly (age >60 years) Workplace settings (coal/sandblasting/brick kiln) Tea garden worker Construction site worker Congregate settings Attendees of de-addiction centers Person exposed to indoor air pollution Marginalized populations at risk of HIV LGBTQAI++ Substance abuse (alcoholic/intravenous drug users) Tobacco/smoker Silica exposure/silicosis Other Not Applicable | · Mandatory. · Multi-select.
· If 'Not Applicable' selected → all other options are disabled.
|
HIV Status* | Radio | Positive | Reactive | Negative | Unknown | · Mandatory. · Default: Unknown. |
Referral to HWC needed | Auto + manual | Yes | No | · Auto-set to 'Yes' if: Pulse < 60 or > 90 BPM; OR Systolic BP >= 140 or < 90 mmHg; OR Diastolic BP >= 90 or < 60 mmHg; OR Random Blood Sugar >= 100 mg/dl. · Show all such beneficiaries in the Referral → Health and Wellness Centre card on Home. · If all vitals fall in the normal range then 'Referral to HWC needed' remains No and the beneficiary does NOT appear in the HWC Referral card. |
Submit | Button | — | Proceed to TB Screening screen. |
...
Field Name | Input Type | Options / Values | Logic & Validations |
Date | Calendar / Date Picker | Date | Mandatory. Default: Today's Date. Not greater than Today's Date. Accept date >= Date of beneficiary registration. Not editable once submitted. |
Coughing More than 2 weeks * | Radio button | Yes | No | Mandatory. |
Blood in Sputum * | Radio button | Yes | No | Mandatory. |
Fever > 2 weeks * | Radio button | Yes | No | Mandatory. |
Rise of fever in evening * | Radio button | Yes | No | Mandatory. |
Loss of Appetite * | Radio button | Yes | No | Mandatory. |
Loss of Weight * | Radio button | Yes | No | Mandatory. |
Night Sweats * | Radio button | Yes | No | Mandatory. |
History of TB * | Radio button | Yes | No | Mandatory. |
Are you currently taking Anti-TB drugs ** | Radio button | Yes | No | Mandatory. |
Anyone in Family Currently Suffering from TB ** | Radio button | Yes | No | Mandatory. |
Next Screen | |||
Referred for digital chest x-ray | Radio button | Yes | No | · Default: Yes. · Do NOT show for pregnant women. · Mandatory. · Move beneficiary to Referral list titled 'Digital Chest X-ray'. |
Referred for Sputum Collection | Radio button | Yes | No | · Enabled in case of-
|
Sputum Sample submitted at | Dropdown |
| · Optional. · Kept available in case NAAT device is non-functional. |
Recommended for NAAT test | Radio button | Yes | No | · Enabled if Referred for Sputum Collection = Yes. · Mandatory if enabled. · Move beneficiary to Referral list titled 'NAAT'. |
Recommended for liquid culture test | Radio button | Yes | No | · Enabled if: Referred for Sputum Collection = Yes AND History of TB = Yes AND Currently on Anti-TB drugs = Yes. · Mandatory if enabled. · Move beneficiary to Referral list titled 'Liquid Culture'. |
Reason for denial for getting tested | Dropdown (multi-select) | · Fear and anxiety · Misconceptions · Social stigma · Cultural and gender-related barriers · Prior negative experiences with healthcare staff · Privacy concerns · Long waiting times at the camp · Loss of daily wages · Lack of trust in government programs or camp organizers · Others | · Multi-select. · Optional. |
Other | free text | ||
Submit | Button | — | Continue to General OPD module. If skipped → move directly to Diagnostics Results screen. |
...