Preview and Validate Report Before Final Export
Before committing to a Bufdir export, coordinators need confidence that the generated report is correct and complete. The preview screen must render the report in Bufdir section structure — showing each required field, its aggregated value, and a validation status indicator. A summary banner must highlight any fields that fail Bufdir validation rules (missing values, out-of-range numbers, category mismatches). The coordinator should also be able to compare the current period data against the previous period to spot anomalies such as unexpectedly low activity counts that might indicate underreporting. The preview must be fully accessible with screen reader support.
User Story
Acceptance Criteria
- Given the coordinator proceeds to preview, when the preview screen loads, then all Bufdir report sections are rendered with their field names, aggregated values, and validation status icons
- Given there are validation errors in the report, when the preview loads, then a validation summary banner is displayed at the top listing all failed fields with explanations
- Given the coordinator wants to compare with prior period, when they tap the period comparison toggle, then a diff view shows the delta between current and previous period values for each field
- Given all validations pass, when the coordinator reviews the preview, then a green confirmation indicator is displayed and the export button is enabled
- Given at least one critical validation fails, when the coordinator attempts to export, then the export is blocked and the coordinator is directed to resolve the issue
- Given the coordinator uses a screen reader, when navigating the preview, then all field labels, values, and validation statuses are announced correctly via accessibility semantics
Business Value
A pre-export validation and preview step prevents submission of incorrect reports that would be rejected by Bufdir, causing grant delays of weeks or months. Period-over-period comparison surfaces underreporting issues early — for example, when a local chapter had significantly lower activity than expected, allowing coordinators to investigate and correct before the submission deadline rather than after rejection.
Components
- Bufdir Report Preview Screen ui
- Bufdir Report Section Widget ui
- Bufdir Field Row Widget ui
- Validation Summary Banner ui
- Period Comparison Diff View ui
- Bufdir Preview Service service
- Bufdir Report Structure Mapper service
- Bufdir Field Validation Service service
- Bufdir Preview Repository data
- Bufdir Preview Accessibility Utilities infrastructure
- Bufdir Alignment Validator service
- Export Preview Panel ui