# [Release Iteration 1] PO adds a new collaborator to the existing Flow
User Story
As a Process Owner, I want to add new collaborator(s) to the flow, so that I can manage the collaborators working on a shared file

Pre-Requisite
The FLOW exists
Details
If a FLOW is initially created to request input, then adding collaborators will be for requesting input
If a FLOW is initially created just to share, then adding collaborators will be just the share
IF a FLOW created required users to sign in, adding collaborators will need sign in to Layer
IF a FLOW is creation is for guest users, adding new collaborators will be guest users
Messages cannot be sent as part of adding new collaborators into the flow
Miro Board
Reference to flow dig: https://miro.com/app/board/o9J_loSKlzI=/

Analytics
Create an event when new collaborator(s) is added to the flow. This event should be pushed to Segment for product and operational reports
Existing 1:1 FLOWS
This functionality, once implemented, must be available for all existing FLOWS
Scenario 1: PO adds a new collaborator to the existing FLOW
GIVEN the PO has already created a FLOW
WHEN the PO wants to add another collaborator the list
THEN the PO is presented with the call to action to add the collaborator to the FLOW

Note: This can be done on - 'FLOW LIST View' and 'FLOW DETAIL view' (see design)

Scenario 2: PO sees the new user reflected in the FLOW LIST view
GIVEN the PO has added a new collaborator to the FLOW
WHEN the PO checks the FLOW LIST view
THEN the PO can see that user is added to the list (see design)

Note that we do not need to show this on the activity feed when a collaborator is added. Only a backend event for this is sufficient for now.
Scenario 3: PO sees the new user reflected in the FLOW DETAIL view
GIVEN the PO has added a new collaborator to the FLOW
WHEN the PO checks the FLOW DETAIL (SpreadJs) view
THEN the PO can see that user is added to the list

Scenario 4: PO adds an existing user again into the FLOW
GIVEN the PO has created a FLOW with one or more collaborators
WHEN the PO adds a user
AND this user already exists in the FLOW
THEN PO is notified that the user is already in the FLOW (See design)

Scenario 5: Failure to add an new collaborator(s) to the FLOW
GIVEN the PO has already created a FLOW
WHEN the PO adds a new collaborator(s) to the FLOW
AND this fails
THEN PO sees the generic "something went wrong ... " error pop up
AND can try adding the user again after refreshing the application

Note that this is a rare scenario and not a blocker bug from a PO perspective.

Additional Notes
This option must be available for all the existing FLOWS once this story is implemented
If the share has happened with the G-sheets, the new collaborator should be provided access to shared file on PO's g-drive.
The first collaborator is assumed to be the collaborator for the guest page (until the "special link story is implemented 6041 )
E2E test to be covered as part of the story implementation
The file name for GSheet and Excel downloadable file to be updated to: "flow title - flow creation date.xlsx". The recipient should be removed.