As a user I want to drop or select multiple files on the home page so I can digitize a stack of documents without navigating to a form for each one #66

New Issue

marcel · 2026-03-25T14:11:32+01:00

marcel commented

2026-03-25 14:11:32 +01:00

Background

When digitizing a box of letters, the biggest source of friction is that every document requires navigating to "New Document", filling out a form, and uploading. The goal is to let the user dump all their scans at once and enrich the metadata later.

User Journey

User opens the home page. A clearly visible drop zone (or a "Upload files" button for mobile) is present above or alongside the document list. The user drags one or more PDF/image files onto the zone — or taps the zone on mobile to open the file picker. For each file, the system immediately creates a document with:

title = filename (without extension)
status = UPLOADED
all other fields empty

A brief success toast shows how many documents were created. The newly created documents appear at the top of the list (or the user is taken to the enrichment queue — see issue #X). No form, no navigation.

If some files fail (wrong type, too large), per-file error messages are shown without blocking the successful ones.

E2E Scenarios

Scenario: Drop a single PDF on the home page
  Given I am on the home page
  When I drop a PDF file onto the drop zone
  Then a new document is created with the filename as its title
  And the document appears in the list with status UPLOADED
  And a success notification is shown

Scenario: Drop multiple PDFs at once
  Given I am on the home page
  When I drop 3 PDF files onto the drop zone simultaneously
  Then 3 new documents are created, one per file
  And all 3 appear in the document list

Scenario: Select files via button (mobile / no drag support)
  Given I am on the home page
  When I tap the upload button and select 2 files from the file picker
  Then 2 new documents are created

Scenario: Drop an unsupported file type
  Given I am on the home page
  When I drop a .docx file onto the drop zone
  Then no document is created
  And an error message explains the supported formats

Implementation notes

Reuse the existing POST /api/documents + POST /api/documents/{id}/file endpoints, or extend the endpoint to accept a bare multipart file upload that creates and uploads in one request (preferred to reduce round trips).
Drop zone should be unobtrusive when not in use — a thin dashed border or a dedicated "Upload" button, not a giant target that pushes the document list down.
Accepted types: application/pdf + common image types (image/jpeg, image/png, image/tiff).

## Background When digitizing a box of letters, the biggest source of friction is that every document requires navigating to "New Document", filling out a form, and uploading. The goal is to let the user dump all their scans at once and enrich the metadata later. ## User Journey User opens the home page. A clearly visible drop zone (or a "Upload files" button for mobile) is present above or alongside the document list. The user drags one or more PDF/image files onto the zone — or taps the zone on mobile to open the file picker. For each file, the system immediately creates a document with: - `title` = filename (without extension) - `status` = `UPLOADED` - all other fields empty A brief success toast shows how many documents were created. The newly created documents appear at the top of the list (or the user is taken to the enrichment queue — see issue #X). No form, no navigation. If some files fail (wrong type, too large), per-file error messages are shown without blocking the successful ones. ## E2E Scenarios ``` Scenario: Drop a single PDF on the home page Given I am on the home page When I drop a PDF file onto the drop zone Then a new document is created with the filename as its title And the document appears in the list with status UPLOADED And a success notification is shown Scenario: Drop multiple PDFs at once Given I am on the home page When I drop 3 PDF files onto the drop zone simultaneously Then 3 new documents are created, one per file And all 3 appear in the document list Scenario: Select files via button (mobile / no drag support) Given I am on the home page When I tap the upload button and select 2 files from the file picker Then 2 new documents are created Scenario: Drop an unsupported file type Given I am on the home page When I drop a .docx file onto the drop zone Then no document is created And an error message explains the supported formats ``` ## Implementation notes - Reuse the existing `POST /api/documents` + `POST /api/documents/{id}/file` endpoints, or extend the endpoint to accept a bare multipart file upload that creates and uploads in one request (preferred to reduce round trips). - Drop zone should be unobtrusive when not in use — a thin dashed border or a dedicated "Upload" button, not a giant target that pushes the document list down. - Accepted types: `application/pdf` + common image types (`image/jpeg`, `image/png`, `image/tiff`).

marcel commented

2026-03-25 14:12:23 +01:00

Related: #67 (enrichment queue — natural next step after bulk upload), #68 (progressive form — fallback for manual entry), #69 (filename parsing — enhances bulk upload with auto-suggestions)