Bulk PDF Upload¶
Project admins upload a folder of full-text PDFs for a systematic search directly from the SyRF UI, replacing the manual email-the-team workflow (epic #2223, SOP discussion #1930).
How it works (user view)¶
- On the Systematic Searches page, choose Bulk upload PDFs for a search (requires the
BulkPdfUploadpermission; feature-flagged viabulkPdfUpload). - Drag in (or pick) a folder containing only PDFs. The app validates the contents and shows a preview: which files match which studies (by relative path), which files have no matching study, and which studies still lack a PDF.
- Confirm. The app zips the folder in the browser and uploads it directly to S3 with a progress bar.
- The pipeline scans every file for viruses, validates it is a real PDF, and copies it to the PDF web server. Live status streams into the UI.
- On completion: a result summary (copied / skipped / replaced / unmatched / missing / invalid counts — or Infected, in which case nothing is delivered) and a downloadable CSV report with one row per file.
A study's Open PDF link activates only once its file is verifiably in place — zero broken links.
Documents¶
- Design: 2026-08-11-bulk-pdf-upload-v2-design.md
- Implementation plan: 2026-08-11-bulk-pdf-upload-v2-plan.md
- Decision record: ADR-012
Prior attempt PR #2373 is superseded by these documents.