View Statistics Aligned with Bufdir Reporting Categories
The statistics dashboard should include a view or section that maps the peer mentor's logged activities to the Bufdir reporting categories. This provides transparency about how their work translates into the official reporting that supports the organization's government grant applications. The bufdir-alignment-validator component ensures that statistics data is consistent with Bufdir's expected format and that category mappings are correctly applied. This is particularly relevant for peer mentors who want to understand the formal value of their contribution.
User Story
Audience Summaries
Bufdir compliance is a non-negotiable requirement for all four partner organizations, as government grant funding depends on accurate reporting to this authority. By surfacing Bufdir category alignment directly in the peer mentor's personal statistics view, the organization creates a data quality feedback loop at the source: mentors who see how their logged activities are classified are more likely to log them correctly in the future. This reduces coordinator and administrator time spent correcting miscategorized entries during reporting periods, lowering operational costs. It also strengthens the organization's credibility with government funders by demonstrating systematic compliance controls.
For organizations whose sustainability depends on grant renewal, this feature directly protects a critical revenue stream and reduces the risk of reporting errors that could jeopardize funding.
This story has a low priority rating but is tightly coupled to the Bufdir reporting requirement that all four organizations have classified as MUST HAVE. Delivery depends on two upstream stories being completed first: the core activity statistics dashboard and the period-filter functionality. The primary complexity lies in implementing the category mapping logic through the bufdir-alignment-validator component, which must correctly translate organization-specific activity terminology into official Bufdir category labels. The team will need to coordinate with organization administrators to obtain and validate the current Bufdir category taxonomy.
Acceptance criteria include an 'unclassified' fallback state, dynamic mapping updates when administrators change categories, and full screen reader accessibility compliance. Testing should include both unit tests for the mapping logic and user acceptance testing with actual peer mentors to verify the category labels are interpretable. Rollout should be staged after the parent dashboard stories are stable.
Implementation requires building a Bufdir alignment section within the existing statistics dashboard, using the bufdir-alignment-validator component to transform raw activity records into Bufdir-compliant category groupings. The mapping layer needs to read a configurable category mapping table (maintained by administrators) and apply it at query time, not display time, to ensure counts are accurate. Activities with no matching Bufdir category must be routed to an 'Other/Unclassified' bucket with a user-visible flag. The mapping configuration must be reactive: when an administrator updates the mapping, subsequent dashboard loads must reflect the new groupings without requiring a data migration.
Accessibility is an explicit acceptance criterion — the category breakdown must be implemented with semantic HTML (e.g., definition lists or properly labelled tables) so screen readers announce category name and count in logical order. Edge cases to handle include activities that could map to multiple Bufdir categories (disambiguation rule needed) and empty states when no activities exist in a period.
Acceptance Criteria
- Given I am viewing my statistics, When I navigate to the Bufdir alignment section, Then I see my activities grouped by Bufdir-compliant categories with counts per category
- Given my logged activities use organization-specific terminology, When displayed in the Bufdir view, Then they are correctly mapped to the appropriate Bufdir category labels
- Given an activity I logged does not map to a recognized Bufdir category, When it is displayed, Then it appears in an 'Other' or 'Unclassified' bucket and I am informed it may not appear in official Bufdir reports
- Given the Bufdir category mappings are updated by the organization administrator, When I next view the dashboard, Then the categorization reflects the updated mappings
- Given I am using a screen reader, When I navigate the Bufdir category breakdown, Then each category is announced with its name and count in a logical reading order
Business Value
Bufdir compliance is identified as a MUST HAVE requirement across all four organizations. Exposing Bufdir category alignment in the peer mentor's personal view creates a feedback loop that improves data quality at the point of entry — mentors who understand how their activities are categorized are more likely to log them correctly, reducing manual correction work for coordinators and administrators during reporting periods.
Components
- Bufdir Alignment Validator service
- Stats Repository data
- Stats Data Models data
- Supabase Stats Database Views infrastructure
- Coordinator Statistics BLoC infrastructure
- Personal Statistics Service service