Attach a Document to an Activity from the Summary Screen

After completing an activity registration, the user sees a Document Attach Widget embedded in the activity summary screen. This widget shows any already-attached documents in a horizontal scroll list and presents an add button. Tapping the add button opens the File Upload Screen where the user can select or capture a file. The attachment is then linked to the activity record and visible in subsequent detail views. Both peer mentors attaching their own activity documents and coordinators managing documents on behalf of their organization can use this flow.

HIGH story-document-attachment-coordinator-001 5 pts

Story Points

High

Priority

Document Attachment to Activities

Feature

User Story

As a user

I want to attach a supporting document to an activity directly from the activity summary screen

So that So that documentary evidence such as event invitations, flyers, or Facebook screenshots is permanently linked to the specific activity record for Bufdir audit purposes

Acceptance Criteria

Given the user is on the activity summary screen, when the document attach widget is displayed, then it shows a horizontal scroll list of existing attachments (empty state if none) and an add button
Given the user taps the add button, when the file upload screen opens, then the user is presented with options to capture a photo via camera, pick from gallery, or select a file from the device
Given the user selects a file, when the file size exceeds 10 MB, then an error message is shown client-side and the upload is blocked before any network request is made
Given the user selects a valid file, when the upload completes successfully, then the new document thumbnail appears in the attach widget horizontal scroll list immediately
Given the activity already has 5 attached documents, when the user taps the add button, then the add button is disabled or a message explains the 5-file limit has been reached
Given a document is uploaded successfully, when the user navigates away and returns to the activity detail view, then all previously attached documents remain visible

Business Value

NHF requires documentary evidence for Bufdir grant audits — invitations, promotional screenshots, and printed announcements must be traceable to the specific activity they support. This story delivers the core attachment capability that eliminates parallel paper or email archives and creates a single source of truth for compliance documentation.

Components

Document Attachment to Activities

Related Feature

Coordinator

User Role