Overview

The Counselling module is part of the Confirmed TB Cases workflow. It allows a Counselling Officer to record all counselling activities across six structured sections (A–F) for each confirmed TB case. The module supports multi-session editing, auto-resumption, and Nikshay record update on completion.

Module Entry

• Actor: Counselling Officer
• Entry point: Confirmed TB Cases list → select beneficiary → Counselling tab
• Mandatory: Yes — for all confirmed TB cases
• Post-submission: Case marked 'Counselled'; Nikshay record updated

Auto-filled Patient Header (read-only)

The following fields are auto-populated from existing records and are not editable by the counsellor:

• Counselling Date — defaults to today's date
• Counselling Officer Name — from logged-in user account
• Beneficiary Name — First Name + Last Name
• Beneficiary ID (AMRIT ID)
• Nikshay ID — from Diagnostics screen
• Age / Gender
• Diagnosis — X-ray Result | NAAT Result | Liquid Culture Result

Section Structure

Each section has mandatory radio button fields (Yes/No) and an optional free-text notes field. Navigation is linear (A → B → C → D → E → F) via Next/Back buttons. The form supports draft resumption — if the session is interrupted, the counsellor can resume from the last saved section.

Section E — Conditional Logic

• If Counselling Completion Status = Refused: all preceding sections (A–D) become non-mandatory; a mandatory 'Reason for Refusal' free-text field (max 300 chars) is displayed.
• If Counselling Completion Status = Complete: all sections A–D remain mandatory.

Section F — Conditional Logic

• If "Has the patient started the prescribed TB treatment regimen?" = No: a mandatory 'Reason for not starting' free-text field (max 500 chars) is displayed.

Submission

• Triggered by Submit button on Section F.
• If status = Complete → Nikshay record updated; case marked 'Counselled'.

 

 

 

Acceptance Criteria 

AC-1: Counselling list view — incomplete or not started

Given the counsellor is on the Confirmed TB Cases list
When a case has counselling that is incomplete or not yet started
Then

• Auto-filled header fields are displayed: Counselling Date (today), Counselling Officer Name, Beneficiary Name, Beneficiary ID, Nikshay ID, Age/Gender, Diagnosis
• A button is shown:
  • "Start Counselling" — if no counselling session exists for this case
  • "Continue Counselling" — if a session exists but is not marked Complete

AC-2: Counselling list view — edit completed or in-progress counselling

Given the counsellor is on the Confirmed TB Cases list
When a case has counselling that is not marked Complete
Then the counsellor can open and edit any previously saved counselling details

AC-3: Start new counselling

Given the counsellor clicks "Start Counselling"
When the form opens
Then the counsellor is routed to Section A of the counselling form

AC-4: Section A — navigation to Section B

Given the counsellor is on Section A (Disease Awareness)
When all mandatory fields are filled and the counsellor clicks Next
Then the counsellor is routed to Section B

AC-5: Section B — navigation to Section C

Given the counsellor is on Section B (Do's and Don'ts)
When all mandatory fields are filled and the counsellor clicks Next
Then the counsellor is routed to Section C

AC-6: Section C — navigation to Section D

Given the counsellor is on Section C (Government Schemes)
When all mandatory fields are filled and the counsellor clicks Next
Then the counsellor is routed to Section D

AC-7: Section D — navigation to Section E

Given the counsellor is on Section D (Treatment Regimen)
When all mandatory fields are filled and the counsellor clicks Next
Then the counsellor is routed to Section E

AC-8: Section E — Refused status conditional field

Given the counsellor is on Section E (Counselling Completion)
When Counselling Completion Status is set to "Refused"
Then

• The "Reason for Refusal" free-text field appears and becomes mandatory (max 300 chars)
• All fields in Sections A–D become non-mandatory

AC-9: Section E — navigation to Section F

Given the counsellor is on Section E

When all applicable mandatory fields are filled and the counsellor clicks Submit
Then

• The counselling record is saved
• If Counselling Completion Status = Complete → Nikshay record is updated and the case is marked 'Counselled'

AC-10: Section F — conditional field for treatment not started

Given tAfter 15 days the counsellor is on Section F for the same patient (Follow-Up to TU)
When "Has the patient started the prescribed TB treatment regimen?" is set to "No"
Then the "Reason for not starting the prescribed TB treatment regimen" free-text field appears and becomes mandatory (max 500 chars)

AC-11: Section F — form submission

Given After 15 days the counsellor is on Section F for the same patient
When all applicable mandatory fields are filled and the counsellor clicks Submit
Then

• The counselling record is saved
• If Counselling Completion Status = Complete → Nikshay record is updated and the case is marked 'Counselled'

AC-12: Session interruption and auto-resumption

Given the counsellor is on any section and the app closes or terminates
When the counsellor reopens the app and navigates to the Confirmed TB Cases list
Then

• The patient's auto-filled header details are visible
• A "Continue Counselling" button is shown
• On clicking Continue, the counsellor is taken to the exact section where the session was interrupted, with all previously entered data intact

AC-13: Back navigation across sections

Given the counsellor is on any section
When the counsellor clicks the Back button
Then the counsellor is taken to the previous section with all previously entered data intact, allowing review and editing