Coordinator Statistics Dashboard Screen
Component Detail
Description
Main dashboard screen for coordinators showing aggregated statistics across their supervised peer mentor roster. Displays total activities, hours delivered, pending reimbursements, and active vs paused mentor counts with chart visualizations and filter controls.
coordinator-stats-dashboard-screen
Summaries
The Coordinator Statistics Dashboard is the primary management screen that gives program coordinators an at-a-glance view of their peer mentor roster's performance. It surfaces key business metrics — activity counts, hours of support delivered, reimbursement backlogs, and mentor availability — enabling faster, data-driven decisions without requiring manual report generation. By providing role-based views that adapt for both coordinators and organizational administrators, the dashboard scales to support different management tiers within the organization. This screen directly increases coordinator efficiency and improves program oversight, reducing the risk of undetected issues such as reimbursement bottlenecks or a high count of paused mentors going unaddressed.
This is a high-complexity mobile screen with five component dependencies: stats-summary-cards, monthly-activity-bar-chart, activity-type-donut-chart, stats-period-filter-bar, and peer-mentor-stats-list. All five must be completed and integrated before this screen can be considered done, making it a late-stage deliverable on the critical path. Timeline risk is significant — chart components (fl_chart) require careful performance tuning on lower-end devices, and role-based view switching adds conditional rendering complexity. API integration for aggregated stats must be available from the backend before meaningful UI testing can begin.
Plan for at least one dedicated performance and UX review cycle given the visual complexity. Filter interactions and deep-link navigation to mentor detail screens add additional QA scenarios.
The Coordinator Statistics Dashboard Screen is a high-complexity Flutter mobile screen acting as the top-level orchestrator for the stats feature. It composes five child components — stats-summary-cards, monthly-activity-bar-chart, activity-type-donut-chart, stats-period-filter-bar, and peer-mentor-stats-list — and manages shared filter state (period, activity type) that propagates to all children. It exposes `onFilterChanged(StatsPeriodFilter)` and `onActivityTypeFilterChanged(String?)` handlers that trigger data re-fetches and pass updated data down to chart components. Role-based rendering (coordinator vs org admin) must be driven by an injected auth context.
The screen operates exclusively in the mobile execution context and consumes activity, peer-mentor, and reimbursement data models. State management should handle concurrent loading states across multiple async data sources, with per-section error recovery to avoid full-screen failure on partial API errors.
Responsibilities
- Render summary stat cards for key KPIs
- Display fl_chart bar and donut charts
- Orchestrate filter bar and period selection
- Handle role-based view switching (coordinator vs org admin)
Interfaces
build(BuildContext context)
refreshDashboard()
onFilterChanged(StatsPeriodFilter filter)
onActivityTypeFilterChanged(String? activityTypeId)
navigateToPeerMentorDetail(String mentorId)
Relationships
Dependencies (5)
Components this component depends on
Used Integrations (1)
External integrations and APIs this component relies on