Filter Assignment List by Status, Peer Mentor, Team, or Time Range
Coordinators managing large peer mentor teams need flexible filtering to reduce cognitive load when working through assignment queues. The assignment filter bar is a sticky toolbar on the assignment status screen that allows multi-dimensional filtering: by lifecycle state (e.g., show only 'dispatched' or 'accepted'), by individual peer mentor, by team or organizational unit, or by time range of last state change. Filter state is preserved across navigation using BLoC/Riverpod state management so coordinators do not lose their filter context when navigating to an assignment detail and returning. Filters are additive — multiple active filters narrow the result set.
User Story
Acceptance Criteria
- Given I am on the coordinator assignment status screen, when I open the filter bar, then I see filter options for: lifecycle state, peer mentor, team/organizational unit, and time range
- Given I select a lifecycle state filter (e.g., 'Dispatched'), when the filter is applied, then only assignments in that state are shown in the list
- Given I select a specific peer mentor from the filter, when the filter is applied, then only that peer mentor's assignments are shown
- Given I apply multiple filters simultaneously, when the list updates, then only assignments matching ALL selected filters are shown (AND logic)
- Given I have active filters and navigate to an assignment detail page then return, when the list reloads, then my previously selected filters are still applied
- Given I want to clear all filters, when I tap the 'Clear filters' action, then all filters are reset and the full scoped list is shown
- Given no assignments match the active filter combination, when the list updates, then an empty state message is shown explaining that no assignments match the current filters
Business Value
Coordinators managing large peer mentor teams cannot efficiently triage a flat unfiltered list. Filtering reduces the time to identify assignments needing attention from minutes to seconds, directly reducing administrative overhead and enabling coordinators to focus supervision effort where it is most needed.