Happy path
Sponsor opens their scoped lead station.
The station authenticates to the event namespace and loads sponsor scope, custom fields, and current capture count.
Sponsor scans attendee QR/NFC.
The attendee profile is resolved, sponsor custom fields are collected, and one lead row is written for attendee plus sponsor.
Sponsor exports captured leads.
Export includes only leads for the current sponsor and excludes other sponsor booths.
Failure modes
Socket reconnect resilience
Reconnect replays the current sponsor lead count and pending scan state without duplicating the last capture.
Out-of-order scan messages
Older scan acknowledgements are ignored or resynced by sequence number.
Concurrent sponsor scans
Many sponsor devices can scan at once without dropped acknowledgements or double rows.
Late join shows prior state
A second sponsor device joins and sees previously captured leads for that sponsor.
Organizer pause mid-flow
Organizer pause blocks new lead captures while preserving existing rows.
Export visible only after close
Final sponsor export stays unavailable until the capture window closes.
Idempotent lead capture
Scanning the same attendee twice updates the same sponsor lead, not a duplicate.
Cross-station isolation
Leads from sponsor A never appear in sponsor B counts or exports.
Custom field validation
Required sponsor fields block save inline and preserve scan identity.
Gap probe: sponsor mobile app missing
The visible gap panel remains until sponsor mobile capture is implemented and proven.
Stable test attributes
Visibility teeth. Each attribute must be effectively visible when active and must match the agent probes.
| data-test | Where | Purpose |
|---|---|---|
lead-retrieval-station | station shell | sponsor lead station |
lead-retrieval-socket-status | station shell | socket state |
lead-retrieval-scan-cta | capture form | scan trigger |
lead-retrieval-attendee-card | capture form | resolved attendee |
lead-retrieval-custom-fields | capture form | sponsor fields |
lead-retrieval-save-cta | capture form | save lead |
lead-retrieval-export-cta | export panel | sponsor export |
lead-retrieval-gap-panel | gap panel | mobile app gap |
Agent test plan
- lead-retrieval-opens
- lead-retrieval-captures
- socket-reconnect
- out-of-order-scan
- load-stable
- late-join
- organizer-pause
- export-after-close
- idempotent-capture
- cross-station-isolation
- custom-field-validation
- mobile-app-gap