Attach Supporting Documents When Registering an Activity

Peer mentors often facilitate group activities with supporting materials — printed invitations, Facebook event screenshots, or organization flyers. These documents serve as proof that the activity took place and provide context for Bufdir verification. During or after the activity registration wizard, the peer mentor should be able to open an attachment picker, select one or more files from their device camera roll or file system, preview thumbnails, and confirm the upload before submission. The attachment picker must comply with WCAG 2.2 AA accessibility standards, support screen reader navigation, and work within the cognitive-load constraints of the registration flow.

HIGH story-document-attachments-for-activities-organization-admin-001 5 pts

Story Points

High

Priority

Document Attachments for Activities

Feature

User Story

As a Organization Administrator

I want to attach documents such as invitations, event flyers, or screenshots when registering an activity

So that the activity record has verifiable supporting evidence for Bufdir auditing and organizational reporting

Acceptance Criteria

Given I am on the activity registration confirmation step, when I tap 'Add Attachment', then the attachment picker UI opens showing camera and file library options
Given the attachment picker is open, when I select an image or PDF from my device, then a thumbnail preview is shown before confirming
Given I have selected a file, when I confirm the selection, then the file is uploaded to Supabase Storage and linked to the activity record via the activity attachment repository
Given the upload is in progress, when connectivity is interrupted, then the upload retries automatically on reconnect and I am notified of the outcome
Given the attachment picker UI is open, when a screen reader is active, then all controls are properly labelled and focusable in logical tab order
Given a file larger than 10 MB is selected, when I attempt to attach it, then an accessible error message explains the size limit and suggests compression

Business Value

NHF explicitly requires document attachments (invitations, Facebook screenshots) for Bufdir audit verification. Without this feature, coordinators must chase proof retroactively, and submitted activity reports risk rejection during Bufdir review. Enabling inline attachment at registration time reduces administrative overhead, increases report completeness, and directly supports continued Bufdir funding eligibility for member organizations.

Components

Document Attachments for Activities

Related Feature

Organization Administrator

User Role