...
Accessible via Home → TB card. Opens three sub-screens: TB Screening (covered in Nurse flow), Suspected TB Cases, and Confirmed TB Cases.
Confirmed TB cases and TPT Module and line listing should be visible in Counselling officer Role.
6.1 Suspected TB Cases
- Scenario 1: If NO symptom is reported 'Yes' in TB Screening but chest X-ray is Positive → show case here.
- Scenario 2: If ANY symptom is reported 'Yes' in TB Screening → show case here, even if chest X-ray / Truenat is negative.
...
Field Name | Field Type | Options / Values | Validation / Logic / Condition |
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. |
Name | Textbox (read-only) | Auto-filled | Auto-fill from Beneficiary details. Shows First Name + Last Name. Read only. |
Age | Textbox (read-only) | Auto-filled | Auto-fill from Beneficiary details. Read only. |
Gender | Textbox (read-only) | Auto-filled | Auto-fill from Beneficiary details. Read only. |
Nikshay ID | Textbox | Auto/Manual | Enable if 'Is Sputum sample collected = Yes'; OR 'Digital Chest X-ray conducted = Yes'; OR 'NAT conducted = Yes'. |
Is Digital Chest X-ray conducted | Radio / Auto | Yes | No | Auto-selected 'Yes' if 'Is Digital chest x-ray conducted = Yes' in Diagnostics screen. |
Digital Chest X-Ray Test Result | Radio / Auto | Positive | Negative | Enabled only if 'Digital Chest X-ray conducted = Yes'. Auto-select if already captured in Diagnostics screen; also allow manual selection. If Positive → move to Confirmed TB cases AND enable Sputum test fields. |
Sputum Test (section) | Section | — | Enabled if: a) Digital Chest X-Ray Result = Positive; b) History of TB = Yes; c) Are you pregnant = Yes; d) Currently taking Anti-TB drugs = Yes. |
Is Sputum sample collected? | Radio button | Yes | No | Auto-selected 'Yes' if already captured as Yes. |
Sputum Sample submitted at | Dropdown | DMC | DH | CHC | PHC | SC | Optional. |
Is Truenat conducted | Radio button | Yes | No | Auto-selected 'Yes' if: Is Truenat conducted = Yes AND Sputum Sample Collected = Yes; OR Digital Chest X-Ray Result = Positive. |
Truenat test result | Radio button | Positive | Negative | Enabled only if Is Truenat conducted = Yes. Option to edit/select after submission. Auto-select if already captured in Diagnostics screen; allow manual selection. If Positive → move to Confirmed TB cases. |
Is Liquid culture conducted | Radio button | Yes | No | Auto-selected 'Yes' if: Is liquid culture conducted = Yes AND Sputum Sample Collected = Yes. Enabled only if History of TB = Yes AND Currently on Anti-TB drugs = Yes. |
Liquid Culture test result | Radio button | Positive | Negative | Auto-select if already captured in Diagnostics screen; allow manual selection. If Positive → move to Confirmed TB cases. Option to edit/select after submission. |
Capture Geolocation | Auto capture | — | Capture current location details: latitude, longitude, address. |
Submit | Button | — | Save record. |
6.2 Confirmed TB Cases — Treatment & Follow-Up
This screen manages treatment initiation and ongoing follow-up for beneficiaries confirmed as TB positive via Digital Chest X-ray, Truenat, or Liquid Culture.
...
Field Name
...
Field Type
...
Options / Values
...
Validation / Logic / Condition
...
Regimen Type
...
Radio button
...
1.DS-TB (6 Months)
2.Shorter Regimen (9–12 Months)
3.Longer Regimen (18–24 Months)
4.BPaL Regimen (6 Months)
5.INH Mono (6 Month)
...
· If DS-TB (6 Months) selected → open TPT module.
· Alert volunteer to screen all household members / contacts if DS-TB case is selected.
...
Treatment Start Date
...
Date picker
...
Date
...
· Mandatory. Must be >= TB Identification and Diagnosis Visit Date. Not greater than Today's Date.
...
Expected Treatment Completion Date
...
Label (read-only)
...
Auto-calculated
...
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 SECTION —
...
Follow-up Date
...
Date picker
...
Date
...
· Greater than or equal to Treatment Start Date or greater than Last Follow up Date
· Mandatory
· Minimum date is Treatment Start Date
· Accept date greater than Last Follow up Date
· Allow 1 Follow up visit in a month (i.e. monthly 1 Follow up)
· Not greater than Today's Date
...
Monthly follow-up done
...
Label (read-only)
...
Month-1 to Month-24
...
Incremental based on monthly follow-up visits completed.
...
Adherence to Medicines
...
Radio button
...
Regular | Irregular
...
—
...
Any discomfort
...
Radio button
...
Yes | No
...
—
...
— TREATMENT COMPLETION SECTION —
...
Did the patient complete the full course of treatment?
...
Radio button
...
Yes | No
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
...
Date
...
Enabled if 'Yes' selected above. Must be > Last Follow-up Date.
...
TB Treatment Outcomes
...
Dropdown
...
Cured | Failed | Lost to Follow-up (LFU) | Death
If Death selected → update Beneficiary Status = Death in Beneficiary record;
Enable Date of Death, Place of Death, and Reason for Death fields.
...
Date of Death
...
Date picker
...
Date
Enable only if TB Treatment Outcomes = Death.
Mandatory if enabled.
Default: null. Not greater than Today's Date. >= Treatment Start Date or > Last Follow-up Date.
...
Place of Death
...
Dropdown
...
Home | Subcenter | PHC | CHC | District Hospital | Medical College Hospital | Private Hospital | Other Place
...
Enable only if TB Treatment Outcomes = Death.
...
Reason for Death
...
Label (read-only)
...
Tuberculosis
...
Enable only if TB Treatment Outcomes = Death. Pre-filled as 'Tuberculosis'. Read only.
...
Reason for non-completion of treatment
...
Textbox
...
Free text
...
Enable if 'No' selected for 'Did the patient complete full treatment?'
...
Capture Geolocation
...
Auto capture
...
—
...
Capture current location: latitude, longitude, address.
...
Submit
...
Button
...
—
...
Save record.
...
Follow-up visit history
...
Table (read-only)
...
—
...
Maintain and display complete follow-up visit history.
Acceptance Criteria — Confirmed TB Cases
AC-CONF-01: Given Regimen Type = DS-TB (6 Months) is selected, When saved, Then the TPT (Household Contact Line Listing) module opens automatically AND an alert is displayed: 'Screen all household members / contacts.'
AC-CONF-02: Given Treatment Start Date = 01-Jan-2025 and Regimen Type = DS-TB (6 Months), When saved, Then Expected Treatment Completion Date is auto-calculated and displayed as 01-Jul-2025 (read-only).
AC-CONF-03: Given TB Treatment Outcome = Death is selected, When saved, Then Beneficiary Status in the Registration module is automatically updated to 'Death', and Date of Death, Place of Death fields are enabled and mandatory.
AC-CONF-04: Given Regimen Type = DS-TB (6 Months) and only 3 monthly follow-up visits are completed, When the nurse attempts to enable 'Did patient complete full treatment?', Then the field remains disabled until 5 monthly visits are recorded.
6.3 TB Preventive Treatment (TPT) Module
- TPT is preventive treatment given to close contacts of confirmed Drug-Sensitive TB (DS-TB) cases who are at high risk of developing active TB.
- This module opens when in the Confirmed TB Cases module, Regimen Type = 'DS-TB (6 months)'.
- The module must be editable — after referral of the contact for diagnostic tests, the volunteer enters further details once tests are completed.
- If a contact tests positive for active TB at any step (X-ray or Sputum positive) → the system must immediately redirect the volunteer to create a new TB Suspected Case record for that contact, bypassing the TPT flow.
6.3.1 Household Contact Line Listing Screen
...
Field Name
...
Field Type
...
Options / Values
...
Validation / Logic / Condition
...
Name of the contact
...
Text Box
...
Free text
...
—
...
Age of the contact
...
Number input
...
Numeric
...
—
...
Gender
...
Dropdown
...
Male | Female | Transgender | Prefer not to say
...
Mandatory. Speech-to-text feature enabled.
...
Mobile Number
...
Number
...
Numeric
...
Optional. Speech-to-text feature enabled.
...
TPT Screening Status
...
Radio / Dropdown
...
Not Started | Pending | Completed
...
Mandatory. Single selection. Default: Pending.
...
Referral Facility for screening
...
Radio / Dropdown
...
HWC | PHC | CHC | District Hospital
...
Mandatory. Single selection. From here volunteer can go directly to Submit as contact must first get tested.
...
Screening done at the referral facility
...
Radio
...
Yes | No
...
Mandatory.
...
Is it confirmed TB case
...
Radio
...
Yes | No
...
If Yes → move card to Confirmed TB list. If No → continue ahead.
...
Are you advised to take TPT
...
Radio
...
Yes | No
...
If Yes → continue to next field. If No → go directly to Submit.
...
TPT initiated
...
Radio
...
Yes | No
...
Mandatory. Enable next fields if Yes.
...
TPT start date
...
Date picker
...
<= Today's date
...
Mandatory if enabled. Cannot be future date. Cannot be before date of screening.
...
Treatment duration of TPT
...
Radio / Dropdown
...
1 Month | 3 months | 6 months
...
—
...
Expected completion date
...
Date (read-only)
...
Auto-calculated
...
Auto-calculated = TPT start date + regimen duration. Non-editable.
...
Follow-up visit number
...
Numeric (read-only)
...
Auto-increment (1–6)
...
Non-editable. Automatically calculated by system.
...
Follow-up visit date
...
Date picker
...
<= Today's date
...
Mandatory if enabled. Cannot be future date. Cannot be before TPT start date.
...
TPT completion status
...
Radio / Dropdown
...
Completed
Incomplete
Lost to follow-up
Developed active TB during TPT
Died during TPT
Other
...
Mandatory. If 'Completed' → enable Date of completion field. If 'Developed active TB during TPT' → redirect volunteer to create new TB Suspected Case record and close this TPT case. If 'Died during TPT' → enable Date of death and Cause of death fields.
...
Other
...
Free text
...
—
...
—
...
Date of completion
...
Date picker
...
<= Today's date
...
Mandatory if TPT completion status = Completed. Cannot be future date.
...
Date of death
...
Date picker
...
Date
...
Enabled if TPT completion status = Died during TPT. Mandatory if enabled.
...
Cause of death
...
Free text
...
—
...
Enabled if TPT completion status = Died during TPT. Mandatory if enabled.
...
Capture Geolocation
...
Auto capture
...
—
...
Capture current location: latitude, longitude, address.
...
Submit
...
Button
...
—
...
7. Counselling Officer Flow
...
Field Name | Field Type | Options / Values | Validation / Logic / Condition |
Name of the contact | Text Box | Free text | — |
Age of the contact | Number input | Numeric | — |
Gender | Dropdown | Male | Female | Transgender | Prefer not to say | Mandatory. Speech-to-text feature enabled. |
Mobile Number | Number | Numeric | Optional. Speech-to-text feature enabled. |
TPT Screening Status | Radio / Dropdown | Not Started | Pending | Completed | Mandatory. Single selection. Default: Pending. |
Referral Facility for screening | Radio / Dropdown | HWC | PHC | CHC | District Hospital | Mandatory. Single selection. From here volunteer can go directly to Submit as contact must first get tested. |
Screening done at the referral facility | Radio | Yes | No | Mandatory. |
Is it confirmed TB case | Radio | Yes | No | If Yes → move card to Confirmed TB list. If No → continue ahead. |
Are you advised to take TPT | Radio | Yes | No | If Yes → continue to next field. If No → go directly to Submit. |
TPT initiated | Radio | Yes | No | Mandatory. Enable next fields if Yes. |
TPT start date | Date picker | <= Today's date | Mandatory if enabled. Cannot be future date. Cannot be before date of screening. |
Treatment duration of TPT | Radio / Dropdown | 1 Month | 3 months | 6 months | — |
Expected completion date | Date (read-only) | Auto-calculated | Auto-calculated = TPT start date + regimen duration. Non-editable. |
Follow-up visit number | Numeric (read-only) | Auto-increment (1–6) | Non-editable. Automatically calculated by system. |
Follow-up visit date | Date picker | <= Today's date | Mandatory if enabled. Cannot be future date. Cannot be before TPT start date. |
TPT completion status | Radio / Dropdown | Completed Incomplete Lost to follow-up Developed active TB during TPT Died during TPT Other | Mandatory. If 'Completed' → enable Date of completion field. If 'Developed active TB during TPT' → redirect volunteer to create new TB Suspected Case record and close this TPT case. If 'Died during TPT' → enable Date of death and Cause of death fields. |
Other | Free text | — | — |
Date of completion | Date picker | <= Today's date | Mandatory if TPT completion status = Completed. Cannot be future date. |
Date of death | Date picker | Date | Enabled if TPT completion status = Died during TPT. Mandatory if enabled. |
Cause of death | Free text | — | Enabled if TPT completion status = Died during TPT. Mandatory if enabled. |
Capture Geolocation | Auto capture | — | Capture current location: latitude, longitude, address. |
Submit | Button | — | Save record. |
Acceptance Criteria — Confirmed TB Cases
AC-CONF-01: Given Regimen Type = DS-TB (6 Months) is selected, When saved, Then the TPT (Household Contact Line Listing) module opens automatically AND an alert is displayed: 'Screen all household members / contacts.'
...