cf9fea0726
Replace the desktop-first, everything-at-once scanner layout with a phased mobile-optimized experience: Setup → Scanning → Review. Phase 1 (Setup): destination picker, game filter, deck mode toggle, scan history (last 5 sessions). Phase 2 (Scanning): full-screen camera with auto-start, haptic + sound feedback on card detection, torch/flash toggle, count pill, bottom-sheet disambiguation (replaces full-screen modal). Phase 3 (Review): card list with inline condition/foil/qty edits, batch confirm, 30-second undo, deck progress indicator. New features: - Deck mode (progress toward 40/60/99 card target) - Scan history (persisted to localStorage) - Sound feedback (Web Audio oscillator, configurable) - Offline queue (localStorage persistence + auto-retry on reconnect) - Camera flash/torch toggle - Batch ownership API (replaces N+1 per-card fetches) - Visibility pause (detection loop stops when tab is backgrounded) Convoy: scanner-rebuild Co-authored-by: Cursor <cursoragent@cursor.com>
63 lines
2.8 KiB
Markdown
63 lines
2.8 KiB
Markdown
# Convoy: scanner-rebuild
|
|
|
|
**Status:** In Progress (auto-approved — overnight build)
|
|
**Owner:** Agent
|
|
**Created:** 2026-06-13
|
|
|
|
## Goal
|
|
|
|
Rebuild the card scanner from a desktop-first, configuration-heavy, everything-at-once layout into a mobile-first, three-phase flow optimized for rapid multi-card scanning.
|
|
|
|
## Architecture Decisions
|
|
|
|
### D1 — Three-phase flow
|
|
|
|
The scanner page becomes a state machine with three phases:
|
|
- **Setup** — choose destination + game (one-time per session)
|
|
- **Scanning** — full-screen camera with success toasts + count pill
|
|
- **Review** — card list with per-card edits + batch confirm
|
|
|
|
### D2 — Mobile-first camera
|
|
|
|
Camera fills the viewport during scanning phase. No side panels, no scrolling to see results. Success feedback via overlay toasts + haptic vibration.
|
|
|
|
### D3 — Auto-everything during scan
|
|
|
|
- Cards auto-route to chosen destination immediately
|
|
- Condition defaults NM, foil auto-detected from vision response
|
|
- Game auto-detected from vision (no pre-filter needed)
|
|
- Duplicates auto-increment quantity
|
|
|
|
### D4 — Deck Mode
|
|
|
|
Toggle in setup phase. Shows progress toward format-aware deck size (60/99/40). Auto-suggests stop when target reached.
|
|
|
|
### D5 — Disambiguation as bottom sheet
|
|
|
|
Replace full-screen modal with a slide-up bottom sheet. One tap to pick, then immediately resume scanning.
|
|
|
|
### D6 — New features
|
|
|
|
- **Scan history** — last 5 sessions persisted in localStorage
|
|
- **Sound feedback** — subtle blip on successful scan (configurable)
|
|
- **Offline queue** — if network drops, queue identification calls and retry
|
|
- **Camera flash toggle** — torch mode for foil detection in dim lighting
|
|
|
|
## File ownership
|
|
|
|
| Workstream | Files | Agent |
|
|
|---|---|---|
|
|
| Core orchestrator | `pages/scanner.js`, `lib/use-scanner-session.js` | A |
|
|
| Camera phase | `components/scanner/ScannerCamera.js`, `ScannerToast.js`, `ScannerCountPill.js`, `lib/use-camera-scanner.js`, `lib/use-scanner-sound.js`, `lib/use-scanner-flash.js` | B |
|
|
| Setup + Review | `components/scanner/ScannerSetup.js`, `ScannerReview.js`, `ScannerDisambiguation.js`, `DeckModeIndicator.js` | C |
|
|
| Queue + API | `lib/use-scanner-queue.js`, `lib/use-scanner-offline.js`, `pages/api/cards/batch-ownership.js` | D |
|
|
|
|
## Risks
|
|
|
|
- R1: Parallel agents may produce interface mismatches → mitigated by specifying contracts in each agent's prompt
|
|
- R2: Existing hooks (`use-scanner-identification.js`, `scanner-card-identify.js`, `scanner-card-detection.js`) are not being rewritten — the rebuild layers on top of them
|
|
- R3: Visual regression risk — existing smoke tests may break → handled in integration pass
|
|
|
|
## Human gates bypassed
|
|
|
|
Per user instruction (overnight build, 2026-06-13), all architect/reviewer gates are bypassed for this convoy. The user will review the final output in the morning.
|