Bufdir Reporting & Export
Feature Detail
Description
Automates the generation of the activity reports required by Bufdir (the Norwegian Directorate for Children, Youth and Family Affairs) as a condition of receiving government grants. The goal articulated in all three workshops is a single button press that produces a complete, correctly formatted export covering the required period. Norse Digital Products will engage directly with Bufdir to agree on a simplified digital reporting format that works for all partner organisations. Until a live API exists, the feature must support structured data export (e.g. CSV or Excel) that maps the app's data model to Bufdir's current template. Document attachments (invitations, screenshots) required by NHF for Bufdir verification must be bundled or linked in the export.
Analysis
Eliminates the single most time-consuming administrative task across all four organisations. Directly de-risks grant funding by ensuring accurate, timely reporting. A key selling point for organisational adoption of the app.
Phase 3 feature. Build an export-service layer that queries activity records filtered by org, date range, and activity type. Map to Bufdir's column schema (configurable per org if formats differ). PDF and Excel output. Future: REST integration with Bufdir if they adopt an API. Audit log of all exports (who, when, what period). Requires Bufdir dialogue initiated by Norse Digital Products.
Components (211)
Shared Components
These components are reused across multiple features
User Interface (59)
Service Layer (52)
Data Layer (33)
Infrastructure (54)
User Stories (16)
As a As a Coordinator
I want the statistics view to validate that recorded activities align with Bufdir's reporting categories, and to be warned if any activities are uncategorized or in categories Bufdir does not recognize
So that I can proactively fix data quality issues before the reporting period ends, rather than discovering problems only at export time
- Given I view the coordinator statistics screen, when there are activities with unmapped Bufdir categories, then a Bufdir alignment warning badge is shown on the stats screen
- Given I tap the alignment warning, when the detail view loads, then I see a list of activity types that are not mapped to Bufdir categories, with a count of affected records
- Given all activity types are mapped, when I view the stats screen, then no alignment warning is shown and a 'Bufdir-ready' indicator is visible
- +2 more
As a As a Organization Administrator
I want the statistics view to validate that recorded activities align with Bufdir's reporting categories, and to be warned if any activities are uncategorized or in categories Bufdir does not recognize
So that I can proactively fix data quality issues before the reporting period ends, rather than discovering problems only at export time
- Given I view the coordinator statistics screen, when there are activities with unmapped Bufdir categories, then a Bufdir alignment warning badge is shown on the stats screen
- Given I tap the alignment warning, when the detail view loads, then I see a list of activity types that are not mapped to Bufdir categories, with a count of affected records
- Given all activity types are mapped, when I view the stats screen, then no alignment warning is shown and a 'Bufdir-ready' indicator is visible
- +2 more
As a As a Coordinator
I want to view a history of all previously generated Bufdir reports with their period, format, record count, and submission status, and to re-export any previous report if needed
So that I can maintain a clear audit trail of all Bufdir submissions and quickly regenerate a report if it needs to be resubmitted
- Given I navigate to the report history screen, when it loads, then I see a chronological list of all Bufdir exports with period, format, record count, and status
- Given I view the history screen, when summary metrics are loaded, then a metrics widget shows total reports generated, total activities reported, and total unique participants
- Given I tap a history list item, when the detail view opens, then I can see full export metadata and a download button to retrieve the stored file
- +3 more
As a As a Coordinator
I want to submit the validated report directly to Bufdir's API without leaving the app, and receive a confirmation reference number
So that I can complete the entire Bufdir reporting cycle in one place without manual file uploads to an external portal
- Given my organization has a Bufdir API integration configured, when I reach the export options, then a 'Submit to Bufdir' option is available in addition to file download
- Given I choose API submission, when I confirm, then the system formats the payload using the Bufdir schema config and submits via the API client
- Given the submission succeeds, when the response is received, then a confirmation screen shows the Bufdir reference number and submission timestamp
- +3 more
As a As a Coordinator
I want to select the organizational scope for a Bufdir report — whether for a single chapter, a region, or the entire national organization — so that the report reflects the correct hierarchical unit I am responsible for reporting
So that I can generate accurate reports that match the exact organizational scope that Bufdir expects from my role, without mixing data from other units
- Given I am a regional coordinator, when I open the Bufdir export flow, then the scope selector shows my region and all chapters within it as selectable scopes
- Given I select a specific scope, when the aggregation runs, then only activities attributed to units within the selected scope are included in the report
- Given the same activity could theoretically appear in multiple reports, when I run an export for scope A, then activities already exported in a narrower scope are flagged to prevent double-counting
- +3 more
As a As a Organization Administrator
I want to view a history of all previously generated Bufdir reports with their period, format, record count, and submission status, and to re-export any previous report if needed
So that I can maintain a clear audit trail of all Bufdir submissions and quickly regenerate a report if it needs to be resubmitted
- Given I navigate to the report history screen, when it loads, then I see a chronological list of all Bufdir exports with period, format, record count, and status
- Given I view the history screen, when summary metrics are loaded, then a metrics widget shows total reports generated, total activities reported, and total unique participants
- Given I tap a history list item, when the detail view opens, then I can see full export metadata and a download button to retrieve the stored file
- +3 more
As a As a Organization Administrator
I want to submit the validated report directly to Bufdir's API without leaving the app, and receive a confirmation reference number
So that I can complete the entire Bufdir reporting cycle in one place without manual file uploads to an external portal
- Given my organization has a Bufdir API integration configured, when I reach the export options, then a 'Submit to Bufdir' option is available in addition to file download
- Given I choose API submission, when I confirm, then the system formats the payload using the Bufdir schema config and submits via the API client
- Given the submission succeeds, when the response is received, then a confirmation screen shows the Bufdir reference number and submission timestamp
- +3 more
As a As a Organization Administrator
I want to select the organizational scope for a Bufdir report — whether for a single chapter, a region, or the entire national organization — so that the report reflects the correct hierarchical unit I am responsible for reporting
So that I can generate accurate reports that match the exact organizational scope that Bufdir expects from my role, without mixing data from other units
- Given I am a regional coordinator, when I open the Bufdir export flow, then the scope selector shows my region and all chapters within it as selectable scopes
- Given I select a specific scope, when the aggregation runs, then only activities attributed to units within the selected scope are included in the report
- Given the same activity could theoretically appear in multiple reports, when I run an export for scope A, then activities already exported in a narrower scope are flagged to prevent double-counting
- +3 more
As a As a Coordinator
I want to select a reporting period (using presets like quarterly or annually, or a custom date range) and see the record count before committing to an export
So that I can ensure I am exporting the correct time window and have sufficient data before generating the official Bufdir report
- Given I am on the Bufdir export flow, when I open the period selection screen, then I see a list of preset periods (current quarter, last quarter, current year, last year, custom range)
- Given I select a preset period, when the selection is confirmed, then a record count banner shows the number of activities within that period
- Given I choose a custom date range, when I set start and end dates, then the picker validates the range and shows a record count for those dates
- +2 more
As a As a Coordinator
I want to preview the fully structured Bufdir report — including all required fields, section breakdowns, and a validation summary — before generating the final export file
So that I can catch data gaps or validation errors and fix them before submitting an incorrect report to Bufdir
- Given I have selected a reporting period, when I proceed to the preview screen, then I see all Bufdir-required sections rendered with aggregated data from the selected period
- Given the report has missing required fields, when the preview loads, then a validation summary banner lists each validation failure with a clear description
- Given the report passes all validations, when I view the validation banner, then it shows a green 'Report is ready' status
- +3 more
As a As a Coordinator
I want to select an export format (Excel, CSV, or PDF), confirm the export, and download the generated file directly to my device
So that I can submit the report to Bufdir in the exact format they require, or share it internally for review
- Given I am on the export trigger screen, when I view format options, then I see Excel, CSV, and PDF as selectable formats
- Given I select a format, when I tap Generate Report, then an export confirmation dialog shows the scope, period, record count, and format before I confirm
- Given I confirm the export, when the orchestrator processes the request, then an export progress indicator is displayed and the UI remains responsive
- +4 more
As a As a Coordinator
I want the system to automatically aggregate all peer mentor activities within the selected period — deduplicated, categorized to Bufdir's taxonomy, and scoped to my organization's hierarchy — so I do not have to compile data manually
So that I can generate an accurate Bufdir report in seconds rather than spending hours consolidating spreadsheets
- Given I initiate report generation, when the aggregation starts, then an aggregation summary widget and progress indicator are displayed
- Given activities span multiple chapters under my organization, when aggregation completes, then the report scope is correctly limited to my hierarchy and cross-chapter activities are attributed once
- Given the same participant appears in multiple activities, when deduplication runs, then the participant is counted only once in the participant total
- +3 more
As a As a Organization Administrator
I want to select a reporting period (using presets like quarterly or annually, or a custom date range) and see the record count before committing to an export
So that I can ensure I am exporting the correct time window and have sufficient data before generating the official Bufdir report
- Given I am on the Bufdir export flow, when I open the period selection screen, then I see a list of preset periods (current quarter, last quarter, current year, last year, custom range)
- Given I select a preset period, when the selection is confirmed, then a record count banner shows the number of activities within that period
- Given I choose a custom date range, when I set start and end dates, then the picker validates the range and shows a record count for those dates
- +2 more
As a As a Organization Administrator
I want to preview the fully structured Bufdir report — including all required fields, section breakdowns, and a validation summary — before generating the final export file
So that I can catch data gaps or validation errors and fix them before submitting an incorrect report to Bufdir
- Given I have selected a reporting period, when I proceed to the preview screen, then I see all Bufdir-required sections rendered with aggregated data from the selected period
- Given the report has missing required fields, when the preview loads, then a validation summary banner lists each validation failure with a clear description
- Given the report passes all validations, when I view the validation banner, then it shows a green 'Report is ready' status
- +3 more
As a As a Organization Administrator
I want to select an export format (Excel, CSV, or PDF), confirm the export, and download the generated file directly to my device
So that I can submit the report to Bufdir in the exact format they require, or share it internally for review
- Given I am on the export trigger screen, when I view format options, then I see Excel, CSV, and PDF as selectable formats
- Given I select a format, when I tap Generate Report, then an export confirmation dialog shows the scope, period, record count, and format before I confirm
- Given I confirm the export, when the orchestrator processes the request, then an export progress indicator is displayed and the UI remains responsive
- +4 more
As a As a Organization Administrator
I want the system to automatically aggregate all peer mentor activities within the selected period — deduplicated, categorized to Bufdir's taxonomy, and scoped to my organization's hierarchy — so I do not have to compile data manually
So that I can generate an accurate Bufdir report in seconds rather than spending hours consolidating spreadsheets
- Given I initiate report generation, when the aggregation starts, then an aggregation summary widget and progress indicator are displayed
- Given activities span multiple chapters under my organization, when aggregation completes, then the report scope is correctly limited to my hierarchy and cross-chapter activities are attributed once
- Given the same participant appears in multiple activities, when deduplication runs, then the participant is counted only once in the participant total
- +3 more