Adding and removing files to email correspondence

• As a FOI Analyst
• I want to add or remove files to my emails
• so that I can include files in correspondence about the FOI request

Assumptions & Scope
What are the assumptions for this story?
Users should be allowed to upload multiple files using the functionality noted below.
Maximum file size is in line with IAO standards (20mb) - For MVP, any files larger can be shared by an alternate means

What is in and not in scope?

Acceptance Criteria

Scenario 1: Adding a file using the Add Files button

• GIVEN ... I am on the Email Details page of the Correspondence page
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/657932512
• WHEN ... I click the "add Files" button
• THEN ... a generic window will pop up allowing me to select files from my computer
• AND ... upon selecting the file, the file name will appear linked, in the drag and drop component with an "x" next to it and the text "Drag and drop request letter(s) or" will no longer appear
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/746058896

Scenario 2: Adding a file by dragging and drop

• GIVEN ... I am on the Email Details page of the Correspondence page
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/657932512
• WHEN ... I drag a file into the Drag and drop component of the page
• THEN ... the file name will appear linked, in the drag and drop component with an "x" next to it and the text "Drag and drop request letter(s) or" will no longer appear
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/746058896

Scenario 3: Removing file attachment

• GIVEN ... A file has been attached to the Email Details page of the Correspondence page and is appearing in the drag and drop component
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/746058896
• WHEN ... I click the "x" next to the file
• THEN ... the file will disappear from the drag and drop component and the text "Drag and drop request letter(s) or" and button "Add files" will appear again
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/657932512

Scenario 4: Removing multiple file attachments

• GIVEN ... Multiple files have been attached to the drag and drop component, each one will have an "x" next to it
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/746058896
• WHEN ... I click the "x" next to a file
• THEN ... the file will disappear from the drag and drop component but the other files will remain. I have the ability to remove one file at a time, until the last file is removed, in which case the text "Drag and drop request letter(s) or" and button "Add files" will appear again
  https://jacklyn808742.invisionapp.com/console/share/3W2O64AP5C/657932512

Dependencies? What is the impact of this dependency? (If so, link dependency in the ticket, make it visible in a team´s backlog)

Validation Rules? (If yes, list here)

Definition of Ready

1. Is there a well articulated User Story?
2. Is there Acceptance Criteria that covers all scenarios (happy/sad paths)?
3. If there is a user interface, is there a design?
4. Does the user story need user research/validation?
5. Does this User Story needs stakeholder approval?
6. Design / Solution accepted by Product Owner
7. Is this user story small enough to be completed in a Sprint? Should it be split?
8. Are the dependencies known/ understood? (technical, business, regulatory/policy)
9. Has the story been estimated?

Definition of Done

1. Passes developer unit tests
2. Passes peer code review
3. If there's a user interface, passes UX assurance
4. Passes QA of Acceptance Criteria with verification in Dev and Test
5. Confirm Test cases built and succeeding
6. No regression test failures
7. Test coverage acceptable by Product Owner
8. Ticket ready to be merged to master or story branch
9. Developer to list Config changes/ Update documents and designs
10. Can be demoed in Sprint Review
11. Tagged as part of a Release
12. Feature flagged if required
13. Change Management activities done?

Start at the Email Details page within the Correspondence page and review the linked designs for the empty and attached-file states. Trace the existing correspondence email flow and its file-upload component, then verify file selection, drag-and-drop, removal, multiple attachments, and the 20 MB limit against the four scenarios.