Requirements: Phase 1 — Bug Fixes

REQ-P1-001: Card notes field mapping

When printing Kanban Cards, the Documint notes field shall contain KanbanCard.notes. When KanbanCard.notes is null or empty, the field shall be an empty string. Notes from other sources (Item.cardNotesDefault, Item.notes) shall not be used as fallback values for the card print notes field.

Traces to: SAC::PRINT::FR-0014, SAC::PRINT::FR-0016, #815, #816

When printing Labels or Breadcrumbs, the Documint notes field shall contain Item.notes. Verify that the current implementation (ItemPrinter.kt) correctly maps this field and that no other notes source leaks into the printed output.

Traces to: SAC::PRINT::FR-0015, #815

REQ-P1-003: Unmark card as printed — backend

The system shall accept a new print event type (UNMARK) that transitions a Kanban Card’s print status from PRINTED to NOT_PRINTED. The event shall be recorded with timestamp and author, consistent with all other print status transitions.

Traces to: SAC::PRINT::FR-0012, SAC::PRINT::FR-0013, #595

REQ-P1-004: Unmark card as printed — API endpoint

A REST endpoint shall be exposed to trigger the UNMARK event for a specific Kanban Card by its Entity ID. The endpoint shall follow the existing print lifecycle endpoint patterns (authenticated, tenant-scoped, accepts effectiveAsOf).

Traces to: SAC::PRINT::FR-0012, SAC::PRINT::0003::0002

REQ-P1-005: Unmark card as printed — frontend

The frontend shall expose a user action to unmark a card as printed. The action shall be available for cards in PRINTED status. After unmarking, the card’s print status displays as NOT_PRINTED and the print button label reverts to “Print card”.

Traces to: SAC::PRINT::0003::0002, #595

REQ-P1-006: Existing print behavior preserved

All existing print workflows (single-item and same-size bulk printing of cards, labels, and breadcrumbs) shall continue to work without regression. The single-URL response shape for same-template batches shall be preserved.

REQ-P1-007: Design documentation updates

The following design documents shall be updated to reflect the bug fixes:

Item Module — payload mapping section
Kanban Cards Module — print status state machine, unmark event