## ADDED Requirements

### Requirement: Preview image travels with the card design (P1)

A card design MAY carry one designated preview image alongside its companion files. That
image SHALL be uploaded in the same request as the design it belongs to, SHALL be identified
by its role rather than by its filename, and SHALL be versioned, published and rolled back
with that design. Publishing a version SHALL make its preview image the one every link for
that event previews with.

Uploading a design without a preview image SHALL remain a valid upload.

#### Scenario: Published together

- **WHEN** an admin publishes version 3 of an event's card design, and version 3 was uploaded with a preview image
- **THEN** links for that event immediately preview with version 3's image

#### Scenario: Rollback restores the previous image

- **WHEN** an admin republishes version 2 after version 3 was live
- **THEN** links for that event preview with version 2's image again

#### Scenario: Filename cannot claim the role

- **WHEN** a design is uploaded whose companion files include one named `og.png`, and no image is supplied in the preview-image field
- **THEN** that file is stored as an ordinary companion asset
- **AND** the design has no preview image

#### Scenario: Design without a preview image

- **WHEN** an admin uploads and publishes a card design supplying no preview image
- **THEN** the upload and the publish both succeed
- **AND** the event's links preview without a picture

#### Scenario: Preview image is not a card reference

- **WHEN** a card document does not reference the uploaded preview image
- **THEN** the upload is not refused for an unreferenced asset

### Requirement: Preview image counts against the design budget (P2)

The preview image SHALL count toward the total size budget enforced for one card design, and
the refusal message SHALL account for it, so the budget continues to describe everything the
event actually stores.

#### Scenario: Budget refusal includes the preview image

- **WHEN** a design's document, companion files and preview image together exceed the per-design budget
- **THEN** the upload is refused with a total that includes the preview image

### Requirement: Preview image upload is audited (P2)

Uploading or publishing a design SHALL record in the audit log whether that version carried a
preview image, so a later question about why an event's links stopped showing a picture can
be answered from the log.

#### Scenario: Audit records presence

- **WHEN** an admin uploads a card design with a preview image
- **THEN** the audit entry for that upload records that a preview image was included