Align Statistics with Bufdir Category Requirements
Bufdir has a specific taxonomy of activity types that they accept in reports. If peer mentors register activities using internal activity types that have not been mapped to a Bufdir category, those activities will be excluded from the official report — causing under-reporting of actual activity. The Bufdir alignment validator runs continuously against the stats data and surfaces a warning when activities exist without a valid Bufdir category mapping. This story connects the statistics view to the Bufdir category mapping configuration, so coordinators see alignment issues as part of their regular workflow rather than only at export time.
User Story
Acceptance Criteria
- Given I view the coordinator statistics screen, when there are activities with unmapped Bufdir categories, then a Bufdir alignment warning badge is shown on the stats screen
- Given I tap the alignment warning, when the detail view loads, then I see a list of activity types that are not mapped to Bufdir categories, with a count of affected records
- Given all activity types are mapped, when I view the stats screen, then no alignment warning is shown and a 'Bufdir-ready' indicator is visible
- Given an activity type is added by an admin without a Bufdir mapping, when new activities are registered with that type, then the alignment validator detects and flags the gap
- Given I want to fix an alignment issue, when I tap the activity type in the warning, then I am directed (or shown information) to contact an admin to update the category mapping config
Business Value
Unmapped activities are silently excluded from Bufdir reports, leading to under-reporting of peer mentor work and potentially reduced funding allocations. Proactive alignment validation allows coordinators to identify and resolve mapping gaps continuously throughout the year, ensuring every hour of peer mentor effort is captured and credited in the official Bufdir submission.
Components
- Bufdir Alignment Validator service
- Peer Mentor Stats Screen ui
- Coordinator Stats Screen ui
- Activity Category Mapping Configuration infrastructure
- Bufdir Category Mapper service
- Stats Repository data
- Supabase Stats Database Views infrastructure