DPL-440 Cardinal sample import - single manifest

[KatyTaylor]

User story As a member of the Bioresource team, who receives samples from multiple collection centres per day, I would like to be able to import them all at once into Sequencescape, rather than having to create a manifest per collection centre. This will reduce the manual work I have to do.

Who are the primary contacts for this story @KatyTaylor Laura L (will do UAT)

Acceptance criteria Decided by team consensus to go for the following solution, where we move how the collection centre information is stored, from the 'Supplier' to a new field against the sample.

• [ ] There is a new (free text) field on the sample_metadata table, called 'collected_by' (to match the naming of the ENA field https://www.ebi.ac.uk/ena/browser/view/ERC000011) - this will be used to store the collection centre.
• [ ] The new field should show on the sample pages in Sequencescape, like other sample metadata fields.
• [ ] Above field is available in the Cardinal tube manifest, as a dropdown with limited values to select. See the table under 'Creating Suppliers' in the documentation for the list of values that should go in the dropdown.
• [ ] This field is back-populated on existing Cardinal samples, using the manifest -> supplier link.
• [ ] The pooling step in the Cardinal pipeline that uses the collection centre information should be updated to get that information from the new field instead (https://github.com/sanger/limber/blob/9c4a9d7fbf5740fe969db930084e7580f6b49620/app/models/labware_creators/cardinal_pools_plate.rb#L147)
• [ ] Documentation 'Importing samples into Sequencescape' and 'Creating Suppliers' sections are updated to reflect new process. The 'supplier' associated with the manifest should now be filled out as 'Sanger' or similar.
• [ ] Inform Laura, Stephen W, Vivek & Matiss once this has gone live.

References When this story is done, the following stories should be deprecated (as they described similar but alternative approaches):

• https://github.com/sanger/sequencescape/issues/3367
• https://github.com/sanger/sequencescape/issues/3368
• https://github.com/sanger/sequencescape/issues/3401

Additional information It's not necessary to send this field to the warehouse (although no harm in doing so), because the existing collection centre data is not currently sent. We have this story https://github.com/sanger/sequencescape/issues/3360 to implement it if needed.

See process diagram, with this story in green - https://lucid.app/lucidchart/d268383d-cc23-45e3-8096-daaabaefb04c/edit?viewport_loc=-651%2C-235%2C4651%2C2240%2C0_0&invitationId=inv_d5c862bf-3813-4e84-ac21-c21e492c763d#

N.B. The BioResource team currently process around 40 samples per day for the Cardinal project, and this is expected to ramp up to around 80 per day.