high complexity extracted Statistics Confidence: 100%
4
Components
39
Shared
0
User Stories
Yes
Analyzed

Description

Coordinator Team Reports provides coordinators with a consolidated view of activity across all peer mentors they oversee within their local association. The report screen shows aggregate totals (activities, hours, contacts reached) broken down by individual peer mentor, time period, and activity type. Coordinators can drill into any peer mentor's contribution, identify inactive volunteers who may need follow-up, and export a summary for internal reporting or Bufdir submission preparation. The feature is accessible from both the mobile app and the Admin Web Portal, with the admin portal variant offering richer filtering and CSV export. All data is scoped to the coordinator's organisation and association - no cross-tenant data is ever visible. The screen is designed to support the weekly check-in workflow described by coordinators in the NHF and HLF workshops, giving them actionable oversight without requiring manual Excel aggregation.

Analysis

Business Value

Coordinators are the operational backbone of every participating organisation, yet they currently rely on manually aggregated Word and Excel reports to understand what their team is doing. This creates a reporting lag of days or weeks, makes it difficult to spot underperforming or overwhelmed peer mentors in time to intervene, and consumes coordinator time that could be spent on actual support work. A real-time team report view eliminates this overhead entirely. The feature is also a prerequisite for Bufdir reporting automation: the same aggregated data that coordinators use for internal oversight feeds directly into the Bufdir export pipeline. Building team reports as a first-class feature rather than a reporting afterthought ensures the data model is correct, auditable, and ready for regulatory submission from day one, reducing compliance risk for all four organisations.

Implementation Notes

Team report data is fetched from the REST API (`GET /api/v1/reports/team`) which accepts organisation_id, association_id, date_range, and optional peer_mentor_id parameters. The endpoint aggregates from the activities table with a JOIN on users and organisation_memberships, enforcing tenant isolation at the query level. Response is paginated by peer mentor to keep payload sizes manageable for large associations (NHF has up to 1 400 local chapters). On the mobile side, a Riverpod FutureProvider fetches and caches the report; pull-to-refresh triggers a re-fetch. The Admin Web Portal renders the same data via a server component with React Table for sorting and filtering, plus a CSV export endpoint. Role guard middleware on both client and API ensures only Coordinator and Org Admin roles can access team-level data. The inactive-mentor flag is computed server-side (no activity in configurable N days, default 30) and surfaced as a highlighted row in the report table.

Components (43)

User Interface (3)

Service Layer (1)

Shared Components

These components are reused across multiple features

User Stories

No user stories have been generated for this feature yet.