Type: New requirement (remaining scope not covered by STOP-500) · Module: Dashboard tab (PRD 9) · PRD: TBMJA PRD v186, highlighted changes

Background / Context

STOP-500 specifies 15 dashboard cards and is now in QA (release 2.3). Its Screening Coverage card has a "Screened Population breakup". PRD v186 labels that breakdown "Total Eligible Population for TB Screening". 

Problem Statement

The Screening Coverage card being tested does not show the eligible-population figure the PRD now asks for.

Current Behaviour (STOP-500 spec)

Screening Coverage Summary: Total Screened Population (%), Village Population, Screened (count and %), Unscreened (count and %), Screened Population breakup by Male, Female, Pregnant Women, Children (< 15 yrs), Age ≥ 60 yrs, Transgender.

Expected Behaviour / Requirement

Screening Coverage Summary secondary KPIs, as written in the PRD:

1. Village Population (count)
2. Screened (count and %)
3. Unscreened (count and %)
4. Screened Population (count) with breakup: Total Eligible Population for TB Screening, by Male, Females, Pregnant Women, Children (Age < 15 years), Age ≥ 60 years, Transgenders

Filtering and formulas are unchanged: Village + Period for screened figures, Village only for Unscreened.

User Story

As a camp team member, I want to see the eligible population for TB screening by demographic group, so that I can judge coverage against the people who should be screened.

Acceptance Criteria

1. Given the Dashboard tab, when Screening Coverage Summary loads, then it shows Total Eligible Population for TB Screening with the 6 demographic counts.
2. Given a village and period are selected, when the filter changes, then the eligible counts update as agreed in open question 2.
3. Given the demographic counts, when summed, then they match the card's total under the Pregnant Women rule already set for STOP-500.

Business Rules / Validations

Age boundaries and the Pregnant Women counting rule follow STOP-500.

Dependencies

• STOP-500 (In QA, 2.3): the card being changed.

Impact / Affected Areas

Dashboard Screening Coverage card; dashboard queries.

Out of Scope

The new "Screened Population Summary" card and the new time-period filter options (All Time, Yesterday, This Week, This Month). Both are in the PRD but not highlighted, and neither is in STOP-500.

QA / Testing Considerations

Test with villages that have zero, partial and full screening; check totals against source data.

Open Questions / Clarifications

1. How is "Eligible Population for TB Screening" defined? Is it all registered beneficiaries in the village, or a subset? [TBD/CLARIFICATION REQUIRED]
2. Does the eligible figure follow Village + Period, or Village only (like Unscreened)? [TBD/CLARIFICATION REQUIRED]
3. Does the eligible breakdown replace STOP-500's screened breakdown on this card (which the new Screened Population Summary card would then carry), or sit alongside it? [TBD/CLARIFICATION REQUIRED]

PRD Reference

TBMJA PRD – Section 9 Dashboard: https://pmp.piramalswasthya.org/confluence/spaces/AMRIT/pages/149487638/TBMJA+PRD#TBMJAPRD-9.Dashboard