Filter and Search Report History by Period and Status
The report history screen must provide filter controls allowing coordinators to narrow the list by calendar year (dropdown), reporting period type (quarterly, semi-annual, annual), and submission status (success, failed, re-exported). A search field should support free-text search against period labels. Filter state should persist for the session so the coordinator does not lose their context when navigating away and returning to the history screen.
User Story
Acceptance Criteria
- Given the coordinator selects '2024' from the year filter, when the filter is applied, then only reports with a submission date or reporting period in 2024 are shown
- Given the coordinator selects 'Failed' from the status filter, when the filter is applied, then only reports with a failed or error status are listed
- Given the coordinator types '2024 Q2' in the search field, when results update, then only report entries matching that period label are displayed
- Given the coordinator applies multiple filters simultaneously, when the filtered list is shown, then only reports matching ALL active filters are displayed
- Given the coordinator navigates to a report detail and then presses back, when the history screen reappears, then the previously applied filters are still active
- Given no reports match the active filters, when the list updates, then a clear empty state message is shown explaining the filter criteria with an option to clear all filters
Business Value
Organizations with multi-year reporting history may accumulate dozens of report entries. Without filtering, coordinators waste time scrolling and risk overlooking a failed submission. Fast, filterable access to history reduces coordinator workload and ensures nothing slips through, protecting grant funding continuity.
Components
- Report History Screen ui
- Report History List Item Widget ui
- Report History Service service
- Report History Repository data
- Period Selection BLoC infrastructure