music_library/backlog/completed/ml-143 - Cart-style-multi-record-import-in-Add-Record-modal.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, documentation, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	references	documentation	priority	ordinal
ML-143	Cart-style multi-record import in Add Record modal	Done		2026-04-20 10:00	2026-04-20 12:34	ui liveview import		backlog/ml-143/plan.md backlog/ml-143/mockups.html	backlog/ml-143/plan.md backlog/ml-143/mockups.html	medium	1000

Description

Replace the one-record-at-a-time import in the Add Record modal with a shopping-cart staging flow. Users build an ephemeral cart of {release_group, format} items from MusicBrainz search results, then import them all at once.

Batch-size behaviour mirrors the existing BarcodeScan split:

• 1 item → sync start_async with a spinner in the "Import 1 record" button; on success the modal closes and navigates to the new record.
• 2+ items → one Oban job per item via a new ImportFromMusicbrainzReleaseGroup worker; modal closes immediately and toasts "Importing N records in the background..."

Layout: mockup B (bottom tray) as baseline, mockup A (search left, cart right) on md: and up, with the import modal widened for the side-by-side view. Empty-cart state is shown in place.

Full technical plan and visual mockups are in the task folder — see References.

Affects both CollectionLive.Index and WishlistLive.Index. Barcode scanner flow and StatsLive single-record import are untouched.

Acceptance Criteria

• #1 From the Collection or Wishlist index, clicking a format in the result dropdown adds a {release_group, format} item to the cart instead of importing immediately
• #2 The cart renders as a collapsible bottom tray on small viewports and as a right-hand panel on md: and up
• #3 The import modal widens on md: and up to fit the side-by-side layout
• #4 Result rows show an 'In cart' chip when the release group is already staged
• #5 Adding the same {release_group_id, format} pair twice is a no-op; the same release group with a different format creates a second cart row
• #6 Empty cart shows a visible placeholder with guidance to add records
• #7 Clicking 'Import 1 record' runs synchronously: button shows a spinner, modal stays open until done, then closes and navigates to the new record with an info toast
• #8 Clicking 'Import N records' (N>=2) enqueues one Oban job per item, toasts 'Importing N records in the background...', and closes the modal
• #9 A synchronous import failure leaves the modal open, preserves the cart, clears the spinner, and surfaces a friendly error toast
• #10 Cart state does not persist across modal close/reopen (ephemeral)
• #11 A new MusicLibrary.Worker.ImportFromMusicbrainzReleaseGroup Oban worker delegates to Records.import_from_musicbrainz_release_group/2 with retry semantics matching the existing ImportFromMusicbrainzRelease worker
• #12 All new user-facing strings are wrapped in gettext and .pot/.po files are regenerated
• #13 LiveView tests cover: add-to-cart, remove, change format, dedup, 1-item sync path (assert navigation + toast, refute_enqueued), N-item async path (assert_enqueued per item)
• #14 New worker test covers happy path and error path
• #15 Obsolete IndexActions.handle_import/3 and handle_event("import", ...) clauses in Collection/Wishlist index LiveViews are removed
• #16 StatsLive.Index import event handler is unchanged