Coordinator Statistics Dashboard
Feature Detail
Description
Provides coordinators with a real-time summary of activity across their peer mentor roster: total activities registered this month and year, hours of peer mentor support delivered, reimbursement amounts pending approval, and the number of active versus paused peer mentors. The dashboard serves both operational oversight and motivational purposes. For individual peer mentors, a personal statistics view shows their own contribution over time — feeding into the gamification 'Spotify Wrapped' concept planned for Phase 4. The coordinator view aggregates across all peer mentors they supervise and supports filtering by time period and activity type.
Analysis
Gives coordinators situational awareness without manual Excel work. Provides early signals of underreporting or inactive peer mentors who may need support. Lays the data foundation for the Phase 4 gamification and Wrapped features.
Queries run against Supabase views pre-aggregated by org_id + coordinator_id + month. Cache results for 15 minutes to avoid repeated heavy queries. Coordinator sees only their own peer mentors (RLS). Org admin sees all coordinators. Charts: bar chart for monthly activity count, donut for activity type breakdown. Flutter charts library (e.g. fl_chart).
Components (206)
Shared Components
These components are reused across multiple features
User Interface (59)
Service Layer (52)
Data Layer (33)
Infrastructure (54)
User Stories (14)
As a As a Coordinator
I want to switch to a personal stats view showing only my own registered activities, hours, and activity type breakdown
So that I can track my own contributions separately from my team oversight role, since coordinators may also register peer support activities themselves
- Given the coordinator is on the statistics screen, When they tap 'My Activity' toggle, Then all dashboard widgets switch to display only the coordinator's own activity data
- Given the personal view is active, When the coordinator selects a different time period, Then personal stats update for that period
- Given the coordinator switches back to 'My Team' view, When the switch occurs, Then team statistics are restored without a full data reload if cached
- +2 more
As a As a Organization Administrator
I want to switch to a personal stats view showing only my own registered activities, hours, and activity type breakdown
So that I can track my own contributions separately from my team oversight role, since coordinators may also register peer support activities themselves
- Given the coordinator is on the statistics screen, When they tap 'My Activity' toggle, Then all dashboard widgets switch to display only the coordinator's own activity data
- Given the personal view is active, When the coordinator selects a different time period, Then personal stats update for that period
- Given the coordinator switches back to 'My Team' view, When the switch occurs, Then team statistics are restored without a full data reload if cached
- +2 more
As a As a Coordinator
I want to see a bar chart showing the number of activities registered per month across my team
So that I can quickly identify trends, seasonal dips, and months where engagement dropped so I can intervene proactively
- Given the coordinator is on the statistics screen, When the monthly chart renders, Then each visible month in the selected window is represented by a bar with the correct activity count
- Given the coordinator taps a bar on the chart, When the navigation fires, Then they are taken to an activity list filtered to that specific month
- Given a screen reader is active, When the chart is focused, Then each bar announces its month name and activity count via semantic labels
- +2 more
As a As a Coordinator
I want to see a donut chart breaking down activities by type (e.g., home visit, phone call, group session, digital meeting) for the selected period
So that I can understand which types of peer support are being delivered most and ensure the mix aligns with Bufdir category requirements
- Given the coordinator views the statistics screen, When the donut chart renders, Then each activity type in the selected period is shown as a segment with a percentage label
- Given the organization uses custom activity type labels, When the chart legend renders, Then labels match the organization's configured terminology not generic defaults
- Given the coordinator taps a donut segment, When the filter applies, Then the peer mentor stats list below updates to show only activities of the tapped type
- +2 more
As a As a Coordinator
I want to see a Bufdir alignment indicator on the statistics screen that tells me whether my chapter's activity data meets the required reporting thresholds and category distributions for the current grant period
So that I can identify gaps before the Bufdir reporting deadline and coach peer mentors to register missing activities while there is still time to correct the data
- Given the coordinator views the statistics screen with 'This Year' selected, When the Bufdir alignment section renders, Then it shows an overall status indicator (on track / at risk / below threshold)
- Given one or more activity categories are below the Bufdir minimum threshold, When the alignment section renders, Then each shortfall category is listed with the current count and the required minimum
- Given the coordinator taps a shortfall category, When navigation fires, Then they are taken to the peer mentor stats list filtered to that activity type so they can identify who to follow up with
- +2 more
As a As a Organization Administrator
I want to see a bar chart showing the number of activities registered per month across my team
So that I can quickly identify trends, seasonal dips, and months where engagement dropped so I can intervene proactively
- Given the coordinator is on the statistics screen, When the monthly chart renders, Then each visible month in the selected window is represented by a bar with the correct activity count
- Given the coordinator taps a bar on the chart, When the navigation fires, Then they are taken to an activity list filtered to that specific month
- Given a screen reader is active, When the chart is focused, Then each bar announces its month name and activity count via semantic labels
- +2 more
As a As a Organization Administrator
I want to see a donut chart breaking down activities by type (e.g., home visit, phone call, group session, digital meeting) for the selected period
So that I can understand which types of peer support are being delivered most and ensure the mix aligns with Bufdir category requirements
- Given the coordinator views the statistics screen, When the donut chart renders, Then each activity type in the selected period is shown as a segment with a percentage label
- Given the organization uses custom activity type labels, When the chart legend renders, Then labels match the organization's configured terminology not generic defaults
- Given the coordinator taps a donut segment, When the filter applies, Then the peer mentor stats list below updates to show only activities of the tapped type
- +2 more
As a As a Organization Administrator
I want to see a Bufdir alignment indicator on the statistics screen that tells me whether my chapter's activity data meets the required reporting thresholds and category distributions for the current grant period
So that I can identify gaps before the Bufdir reporting deadline and coach peer mentors to register missing activities while there is still time to correct the data
- Given the coordinator views the statistics screen with 'This Year' selected, When the Bufdir alignment section renders, Then it shows an overall status indicator (on track / at risk / below threshold)
- Given one or more activity categories are below the Bufdir minimum threshold, When the alignment section renders, Then each shortfall category is listed with the current count and the required minimum
- Given the coordinator taps a shortfall category, When navigation fires, Then they are taken to the peer mentor stats list filtered to that activity type so they can identify who to follow up with
- +2 more
As a As a Coordinator
I want to filter all statistics on the dashboard using preset time windows (current week, current month, last 3 months, current year) as well as a custom date range picker
So that I can compare performance across different reporting periods and prepare data for quarterly or annual Bufdir reports without manual calculation
- Given the coordinator is on the statistics screen, When they tap a period preset chip, Then all dashboard widgets refresh to show data for that period only
- Given the coordinator selects 'Custom Range', When the date picker appears, Then they can select a start and end date and all widgets update accordingly
- Given a time window is selected, When the coordinator navigates to a detail screen and returns, Then the same time window remains active
- +2 more
As a As a Coordinator
I want to see a dashboard with summary cards showing total activities registered, number of active peer mentors, total hours contributed, and unique contacts reached within my chapter
So that I can instantly assess the overall health and productivity of my peer mentor team without having to dig through individual records
- Given the coordinator opens the statistics screen, When the data loads, Then four summary cards are displayed: Total Activities, Active Peer Mentors, Total Hours, and Unique Contacts
- Given the dashboard is loaded, When the coordinator taps a summary card, Then they are navigated to the corresponding detail list filtered by the current time window
- Given the coordinator belongs to multiple chapters, When the dashboard loads, Then statistics are scoped to the currently active chapter context
- +2 more
As a As a Coordinator
I want to see a ranked list of all peer mentors in my chapter showing each mentor's activity count, total hours, and last activity date for the selected period
So that I can identify which mentors are active, which are inactive, and prioritize follow-up conversations with those who have not registered any activities recently
- Given the coordinator views the statistics screen, When the peer mentor list renders, Then each mentor shows their name, activity count, total hours, and last activity date
- Given the list is rendered, When the coordinator taps a column header to sort, Then the list re-orders accordingly without a full data reload
- Given a mentor has zero activities in the selected period, When they appear in the list, Then they are visually distinguished (e.g., dimmed row with a 'No activity' badge)
- +2 more
As a As a Organization Administrator
I want to filter all statistics on the dashboard using preset time windows (current week, current month, last 3 months, current year) as well as a custom date range picker
So that I can compare performance across different reporting periods and prepare data for quarterly or annual Bufdir reports without manual calculation
- Given the coordinator is on the statistics screen, When they tap a period preset chip, Then all dashboard widgets refresh to show data for that period only
- Given the coordinator selects 'Custom Range', When the date picker appears, Then they can select a start and end date and all widgets update accordingly
- Given a time window is selected, When the coordinator navigates to a detail screen and returns, Then the same time window remains active
- +2 more
As a As a Organization Administrator
I want to see a dashboard with summary cards showing total activities registered, number of active peer mentors, total hours contributed, and unique contacts reached within my chapter
So that I can instantly assess the overall health and productivity of my peer mentor team without having to dig through individual records
- Given the coordinator opens the statistics screen, When the data loads, Then four summary cards are displayed: Total Activities, Active Peer Mentors, Total Hours, and Unique Contacts
- Given the dashboard is loaded, When the coordinator taps a summary card, Then they are navigated to the corresponding detail list filtered by the current time window
- Given the coordinator belongs to multiple chapters, When the dashboard loads, Then statistics are scoped to the currently active chapter context
- +2 more
As a As a Organization Administrator
I want to see a ranked list of all peer mentors in my chapter showing each mentor's activity count, total hours, and last activity date for the selected period
So that I can identify which mentors are active, which are inactive, and prioritize follow-up conversations with those who have not registered any activities recently
- Given the coordinator views the statistics screen, When the peer mentor list renders, Then each mentor shows their name, activity count, total hours, and last activity date
- Given the list is rendered, When the coordinator taps a column header to sort, Then the list re-orders accordingly without a full data reload
- Given a mentor has zero activities in the selected period, When they appear in the list, Then they are visually distinguished (e.g., dimmed row with a 'No activity' badge)
- +2 more