WI-033 · Next Build Slices · label-batches

Label batch workflow and QR print/pack model

queued P0 medium risk   Owner: TBD   0% · 0/1 tasks complete

Gates: C2 Requirements: REQ-OPS-002 Updated: 2026-06-22

At a glance

CodeWI-033
PhaseOperational Floor POC
Order63 of 93
Story points5
Primary surfaceapps/web + supabase
Retires
Depends onRooms / zones / pickup areas in data model and UI
Blocks
Evidence
CC-Analysis QR tracking docs

Goals

Label batch workflow and QR print/pack model — advances C2 toward its gate(s).

Implementation — what to build

Data model

  • label_batches: id, estate_sale_id, stock_format, status enum('draft','printed'), created_at, created_by.
  • label_batch_items: batch_id, item_id, code, printed bool, skipped bool.
  • Reuse qr_codes / item_identity_bindings (Sprint 1 / B4) for the opaque code + binding state.

Domain (src/lib/troveLabels.ts)

  • buildBatch(itemIds | zoneId); assignOrGenerateCodes(batch); markPrinted; reprint; skip.
  • bindOnPrint(): bind each code to its item via item_identity_bindings (opaque public code).

UI (apps/web)

  • Batch builder: select items or pick a zone -> choose stock/format -> preview label grid.
  • Printable view (PDF/print HTML); mark-printed, reprint, and skip controls.
  • 'Unlabelled high-value items' list to catch gaps.

Sticker packs

  • Preprinted pack codes import + bind through the SAME item_identity_bindings model — no separate path.

Acceptance

  • Generate/preview/print a batch; reprints + skipped labels work; codes bind to items; unlabelled-high-value list renders.

Checklist

  • C2 Label batch workflow is first-class and QR print/pack path is demoable.

Gates & testing

  • C2 Label batch workflow is first-class and QR print/pack path is demoable.
    CODE TEST

Requirements

Verify (done when)

labels generate, batch, and bind to QR codes.

Cost triggers

No paid API / infra spend triggered by this item.

Status & editing

queued   Sprint: Sprint 2 - Operational Floor POC

Edit status / sprint on the ★ Live Board → — changes are logged live with who / when / why.

Human-in-the-loop

No human tasks linked.

Findings

None recorded yet.

Concerns

None recorded yet.

Risks

None recorded yet.

Tech debt

None recorded yet.

Tools used

No tool calls recorded.

Files & artifacts

No files / artifacts recorded.

Update log

No log entries yet.