Filter Statistics and Reports by Chapter Scope for Multi-Affiliated Members
The statistics screens for both peer mentors and coordinators must apply chapter-scope filtering when loading data for multi-affiliated contacts. The chapter scope resolver determines which activities belong to the current coordinator's chapter scope. Stats summaries, charts, and Bufdir export queries must all honour this scope boundary. A coordinator in chapter A should never see activities attributed to chapter B, even if the same peer mentor appears in both.
User Story
Acceptance Criteria
- Given a coordinator views the stats screen for a peer mentor affiliated with multiple chapters, when the screen loads, then only activities attributed to the coordinator's own chapter are included in the counts and charts
- Given the coordinator views their own coordinator stats dashboard, when activities are aggregated, then activities from peer mentors shared with other chapters are counted only once per chapter attribution
- Given the coordinator initiates a Bufdir export, when the export query executes, then only activities attributed to the coordinator's chapter are included in the exported dataset
- Given a peer mentor has zero activities attributed to the coordinator's chapter (all activities attributed to other chapters), when the coordinator views this peer mentor's stats, then the stats show zero with an informational note about chapter attribution
- Given the chapter scope resolver encounters an activity with no chapter attribution (legacy data), when resolving scope, then the activity falls back to the peer mentor's primary chapter affiliation
Business Value
If statistics are not properly scoped to chapter boundaries, coordinators and administrators will see inflated or misleading numbers that undermine trust in the reporting system. NHF's grant reporting to Bufdir is based on chapter-level activity counts, and inflated cross-chapter totals could result in incorrect grant applications or, worse, grant clawback requests if discrepancies are discovered during audits. Correct scoping protects both the individual chapters and the national organization.
Components
- Chapter Scope Resolver service
- Peer Mentor Stats Screen ui
- Coordinator Stats Screen ui
- Stats Async Notifier service
- Time Window Service service
- Stats Repository data
- Supabase Stats Database Views infrastructure
- Cross-Chapter Activity Query data
- Supabase Contact Chapter Adapter infrastructure