← All stories

BRANCH · ef-034-canvas-countdown

Countdown block

EF-034Persona: OrganizerRoots in: event-setupMatrix: PartialEF reference: EventFarm doc

The organizer adds a countdown block to the event site. Public countdown runtime exists, but organizer block controls and EventFarm-style settings still need parity probes.

Preconditions

The organizer is authenticated in the event-setup trunk, has edit access to a fixture event, and the event has a Canvas draft page with at least one root block.

Happy path

  1. Open the Canvas editor from Event Setup.

    The editor loads the draft page, root block sequence, autosave state, and preview pane.

  2. Compose, preview, and publish.

    The organizer edits the capability surface for Countdown block, previews desktop and mobile, then confirms publish or schedule.

  3. Verify public version semantics.

    Publish creates a versioned snapshot; scheduled publish leaves the prior public version intact until its activation time.

Failure modes

Every Canvas branch includes the cluster E rubric: undo/redo, paste-from-other-page, asset isolation, missing-token fallback, preview parity, scheduled publish, autosave recovery, and two-editor conflict. Capability-specific probes bring each story to 10-12 failure modes.

Capability-specific gap probe

Trigger: matrix=Partial.

The visible parity panel lists the incomplete Countdown block contract so the probe fails loudly until parity closes.

Undo/redo correctness across block ops

Trigger: the organizer inserts a block, deletes another, reorders the root block sequence, and edits one block property before using undo twice.

Resolution: each block operation creates exactly one undo entry; multi-step undo restores the prior root block sequence and block props exactly, then redo reapplies the same sequence without duplicating blocks.

Paste from other page

Trigger: the organizer copies a block from page A and pastes into page B, then tries the same paste from a different event.

Resolution: page-local references are remapped to the destination slug and asset URLs; cross-event paste opens an explicit confirmation before any draft mutation happens.

Asset upload failure isolated

Trigger: three assets upload while one fails with a transient R2 or connector error.

Resolution: the two successful uploads continue and bind to their blocks; the failed asset renders inline with retry and the page draft JSON remains valid.

Dynamic token rendering missing data

Trigger: preview resolves {guest.firstName} for a contact with no first name and {event.location} before location is configured.

Resolution: missing values fall back to "Guest" or configured fallback copy; no rendered sentence contains an empty merge or doubled punctuation.

Mobile preview vs published

Trigger: organizer previews at 375x667 and publishes the same draft.

Resolution: the public page matches mobile preview within layout-shift and viewport tolerances; differences surface as preview warnings before publish.

Scheduled publish vs immediate

Trigger: organizer schedules a draft for a future time instead of publishing immediately.

Resolution: before the scheduled time, the public URL serves the previous active version or 404 for first publish; at the scheduled time the new draft becomes live atomically.

Autosave recovery

Trigger: browser refreshes or crashes after an edit but before manual save.

Resolution: latest autosave is offered in a recovery banner with restore/discard; restore is the default and rehydrates the exact block tree.

Two-editor conflict resolution

Trigger: two organizers edit the same page; one publishes while the other saves a stale draft.

Resolution: the second organizer sees a conflict modal listing changed blocks and can merge or accept last-write-with-warning; both sessions converge to a deterministic state.

Countdown honors event timezone and lifecycle states

Trigger: preview crosses event start and end times in the event timezone.

Resolution: countdown ticks once per second, shows "Event in progress" after start, and shows configurable post-event copy after end.

Sub-second precision is not required

Trigger: preview asserts countdown tick cadence.

Resolution: one-second accuracy is acceptable; jitter does not accumulate across minute boundaries.

Capability-specific gap probe: countdown controls incomplete

Trigger: matrix=Partial for EF-034 countdown.

Resolution: visible gap copy lists organizer block controls, timezone controls, in-progress state, and post-event message settings as remaining parity work.

Stable test attributes

Visibility teeth. Each attribute must be effectively visible when active and must match the agent probes.

data-testWherePurpose
canvas-canvas-countdown-editorCanvas editorMain organizer-side Canvas editor surface
canvas-canvas-countdown-stepperCanvas editorCreate/edit/preview/publish lifecycle indicator
canvas-canvas-countdown-block-treeCanvas editorRoot block sequence and selected block tree
canvas-canvas-countdown-previewCanvas editorPreview pane for desktop and mobile layouts
canvas-canvas-countdown-publish-ctaCanvas editorPublish or schedule publish action
canvas-canvas-countdown-publish-confirmationCanvas editorConfirmation dialog for publish or risky action
canvas-canvas-countdown-autosave-bannerCanvas editorAutosave recovery and restore/discard banner
canvas-canvas-countdown-conflict-modalCanvas editorTwo-editor conflict resolution modal
canvas-canvas-countdown-upload-rowCanvas editorPer-asset upload progress/failure row
canvas-canvas-countdown-token-warningCanvas editorDynamic token validation or fallback warning
canvas-canvas-countdown-gap-panelCanvas editorVisible parity gap panel when matrix is absent or partial
canvas-canvas-countdown-mobile-preview-warningCanvas editorPreview discrepancy warning for mobile vs published
canvas-canvas-countdown-countdown-blockCanvas editorCountdown block preview

Agent test plan

Inherits event-setup trunk preconditions. Component contract chaining applies through usesComponents.

- open-canvas-surface
- edit-preview-publish-flow
- published-version-recorded
- undo-redo-block-ops
- paste-cross-page
- asset-upload-isolated
- dynamic-token-fallback
- mobile-preview-published-match
- scheduled-vs-immediate-publish
- autosave-recovery
- two-editor-conflict
- countdown-timezone-state
- countdown-no-subsecond-requirement
- countdown-parity-gap
- evaluate-canvas-editor